Navigate a scene view

You can navigate a scene view (a 3D map):

Built-in navigation

The scene view has a number of built-in gestures that allow you to navigate a scene (3D) using touch screen, mouse, or keyboard.

Basic navigation

Basic navigation for scene views is the same as navigation for map views:

NavigationUser Action
Zoom inTwo finger pinch open
Single finger double-tap
Zoom outTwo finger pinch close
Two finger single-tap
Continuous zoom in / out                                         Single finger double-tap, ending in a vertical up/down drag                                         
Move/PanSingle finger drag or flick
Rotate the sceneTwo finger rotate

Advanced navigation

Scene views have additional navigation not found in map views:

NavigationUser Action
Tilt the scene                                                             Three finger drag                                                                                                                      

Programmatically change camera position

Your applications can programmatically navigate a 3D scene by creating a new camera and setting it to the scene view. A camera defines the location from which you are viewing the scene.

Camera position for a scene view

The camera is shown in this image for illustration purposes; when you set camera settings (location, pitch), think of the camera class a real-life camera you're adjusting the position of.

Set the camera

For example, to point the camera to toward the Snowdon mountainside, as shown in the following code snippet and image, use these values:

  • For 3D location, use 53.06 latitude, -4.04 longitude, 1289 meters above sea level
  • For heading, use 295 degrees
  • For pitch, use 71 degrees
  • For roll, use 0 degrees
    
1
2
3
4

let snowdonCamera = AGSCamera(latitude: 53.06, longitude: -4.04, altitude: 1289, heading: 295, pitch: 71, roll: 0)

self.sceneView.setViewpointCamera(snowdonCamera)

Surface elevation applied to a scene

Now you have a new camera you can apply to your scene view. You can apply it immediately using setViewpointCamera as shown in the code below, or the camera can be animated to the new position using one of the asynchronous methods.

    
1
2
3
4

let snowdonCamera = AGSCamera(latitude: 53.06, longitude: -4.04, altitude: 1289, heading: 295, pitch: 71, roll: 0)

self.sceneView.setViewpointCamera(snowdonCamera)

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.