Viewpoint class final

Defines the visible area of a GeoModel that is displayed in a GeoViewController on a user's screen.

In an ArcGISMapViewController, 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 GeoViewController, 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:

• GeoViewController.setViewpoint to instantly change the visible area with no animation.
• ArcGISMapViewController.setViewpointWithDurationAndCurve 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 GeoViewController.getCurrentViewpoint. Make sure that any user-initiated or programmatic navigation is complete before getting the current Viewpoint by calling GeoViewController.isNavigating.