Viewpoint

Defines the visible area of a GeoModel that is displayed in a GeoView on a user's screen. In a MapView, the bounding extent of a geometry or the map's center point and scale can define the map view's two-dimensional Viewpoint.

In a SceneView, a Camera represents the observer's position and perspective within three dimensions and defines the scene view's three-dimensional Viewpoint. Each camera has the following properties:

• Geographic location on the surface (longitude and latitude).

• Altitude (height, in meters, above sea level).

• Heading (angle about the z axis the camera is rotated, in degrees)

• Pitch (angle the camera is rotated up or down, in degrees)

• Roll (angle the camera is rotated side-to-side, in degrees)

When you publish or save a map or scene, as a web map, web scene, mobile map package, or mobile scene package, you define its initial Viewpoint. When you load a map or scene into your app, you can access and change the value of this GeoModel.initialViewpoint. If you add the map or scene to a GeoView, any change you make to the GeoModel.initialViewpoint is ignored. To change the Viewpoint of a displayed map or scene, use view methods such as:

• GeoView.setViewpoint(Viewpoint) to instantly change the visible area with no animation.

• MapView.setViewpoint(Viewpoint, Float, AnimationCurve) to animates the display of the map to a viewpoint using the provided animation curve.

• SceneView.setViewpointCamera(Camera) to instantly moving the perspective in 3D scenes.

To determine the current visible area, call GeoView.getCurrentViewpoint(ViewpointType). Make sure that any user-initiated or programmatic navigation is complete before getting the current Viewpoint by calling GeoView.isNavigating.