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 Developer or ArcGIS Online account to access the developer dashboard and create an API key.

Steps

Create a new pen

To get started, either complete the Display a scene tutorial or .

Set the API key

To access location services, you need an API key or OAuth 2.0 access token. To learn how to create and scope your key, visit the Create an API key tutorial.

Go to your dashboard to get an API key. The API key must be scoped to access the services used in this tutorial.

In CodePen, update apiKey to use your key. Update cesiumAccessToken to use your Cesium ion access token.

Use dark colors for code blocks
      const apiKey = "YOUR_API_KEY";

      Cesium.ArcGisMapService.defaultAccessToken = apiKey;

      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),

      });

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.107/Build/Cesium/Cesium.js"></script>
    <link href="https://cesium.com/downloads/cesiumjs/releases/1.107/Build/Cesium/Widgets/widgets.css" rel="stylesheet">

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

Expand

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

Expand
Use dark colors for code blocks
    const apiKey = "YOUR_API_KEY";

    Cesium.ArcGisMapService.defaultAccessToken = apiKey;

    const authentication = arcgisRest.ApiKeyManager.fromKey(apiKey);
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 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 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

Run the app

In CodePen, run your code to display the map.

Your map should display the locations of trailheads, trails, and open spaces in the Santa Monica Mountains.

What's next?

Learn how to use additional ArcGIS location services in these tutorials:

Style features

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

Display a pop-up (Feature)

Display feature attributes in a popup.

Query features (SQL)

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

Query features (spatial)

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

CesiumJS

Tutorial: Add features as GeoJSON

Prerequisites

Steps

Create a new pen

Set the API key

Add references to ArcGIS REST JS

Add point features

Add polyline features

Add polygon features

Run the app

What's next?

Style features

Display a pop-up (Feature)

Query features (SQL)

Query features (spatial)

Was this page helpful?