Add scene layer with elevation

View on GitHub

Sample viewer app

Add a scene layer to a scene.

Image of scene layer

Use case

Each scene layer added to a scene can assist in performing helpful visual analysis. For example, if presenting the results of a shadow analysis of a major metropolitan downtown area in 3D, adding a scene layer of 3D buildings to the scene that could be toggled on/off would help to better contextualize the source of the shadows.

How to use the sample

Run the sample to display a scene service with an ArcGISSceneLayer. Pan and zoom to explore the scene.

How it works

Create an ArcGISScene having a BasemapStyle.ArcGISTopographic.
Create a SceneView and set the scene to the view.
Create an ArcGISSceneLayer using a data source URI: ArcGISSceneLayer(Uri).
Add the new scene layer to the scene as an operational layer with scene.operationalLayers.add(sceneLayer).

Relevant API

ArcGISScene
ArcGISSceneLayer
SceneView

About the data

The scene launches with a northward view of the city of Brest, France (SceneServer). A 3D scene layer representing buildings (some textured) is used as an example.

Additional information

This sample uses the GeoView-Compose Toolkit module to be able to implement a composable SceneView.

Sample Code

SceneViewModel.kt

MainActivity.kt

MainScreen.kt

Use dark colors for code blocksCopy
/* Copyright 2023 Esri
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 */

package com.esri.arcgismaps.sample.addscenelayerwithelevation.components

import android.app.Application
import androidx.lifecycle.AndroidViewModel
import com.arcgismaps.geometry.Point
import com.arcgismaps.mapping.ArcGISScene
import com.arcgismaps.mapping.BasemapStyle
import com.arcgismaps.mapping.Viewpoint
import com.arcgismaps.mapping.layers.ArcGISSceneLayer
import com.arcgismaps.mapping.view.Camera
import com.esri.arcgismaps.sample.addscenelayerwithelevation.R

class SceneViewModel(application: Application) : AndroidViewModel(application) {

    private val initLocation = Point(
        x = 48.378,
        y = -4.494
    )

    // create a camera position for the scene
    private val camera: Camera = Camera(
        latitude = 48.378,
        longitude = -4.494,
        altitude = 200.0,
        heading = 345.0,
        pitch = 65.0,
        roll = 0.0
    )
    // the scene used to display on the SceneView
    val scene: ArcGISScene = ArcGISScene(BasemapStyle.ArcGISTopographic).apply {
        initialViewpoint = Viewpoint(initLocation,camera)
    }

    // add a scene layer to the ArcGISScene
    init {
        // create a scene layer from a scene service for viewing buildings
        val sceneLayer =  ArcGISSceneLayer(application.getString(R.string.brest_buildings))
        // add the scene layer to the scene's operational layer
        scene.operationalLayers.add(sceneLayer)
    }
}