Skip to content

Add point scene layer

View on GitHub

View a point scene layer from a scene service.

Image of a point scene layer

Use case

Point scene layers can efficiently display large amounts of point features. While point cloud layers can only display simple symbols, point scene layers can display any type of billboard symbol or even 3D models, as long as the location of the symbol can be described by a point. Points are cached and automatically thinned when zoomed out to improve performance.

How to use the sample

Pan around the scene and zoom in. Notice how many thousands of additional features appear at each successive zoom scale.

How it works

  1. Create a scene.
  2. Create an ArcGISSceneLayer with the URL to a point scene layer service.
  3. Add the layer to the scene's operational layers collection.

Relevant API

  • ArcGISSceneLayer

About the data

This dataset contains more than 40,000 points representing world airports. Points are retrieved on demand by the scene layer as the user navigates the scene.

Additional information

Point scene layers can also be retrieved from scene layer packages (.slpk) and mobile scene packages (.mspk).

Tags

3D, layers, point scene layer

Sample Code

add_point_scene_layer.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
// 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 AddPointSceneLayer extends StatefulWidget {
  const AddPointSceneLayer({super.key});

  @override
  State<AddPointSceneLayer> createState() => _AddPointSceneLayerState();
}

class _AddPointSceneLayerState extends State<AddPointSceneLayer>
    with SampleStateSupport {
  // Create a controller for the scene view.
  final _sceneViewController = ArcGISSceneView.createController();
  // A flag for when the scene view is ready and controls can be used.
  var _ready = false;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Stack(
        children: [
          Column(
            children: [
              Expanded(
                // Add a scene view to the widget tree and set a controller.
                child: ArcGISSceneView(
                  controllerProvider: () => _sceneViewController,
                  onSceneViewReady: onSceneViewReady,
                ),
              ),
            ],
          ),
          // Display a progress indicator and prevent interaction until state is ready.
          LoadingIndicator(visible: !_ready),
        ],
      ),
    );
  }

  // Called when the scene view is ready to be used.
  void onSceneViewReady() {
    // Create a scene with the imagery basemap style.
    final scene = ArcGISScene.withBasemapStyle(BasemapStyle.arcGISImagery);
    // Set the scene to the scene view controller.
    _sceneViewController.arcGISScene = scene;

    // Create a point scene layer with a URL to the airport point service.
    final pointSceneLayer = ArcGISSceneLayer.withUri(
      Uri.parse(
        'https://tiles.arcgis.com/tiles/V6ZHFr6zdgNZuVG0/arcgis/rest/services/Airports_PointSceneLayer/SceneServer/layers/0',
      ),
    );
    // Add the point scene layer to the scene.
    scene.operationalLayers.add(pointSceneLayer);
    // Add surface elevation to the scene.
    final elevationSource = ArcGISTiledElevationSource.withUri(
      Uri.parse(
        'https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer',
      ),
    );
    scene.baseSurface.elevationSources.add(elevationSource);
    // Disable the loading indicator when the layer is loaded.
    pointSceneLayer.load().then((_) {
      setState(() => _ready = true);
    });
  }
}

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