Skip to content
View on GitHub

Display a local scene with a topographic surface and 3D scene layer clipped to a local area.

Image of display local scene

Use case

An ArcGISLocalSceneView is a user interface that displays 3D basemaps and layer content described in an ArcGISScene with a local SceneViewingMode.

Unlike a global scene which is drawn on a globe using a geographic coordinate system, a local scene is drawn on a flat surface and supports projected coordinate systems. They are generally used to view local data and are often clipped to a specific area of interest. Currently, ArcGISLocalSceneView cannot display data provided by a global scene and ArcGISSceneView cannot display data provided by a local scene.

The ArcGISLocalSceneView displays the clipped area of the local scene, supports user interactions such as pan and zoom, and provides access to the underlying scene data.

How to use the sample

This sample displays a local scene clipped to an extent. Pan and zoom to explore the scene.

How it works

  1. Create a local scene object with the ArcGISScene.withBasemapStyle(BasemapStyle.arcGISTopographic, viewingMode: SceneViewingMode.local) constructor.
  2. Create an ArcGISTiledElevationSource object and add it to the local scene's base surface.
  3. Create an ArcGISSceneLayer and add it to the local scene's operational layers.
  4. Create an Envelope and set it to the scene.clippingArea, then enable clipping by setting scene.isClippingEnabled to true.
  5. Create an ArcGISLocalSceneView object to display the scene.
  6. Set the initial viewpoint for the local scene.
  7. Set the local scene to the local scene view.

Relevant API

  • ArcGISLocalSceneView
  • ArcGISScene
  • ArcGISSceneLayer
  • ArcGISTiledElevationSource

About the data

The scene layer in this sample shows 3D extruded rooftop outlines of buildings on the Victoria University campus and surrounding vicinity in Wellington, New Zealand.

Tags

3D, basemap, elevation, scene, surface

Sample Code

display_local_scene.dart
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
// Copyright 2025 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
//
//   https://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.
//

import 'package:arcgis_maps/arcgis_maps.dart';
import 'package:arcgis_maps_sdk_flutter_samples/common/common.dart';
import 'package:flutter/material.dart';

class DisplayLocalScene extends StatefulWidget {
  const DisplayLocalScene({super.key});

  @override
  State<DisplayLocalScene> createState() => _DisplayLocalSceneState();
}

class _DisplayLocalSceneState extends State<DisplayLocalScene>
    with SampleStateSupport {
  // Create a controller for the local scene view.
  final _localSceneViewController = ArcGISLocalSceneView.createController();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      // Add a local scene view to the widget tree and set a controller.
      body: ArcGISLocalSceneView(
        controllerProvider: () => _localSceneViewController,
        onLocalSceneViewReady: onLocalSceneViewReady,
      ),
    );
  }

  Future<void> onLocalSceneViewReady() async {
    // Create a scene with a topographic basemap and a local scene viewing mode.
    final scene = ArcGISScene.withViewingModeAndBasemapStyle(
      viewingMode: SceneViewingMode.local,
      basemapStyle: BasemapStyle.arcGISTopographic,
    );

    // Create the 3d scene layer.
    final sceneLayer = ArcGISSceneLayer.withUri(
      Uri.parse(
        'https://www.arcgis.com/home/item.html?id=7a63e9808a054d39964a8b4712c85657',
      ),
    );

    // Add world elevation source to the scene's surface.
    final elevationSource = ArcGISTiledElevationSource.withUri(
      Uri.parse(
        'https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer',
      ),
    );
    scene.baseSurface.elevationSources.add(elevationSource);

    // Add the scene layer to the scene's operational layers.
    scene.operationalLayers.add(sceneLayer);

    // Set the clipping area for the local scene.
    scene.clippingArea = Envelope.fromXY(
      xMin: 19454578.8235,
      yMin: -5055381.4798,
      xMax: 19455518.8814,
      yMax: -5054888.4150,
      spatialReference: SpatialReference.webMercator,
    );

    // Enable the clipping area so only the scene elements within the clipping
    // area are rendered.
    scene.isClippingEnabled = true;

    // Set the scene's initial viewpoint.
    final camera = Camera.withLocation(
      location: ArcGISPoint(
        x: 19455578.6821,
        y: -5056336.2227,
        z: 1699.3366,
        spatialReference: SpatialReference.webMercator,
      ),
      heading: 338.7410,
      pitch: 40.3763,
      roll: 0,
    );
    scene.initialViewpoint = Viewpoint.withPointScaleCamera(
      center: ArcGISPoint(
        x: 19455026.8116,
        y: -5054995.7415,
        spatialReference: SpatialReference.webMercator,
      ),
      scale: 8314.6991,
      camera: camera,
    );

    // Apply the scene to the local scene view controller.
    _localSceneViewController.arcGISScene = scene;
  }
}

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