Tutorial: Add features as GeoJSON

Learn how to add features from a feature service to a scene.

Features are a type of geographic data that contain a geometry and attributes. They are typically hosted in an ArcGIS feature service. You can query a feature service to return features formatted as GeoJSON.

This tutorial explains how to get features from a feature service with ArcGIS REST JS, then display them in your CesiumJS application as a GeoJsonDataSource. The tutorial uses three different feature layers, containing points, lines, and polygons.

The three layers you will use are:

Prerequisites

You need an ArcGIS Location Platform or ArcGIS Online account.

Steps

Create a new pen

To get started, you can complete the Display a scene tutorial or use the .

Get an access token

You need an access token with the correct privileges to access the resources used in this tutorial.

Go to the Create an API key tutorial and create an API key with the following privilege(s):
- Privileges
  - Location services > Basemaps
- Item access
  - Note: If you are using your own custom data layer for this tutorial, you need to grant the API key credentials access to the layer item. Learn more in Item access privileges.
Copy the API key access token to your clipboard when prompted.

In CodePen, update the accessToken variable to use your access token.

Use dark colors for code blocks
      const accessToken = "YOUR_ACCESS_TOKEN";

      Cesium.ArcGisMapService.defaultAccessToken = accessToken;

      const cesiumAccessToken = "YOUR_CESIUM_ACCESS_TOKEN";

      Cesium.Ion.defaultAccessToken = cesiumAccessToken;

      const arcGisImagery = Cesium.ArcGisMapServerImageryProvider.fromBasemapType(Cesium.ArcGisBaseMapType.SATELLITE);

      const viewer = new Cesium.Viewer("cesiumContainer", {

        baseLayer: Cesium.ImageryLayer.fromProviderAsync(arcGisImagery),

      });

Run the code to ensure the base layer is displayed in the scene.

To learn about the other types of authentication available, go to Types of authentication.

Add references to ArcGIS REST JS

In the <head> element, reference the feature-service and request packages from ArcGIS REST JS.

Expand
Use dark colors for code blocks
    <script src="https://cesium.com/downloads/cesiumjs/releases/1.121/Build/Cesium/Cesium.js"></script>
    <link href="https://cesium.com/downloads/cesiumjs/releases/1.121/Build/Cesium/Widgets/widgets.css" rel="stylesheet">

    <script src="https://unpkg.com/@esri/arcgis-rest-request@4/dist/bundled/request.umd.js"></script>
    <script src="https://unpkg.com/@esri/arcgis-rest-feature-service@4/dist/bundled/feature-service.umd.js"></script>

Expand

In the <body>, create an arcgisRest.ApiKeyManager using your access token to authenticate requests to the feature service.

Expand
Use dark colors for code blocks
    const accessToken = "YOUR_ACCESS_TOKEN";

    Cesium.ArcGisMapService.defaultAccessToken = accessToken;

    const authentication = arcgisRest.ApiKeyManager.fromKey(accessToken);
Expand

Add point features

Point features are typically displayed on top of all other layers. Use arcgisRest.queryFeatures to query the Trailheads feature service and add features to the scene as GeoJSON.

Go to the Trailheads URL and browse the properties of the layer. Make note of the layer's Name, Type, and Fields.

In CodePen, define a variable to store the URL of the feature service.

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

Call the arcgisRest.queryFeatures operation to make an authenticated request to the Trailheads feature service. Set the f property to geojson to format the response as GeoJSON.

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

    arcgisRest.queryFeatures({
        url: pointLayerURL,
        authentication,
        f:"geojson"
    }).then((response) => {

    });
Expand

Add the service response service to the scene as a GeoJsonDataSource. Set the clampToGround property to clamp the features to terrain.

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

    arcgisRest.queryFeatures({
        url: pointLayerURL,
        authentication,
        f:"geojson"
    }).then((response) => {

        const data = Cesium.GeoJsonDataSource.load(response,{
            clampToGround:true,

        })
        viewer.dataSources.add(data);

    });
Expand

Add the data attribution for the feature layer source.

Go to the Trailheads (Santa Monica Mountains) item.
Scroll down to the Credits (Attribution) section and copy its value.

Create an attribution property and paste the attribution value from the item.

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

    arcgisRest.queryFeatures({
        url: pointLayerURL,
        authentication,
        f:"geojson"
    }).then((response) => {

        const data = Cesium.GeoJsonDataSource.load(response,{
            clampToGround:true,

            // Attribution text retrieved from https://arcgis.com/home/item.html?id=883cedb8c9fe4524b64d47666ed234a7
            credit: new Cesium.Credit('Los Angeles GeoHub', false)

        })
        viewer.dataSources.add(data);

    });
Expand

Add polyline features

Line features are typically displayed below points. Use arcgisRest.queryFeatures to query the Trails feature service and add features to the scene as GeoJSON.

Go to the Trails URL and browse the properties of the layer. Make note of the layer's Name, Type, and Fields.

In CodePen, define a variable to store the URL of the feature service.

Expand
Use dark colors for code blocks
    const lineLayerName = "Trails";
    const lineLayerURL = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/"+lineLayerName+"/FeatureServer/0";
Expand

Call the arcgisRest.queryFeatures operation to make an authenticated request to the Trails feature service. Set the f property to geojson to format the response as GeoJSON.

Expand
Use dark colors for code blocks
    const lineLayerName = "Trails";
    const lineLayerURL = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/"+lineLayerName+"/FeatureServer/0";

    arcgisRest.queryFeatures({
        url: lineLayerURL,
        authentication,
        f:"geojson"
    }).then((response) => {

    });
Expand

Add the service response service to your scene as a GeoJsonDataSource. Set the clampToGround property to clamp the features to terrain.

Expand
Use dark colors for code blocks
    const lineLayerName = "Trails";
    const lineLayerURL = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/"+lineLayerName+"/FeatureServer/0";

    arcgisRest.queryFeatures({
        url: lineLayerURL,
        authentication,
        f:"geojson"
    }).then((response) => {

        const data = Cesium.GeoJsonDataSource.load(response,{
            clampToGround:true,

        })
        viewer.dataSources.add(data);

    });
Expand

Add the data attribution for the feature layer source.

Go to the Trails item.
Scroll down to the Credits (Attribution) section and copy its value.

Create an attribution property and paste the attribution value from the item.

Expand
Use dark colors for code blocks
    const lineLayerName = "Trails";
    const lineLayerURL = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/"+lineLayerName+"/FeatureServer/0";

    arcgisRest.queryFeatures({
        url: lineLayerURL,
        authentication,
        f:"geojson"
    }).then((response) => {

        const data = Cesium.GeoJsonDataSource.load(response,{
            clampToGround:true,

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

        })
        viewer.dataSources.add(data);

    });
Expand

Add polygon features

Polygon features are typically displayed below lines and points. Use arcgisRest.queryFeatures to query the Parks and Open Spaces feature service and add features to the scene as GeoJSON.

Go to the Parks and Open Spaces URL and browse the properties of the layer. Make note of the layer's Name, Type, and Fields.

In CodePen, define a variable to store the URL of the feature service.

Expand
Use dark colors for code blocks
    const polygonLayerName = "Parks_and_Open_Space";
    const polygonLayerURL = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/"+polygonLayerName+"/FeatureServer/0";
Expand

Call the arcgisRest.queryFeatures operation to make an authenticated request to the Parks and Open Spaces feature service. Set the f property to geojson to format the response as GeoJSON.

Expand
Use dark colors for code blocks
    const polygonLayerName = "Parks_and_Open_Space";
    const polygonLayerURL = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/"+polygonLayerName+"/FeatureServer/0";

    arcgisRest.queryFeatures({
        url: polygonLayerURL,
        authentication,
        f:"geojson"
    }).then((response) => {

    });
Expand

Add the service response service to your scene as a GeoJsonDataSource. Set the clampToGround property to clamp the features to terrain.

Expand
Use dark colors for code blocks
    const polygonLayerName = "Parks_and_Open_Space";
    const polygonLayerURL = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/"+polygonLayerName+"/FeatureServer/0";

    arcgisRest.queryFeatures({
        url: polygonLayerURL,
        authentication,
        f:"geojson"
    }).then((response) => {

        const data = Cesium.GeoJsonDataSource.load(response,{
            clampToGround:true,


        })
        viewer.dataSources.add(data);

    });
Expand

Add the data attribution for the feature layer source.

Go to the Parks and Open Space item.
Scroll down to the Credits (Attribution) section and copy its value.

Create an attribution property and paste the attribution value from the item.

Expand
Use dark colors for code blocks
    const polygonLayerName = "Parks_and_Open_Space";
    const polygonLayerURL = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/"+polygonLayerName+"/FeatureServer/0";

    arcgisRest.queryFeatures({
        url: polygonLayerURL,
        authentication,
        f:"geojson"
    }).then((response) => {

        const data = Cesium.GeoJsonDataSource.load(response,{
            clampToGround:true,

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


        })
        viewer.dataSources.add(data);

    });
Expand