Tutorial: Style features

Learn how to use data-driven styling to apply symbol colors and styles to feature layers.

A feature layer is a dataset in a feature service hosted in ArcGIS. Each feature layer contains features with a single geometry type (point, line, or polygon), and a set of attributes.

In this tutorial, you apply different styles to enhance the visualization of the Trailheads, Trails, and Parks and Open Spaces feature layers.

Prerequisites

You need an ArcGIS Location Platform or ArcGIS Online account.

Steps

Create a new pen

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

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

      });

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

Remove the terrain provider

CesiumJS does not currently fully support layer styling in scenes with terrain.

Remove the terrainProvider from your viewer to enable layer ordering and feature outlines.

Use dark colors for code blocks
        const viewer = new Cesium.Viewer("cesiumContainer", {

            imageryProvider: arcGISImageTileProvider,

            terrainProvider: Cesium.createWorldTerrain(),

            timeline: false,
            animation: false,

            geocoder:false

        });

Style trailheads (points) with icons

To style a point feature layer with custom icons, add the layer as a GeoJsonDataSource and iterate through each Entity created by the layer. Set the Billboard property to style the points with trailhead icons.

Use arcgisRest.queryFeatures to make an authenticated request to the Trailheads URL. Format the response as GeoJSON, then add it to your scene as a GeoJsonDataSource.

Expand
Use dark colors for code blocks
    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
      }).then((dataSource) => {

        dataSource.name="trailheads";
        viewer.dataSources.add(dataSource);

      })
    })
Expand

After the layer is loaded, iterate through each Entity in the layer and set each Billboard image to the URL for the hiker icon: http://static.arcgis.com/images/Symbols/NPS/npsPictograph_0231b.png.

Expand
Use dark colors for code blocks
    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
      }).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

Style trails (lines) by elevation gain

To visualize the elevation gain of trails in the Trails (lines) feature layer, add the layer as a GeoJsonDataSource and the width of each line based on its properties.

Call the arcgisRest.queryFeatures operation to make an authenticated request to the Trails URL. Format the response as GeoJSON and add it to the scene as a GeoJsonDataSource.

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

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

      Cesium.GeoJsonDataSource.load(response,{
            clampToGround:true
      }).then((dataSource) => {

        dataSource.name="trails";
        viewer.dataSources.add(dataSource);

      })
    })
Expand

Iterate through all entities and set the polyline width of each entity based on their ELEV_GAIN property.

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

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

      Cesium.GeoJsonDataSource.load(response,{
            clampToGround:true
      }).then((dataSource) => {

        dataSource.name="trails";
        viewer.dataSources.add(dataSource);

        const entities = dataSource.entities.values;
        for (let i=0; i<entities.length;i++) {
          const trail = entities[i];
          trail.polyline.width = 3 + (4* trail.properties.ELEV_GAIN._value)/2300;
          trail.polyline.material = Cesium.Color.fromCssColorString('#FCADF9');
          trail.polyline.zIndex = 2;
        }

      })
    })
Expand

Style parks (polygons) by type

You can create a categorical rendering of parks based on their attribute values. Render the polygon features from the Parks and Open Space feature layer with different colors based on the type of land they represent.

Call the arcgisRest.queryFeatures opeartion to make an authenticated request to the Parks and Open Space URL. Format the response as GeoJSON and add it to the scene as a GeoJsonDataSource.

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

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

      Cesium.GeoJsonDataSource.load(response,{
            clampToGround:true
      }).then((dataSource) => {

        dataSource.name="parks"
        viewer.dataSources.add(dataSource);

      })
    })
Expand

The TYPE attribute of the layer contains four different types of parks and open spaces. Define a unique color for each category.

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

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

      Cesium.GeoJsonDataSource.load(response,{
            clampToGround:true
      }).then((dataSource) => {

        dataSource.name="parks"
        viewer.dataSources.add(dataSource);

        const parkColors = {
          "Natural Areas": "#9E559C",
          "Regional Open Space": "#A7C636",
          "Local Park": "#149ECE",
          "Regional Recreation Park": "#ED5151"
        };

      })
    })
Expand

Iterate through all entities and set the polygon material of each entity based on the TYPE of park.

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

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

      Cesium.GeoJsonDataSource.load(response,{
            clampToGround:true
      }).then((dataSource) => {

        dataSource.name="parks"
        viewer.dataSources.add(dataSource);

        const entities = dataSource.entities.values;
        for (let i=0; i<entities.length;i++) {
          const park = entities[i];

          if (park.polygon == null) {
            continue;
          }

          const color = Cesium.Color.fromCssColorString(parkColors[park.properties.TYPE._value]);
          color.alpha = 0.7
          park.polygon.material = color;
          park.polygon.zIndex=1;
          park.polygon.outline = false;
        }

      })
    })
Expand

Run the app

In CodePen, run your code to display the map.

Your map should display the trailheads, trails, and open spaces in the Santa Monica Mountains:

Each trailhead should be represented with a hiker icon.
Each trail should have a custom width based on its total elevation gain.
Each park should be assigned a color based on its type.

What's next?

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

Display a pop-up (Feature)

Display feature attributes in a popup.

Search for an address

Find an address or place using a search box and the geocoding service.

Find a route and directions

Find a route and directions with the route service.