A global scene
You can use a global sceneSceneView to:
- Display a basemap layer
A basemap layer is the layer in a map or scene that displays basemap data. The data source for a basemap layer is typically a basemap service. such as streets or satellite imagery. - Access and display data layers
A data layer is a layer that references geographic data from a file or a service and is used to visualize the data in a map or scene. based on files or services, including data you have authored. - Display terrain with an elevation layer
An elevation layer is a layer that defines the ground height or the surface for a scene. . - Display real-world objects such as buildings, cars, and trees.
- Display 3D visualizations of 2D objects.
- Perform 3D analysis, such as line-of-sight, visibility, and 3D measurements.
- Provide context for temporary points, lines, polygons, or text displayed as graphics
A graphic is a visual element composed of a geometry, symbol, and attributes that is displayed on a map or scene. . - Measure distance and explore spatial relationships between geometries
A geometry is a geometric shape, such as a point, polyline, or polygon, that contains one or more coordinates and a spatial reference. . - Inspect data layers and display information from attributes
Attributes are fields and values for a single feature or non-spatial record. They are typically stored in a database or service such as a feature service. .
Scene
The introduction explained the concept of a sceneArcGISScene is your entry point into the API when working with three dimensional data. However, when working with global scenes you connect them with SceneView in order to display the data within an application. Remember that when you are working with global scenes, the SceneViewingMode is set to global. When creating a scene programmatically, the viewing mode needs to be set. If consuming a global web scene itemSceneViewingMode is set to local, consult the local scene overview topic for details as it is different from working with a global scene. Logically, when programmatically building a global scene, the next step is to add data layers
Layer
Each layer
Scenes can also contain scene layers
The Layer class is the base class for all types of layers used in ArcGIS Maps SDK for Kotlin. The type of layer you create depends on the type of data you want to display. For example, to display feature data you can create a FeatureLayer that references an online service (such as a feature serviceArcGISVectorTiledLayer and AnnotationLayer. Similarly, 3D layers cannot be displayed in ArcGISMap, such as ArcGISSceneLayer.
ArcGISEnvironment.apiKey = ApiKey.create(YOUR_ACCESS_TOKEN)
scene = ArcGISScene(BasemapStyle.ArcGISTopographic)
val trailheadsLayer = FeatureLayer.createWithFeatureTable( ServiceFeatureTable("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads_Styled/FeatureServer/0") )
val trailsLayer = FeatureLayer.createWithFeatureTable( ServiceFeatureTable("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails_Styled/FeatureServer/0") )
val openSpacesLayer = FeatureLayer.createWithFeatureTable( ServiceFeatureTable("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Parks_and_Open_Space_Styled/FeatureServer/0") )
scene.operationalLayers.addAll(listOf(openSpacesLayer, trailsLayer, trailheadsLayer))Camera
Global scenes and global scene views extend the concept of two dimensional viewpoints with a camera
The following properties define the camera position:
- 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)
val cameraLocation = Point( x = 13.409444, y = 52.520833, z = 1000.0, spatialReference = SpatialReference.wgs84() )
val sceneCamera = Camera( locationPoint = cameraLocation, heading = 180.0, pitch = 0.0, roll = 0.0 )
sceneViewProxy.setViewpointCamera(sceneCamera)
// Alternative: When creating the ArcGISScene instance, you can set the ArcGISScene.initialViewpoint property.SceneView has an associated controller that manages the camera
When a camera controller other than the default GlobeCameraController is active, the scene view’s viewpoint cannot be assigned. Attempts to do so do not raise an exception, but they are ignored.
The following camera controllers are available:
GlobeCameraController(default)—Provides the default scene view camera behavior. Allows the user to freely move and focus the camera anywhere in the scene.OrbitGeoElementCameraController—Locks the scene view’s camera to maintain focus relative to a (possibly moving) graphic. The camera can only move relative to the target graphic.OrbitLocationCameraController—Locks the scene view’s camera to orbit a fixed location (map point). The camera can only move relative to the target map point.TransformationMatrixCameraController—Provides navigation by using aTransformationMatrixto control the camera’s location and rotation. You need to pass this object to allTransformationMatrixCameraControllerfunctions. This can be used with transformation matrices produced by Augmented Reality APIs like ARKit (iOS) and ARCore (Android).
val sceneViewProxy = remember { SceneViewProxy() }
// Create a camera controller to orbit a stationary geoelement in the scene view. // Pass geoelement (graphic) and distance (meters). Geoelement here is green diamond at Berlin TV Tower. cameraController = OrbitGeoElementCameraController( targetGeoElement = berlinTvTowerGraphic, distance = 500.0 ).apply { setCameraPitchOffset(75.0) }
SceneView( // Pass the scene to the Composable SceneView. arcGISScene = scene, cameraController = cameraController, graphicsOverlays = graphicsOverlays, sceneViewProxy = sceneViewProxy,
)SceneView
A scene view
After creating a scene view, you typically set the scene
Add a ArcGISScene to a SceneView to display it. Changes you make to the scene, such as adding, removing, or reordering layers, will immediately be reflected in the display. The ArcGISScene.initialViewpoint will determine the area shown when the scene loads.
scene.initialViewpoint = Viewpoint(point, camera)
// The Compose equivalent of the view-based SceneView class. SceneView( modifier = Modifier.fillMaxSize(), // Pass the scene to the Composable SceneView. arcGISScene = scene )A SceneView also allows you to:
- Adjust light, atmosphere, and space effects.
- Display image overlays on the scene surface.
- Lock the camera to a location or geoelement
A geoelement refers to any geographic element in a map or map view that can be identified by its location to return attribute information. . - Add analysis overlays to visualize analysis results.
- Identify and select features using a tapped location.
- Export an image of the current display.
- Apply a time extent to filter the display of features.
View error
The SceneView supports an error that helps to capture different situations and provides useful messages to help troubleshoot related problems that may arise. Ultimately, you decide what you want to do with the error. For example, you may decide to enter the information into a log for further examination as users report problems with your application.
GeoModel error
When working with SceneView there are situations that arise when the view is in a usable state, but nothing is displayed because the GeoModel is not configured correctly.
Examples
Display a global scene with elevation
This example uses an ArcGISScene and SceneView to display the topographic basemap layerCamera is created to define the initial view of the scene.
Steps
- Create an
ArcGISSceneand add a basemap layerA basemap layer is the layer in a map or scene that displays basemap data. The data source for a basemap layer is typically a basemap service. . - Use an elevation service with
ArcGISScene.baseSurfaceto define a base surface. - Create a
SceneViewand set the cameraA camera defines the rendering viewpoint of a 3D scene in a scene view. position.
31 collapsed lines
package com.example.guide.scenes3d.displayascenewithelevation.example
import android.os.Bundleimport androidx.activity.compose.setContentimport androidx.appcompat.app.AppCompatActivityimport androidx.compose.foundation.layout.fillMaxSizeimport androidx.compose.ui.Modifierimport com.arcgismaps.ApiKeyimport com.arcgismaps.ArcGISEnvironmentimport com.arcgismaps.geometry.Pointimport com.arcgismaps.geometry.SpatialReferenceimport com.arcgismaps.mapping.ArcGISSceneimport com.arcgismaps.mapping.ArcGISTiledElevationSourceimport com.arcgismaps.mapping.BasemapStyleimport com.arcgismaps.mapping.Surfaceimport com.arcgismaps.mapping.Viewpointimport com.arcgismaps.mapping.view.Cameraimport com.arcgismaps.toolkit.geoviewcompose.SceneViewimport com.esri.arcgismaps.sample.sampleslib.theme.SampleAppThemeimport com.example.guide.scenes3d.displayascenewithelevation.example.BuildConfig.YOUR_ACCESS_TOKEN
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState)
// API key authentication or user authentication is required to access basemaps and other location services. ArcGISEnvironment.apiKey = ApiKey.create(YOUR_ACCESS_TOKEN) setContent { SampleAppTheme {
// Create a map with an ArcGIS basemap style. val scene = ArcGISScene(BasemapStyle.ArcGISTopographic)
val elevationSource = ArcGISTiledElevationSource("https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer") val surface = Surface().apply { elevationSources.add(elevationSource) }
val point = Point( x = -118.808, y = 33.961, z = 2000.0, spatialReference = SpatialReference.wgs84() ) val camera = Camera( locationPoint = point, heading = 0.0, pitch = 75.0, roll = 0.0 ) scene.apply { baseSurface = surface initialViewpoint = Viewpoint(point, camera) }
SceneView( modifier = Modifier.fillMaxSize(), // Pass the map to the Composable SceneView. arcGISScene = scene )5 collapsed lines
} } }}Display a scene from a mobile scene package
This example displays a global scene
Steps
- Create a
MobileScenePackageusing the path to a local .mspk file. - Call
MobileScenePackage.load()to load the package. - When the package loads, get the first scene from the package using
MobileScenePackage.scenes. - Display the global scene in a
SceneView.
59 collapsed lines
package com.example.guide.scenes3d.displayascenewithamobilescenepackage.example
import android.os.Bundleimport android.util.Logimport androidx.activity.compose.setContentimport androidx.appcompat.app.AppCompatActivityimport androidx.compose.foundation.layout.fillMaxSizeimport androidx.compose.runtime.getValueimport androidx.compose.runtime.mutableStateOfimport androidx.compose.runtime.setValueimport androidx.compose.ui.Modifierimport androidx.lifecycle.lifecycleScopeimport com.arcgismaps.ApiKeyimport com.arcgismaps.ArcGISEnvironmentimport com.arcgismaps.mapping.ArcGISSceneimport com.arcgismaps.mapping.BasemapStyleimport com.arcgismaps.mapping.MobileScenePackageimport com.arcgismaps.toolkit.geoviewcompose.SceneViewimport com.esri.arcgismaps.sample.sampleslib.theme.SampleAppThemeimport com.example.guide.scenes3d.displayascenewithamobilescenepackage.example.BuildConfig.YOUR_ACCESS_TOKENimport kotlinx.coroutines.launchimport java.io.File
class MainActivity : AppCompatActivity() {
private val pathToAppStorageDir: String by lazy { getExternalFilesDir(null)?.path.toString() + File.separator + getString(R.string.app_name) }
private val provisionPath: String by lazy { getExternalFilesDir(null)?.path.toString() + File.separator + getString(R.string.app_name) }
private var scene by mutableStateOf(ArcGISScene(BasemapStyle.ArcGISImagery))
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // API key authentication or user authentication is required to access basemaps // and other location services. ArcGISEnvironment.apiKey = ApiKey.create(YOUR_ACCESS_TOKEN)
// Get the file path of the (.mmpk) file. val filePath = provisionPath + File.separator + getString(R.string.philadelphia_mspk)
// Load and add the mobile map package. addMobileScenePackage(filePath)
setContent { SampleAppTheme { // Compose equivalent of the view-based MapView class. SceneView( arcGISScene = scene, modifier = Modifier.fillMaxSize() ) } } }
fun addMobileScenePackage(filePath: String) {
// Create the mobile map package val scenePackage = MobileScenePackage(filePath) lifecycleScope.launch { // Load the mobile map package. scenePackage.load().getOrElse { // Mobile map package failed to load. showError("Map package failed to load: ${it.message.toString()}") } // Add the loaded map from the mobile map package to the mutable ArcGISMap used by the Composable MapView. scene = scenePackage.scenes.first() }8 collapsed lines
}
private fun showError(message: String) { Log.e(this::javaClass.name, message) }
}