Data | CesiumJS | Esri Developer

Hosted data servicesData services, also known as hosted data services, are services created dynamically to store and provide access to your data in ArcGIS. Examples are feature services, vector tile services, map tile services, image services, and scene services.Learn more provide a way to store, manage, and access your own geographic data for maps. You can access data services to display features, map tiles, or 3D objects such as buildings. Supported data types include feature data, scene data, and map tile data.

Feature data

A feature serviceA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more allows you to store, access, and manage collections of featuresA feature is a single record, also known as a row, that represents a real-world entity. It typically contains a geometry (point, multipoint, polyline, or polygon) and attributes but it can also contain just attributes.Learn more. Each collection is known as feature layerA feature layer (client-side) is a data layer that can access and display features from a feature service that has the same type of geometry and attribute fields.Learn more. You can access features in a feature layer with a SQL and/or spatial query. Features can be returned in JSON, GeoJSON, PBF, and other formats. To create a feature service, you import data with the ArcGIS portalArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure.Learn more. You also use the portal to set the service capabilities, support for editing, access and security, and cache settings.

Steps

Use ArcGIS portal to import your data and create a feature service and feature layer.
Add the feature layer to a scene with CesiumJS. Use the service URL.
Optionally, use a SQL and/or spatial query to select a subset of features.

Style a feature layer

This example shows how to query and style a feature layer then add it to the scene as a Cesium.GeoJsonDataSource.

Add and style a feature layer.

Expand
Use dark colors for code blocksCopy
    const pointLayerURL = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads/FeatureServer/0";

    arcgisRest.queryFeatures({
      url: pointLayerURL,
      authentication,
      f: "geojson"
    }).then((response) => {
      Cesium.GeoJsonDataSource.load(response, {
        clampToGround: true,

        // Attribution text retrieved from https://arcgis.com/home/item.html?id=883cedb8c9fe4524b64d47666ed234a7
        credit: "Los Angeles GeoHub"

      }).then((dataSource) => {
        dataSource.name = "trailheads";
        viewer.dataSources.add(dataSource);

        const entities = dataSource.entities.values;
        for (let i = 0; i < entities.length; i++) {
          entities[i].billboard.image = "http://static.arcgis.com/images/Symbols/NPS/npsPictograph_0231b.png";
          entities[i].billboard.scale = 0.4;
        }

      });
    });
Expand

Go to tutorial

Tutorials

CesiumJS scene showing point features added from a GeoJSON feature layer.

Add features as GeoJSON

Add features from a feature service to a scene.

CesiumJS scene with color-coded regions and symbols representing trailheads, trails, and open spaces.

Style features

Use data-driven styling to apply symbol colors and styles to features.

CesiumJS scene with a feature pop-up showing attribute fields and a highlighted feature.

Display a pop-up (Feature)

Display feature attributes in a popup.

Map showing a coastal neighborhood highlighted to represent features returned from a SQL query on a feature layer.

Query features (SQL)

Execute a SQL query to access polygon features from a feature service.

Map displaying overlapping highlighted areas to illustrate features selected using a spatial query across multiple regions.

Query features (spatial)

Execute a spatial query to access polygon features from a feature service.

Scene data

A scene serviceA scene service is a data service that provides access to large 3D datasets for scenes.Learn more contains scene data stored in the Indexed 3D Scene Layer (I3S) format, an OGC standard. CesiumJS supports loading two types of scene layers hosted in ArcGIS: 3D object layers and integrated mesh layers.

Steps

Use ArcGIS portal to import your scene layer package and create a scene serviceA scene service is a data service that provides access to large 3D datasets for scenes.Learn more.
Add the scene layer to a scene with CesiumJS. Use the service URL.
Optionally, if your layer has gravity-related heights, add a terrain provider.

Add 3D objects

This example shows how to add a 3D object layer containing textured building models of San Francisco.

Add a 3D object layer to a scene.

Expand
Use dark colors for code blocksCopy
    // The source data used in this transcoding service was compiled from https://earth-info.nga.mil/#tab_wgs84-data and is based on EGM2008 Gravity Model
    const geoidService = await Cesium.ArcGISTiledElevationTerrainProvider.fromUrl("https://tiles.arcgis.com/tiles/GVgbJbqm8hXASVYi/arcgis/rest/services/EGM2008/ImageServer");

    // Attribution text retrieved from https://arcgis.com/home/item.html?id=d798c71512404bbb9c1551b827bf5467
    viewer.creditDisplay.addStaticCredit(new Cesium.Credit("National Geospatial-Intelligence Agency (NGA)", false));

    const i3sLayer = "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/SanFrancisco_Bldgs/SceneServer";

    const i3sProvider = await Cesium.I3SDataProvider.fromUrl(i3sLayer, {
      geoidTiledTerrainProvider: geoidService,
      token: accessToken
    });

    // Attribution text retrieved from https://www.arcgis.com/home/item.html?id=f71313a22abb4431974374a009f2e54b
    viewer.creditDisplay.addStaticCredit(new Cesium.Credit("Copyright (c) 2010-2011 PLW Modelworks, LLC", false));

    viewer.scene.primitives.add(i3sProvider);
Expand

Go to tutorial

Add an integrated mesh

This example shows how to add an integrated mesh containing textured building models of Frankfurt.

Add an integrated mesh to a scene.

Expand
Use dark colors for code blocksCopy
    const geoidService = await Cesium.ArcGISTiledElevationTerrainProvider.fromUrl("https://tiles.arcgis.com/tiles/GVgbJbqm8hXASVYi/arcgis/rest/services/EGM2008/ImageServer");

    // Attribution text retrieved from https://arcgis.com/home/item.html?id=d798c71512404bbb9c1551b827bf5467
    viewer.creditDisplay.addStaticCredit(new Cesium.Credit("National Geospatial-Intelligence Agency (NGA)", false));

    const i3sLayer = "https://tiles.arcgis.com/tiles/cFEFS0EWrhfDeVw9/arcgis/rest/services/Buildings_Frankfurt_2021/SceneServer";

    const i3sProvider = await Cesium.I3SDataProvider.fromUrl(i3sLayer, {
      geoidTiledTerrainProvider: geoidService,
      token: accessToken
    });

    // Attribution text retrieved from https://www.arcgis.com/home/item.html?id=79c3563e42ee40ddb1b8c688eaf0dd2a
    viewer.creditDisplay.addStaticCredit(new Cesium.Credit("Aerowest GmbH / Esri", false));


    viewer.scene.primitives.add(i3sProvider);
Expand

Go to tutorial

Tutorials

CesiumJS scene showing building models from a 3D object layer.

Add 3D objects

Add 3D objects from a scene service to a scene.

CesiumJS scene displaying an integrated building mesh in Frankfurt, Germany.

Add an integrated mesh

Add a textured mesh from a scene service to a scene.

Display a pop-up (I3S)

Display I3S attributes in a popup.

Map tile data

A map tile serviceA map tile service, formerly known as image tile service, is a data service that provides access to static, pre-rendered mao tiles. The tiles are typical in PNG format. Map tiles are typically retrieved by specifying a specific level, row, and column value.Learn more provides access to pre-rendered image tiles (raster tiles) that represent a snapshot of feature data. Map tile services are created from feature services by using ArcGIS portalArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure.Learn more. You can also use the portal to control the service security, tile scales, and caching settings.

Steps

Use ArcGIS portal to import your data and create a feature service (and feature layer).
Style the feature layer.
Publish a map tile layer from the feature layer.
Add the map tile layer to a scene with CesiumJS. Use the service URL.

Add map tiles

This example shows how to add a map tile layer to a CesiumJS application using ArcGISMapServerImageryProvider.

Add a map tile layer to a scene.

Expand
Use dark colors for code blocksCopy
    const tileLayer = Cesium.ArcGisMapServerImageryProvider.fromUrl("https://tiles.arcgis.com/tiles/P3ePLMYs2RVChkJx/arcgis/rest/services/WV03_Kilauea_20180519_ShortwaveInfrared/MapServer", {
      token: accessToken,

      // Attribution text retrieved from https://www.arcgis.com/home/item.html?id=0dcf7df9bfb342cc9e0119f6da7daa45
      credit: new Cesium.Credit("Esri, Digital Globe", false)

    });

    viewer.scene.imageryLayers.add(
      Cesium.ImageryLayer.fromProviderAsync(tileLayer)
    );
Expand

Go to tutorial

Feature data

Steps

Style a feature layer

Tutorials

Add features as GeoJSON

Style features

Display a pop-up (Feature)

Query features (SQL)

Query features (spatial)

Scene data

Steps

Add 3D objects

Add an integrated mesh

Tutorials

Add 3D objects

Add an integrated mesh

Display a pop-up (I3S)

Map tile data

Steps

Add map tiles

More resources