Viewpoint

Defines the visible area of a GeoModel that is displayed in a com.arcgismaps.mapping.view.GeoView on a user's screen. In a com.arcgismaps.mapping.view.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 com.arcgismaps.mapping.view.SceneView, a com.arcgismaps.mapping.view.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 com.arcgismaps.mapping.view.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:

• com.arcgismaps.mapping.view.GeoView.setViewpoint to instantly change the visible area with no animation.

• com.arcgismaps.mapping.view.MapView.setViewpoint to animates the display of the map to a viewpoint using the provided animation curve.

• com.arcgismaps.mapping.view.SceneView.setViewpointCamera to instantly moving the perspective in 3D scenes.

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