Introduction to visualization

There are different ways to style your data to create different types of visualizations. You can style basemap layers, which are composed of vector tile data, or feature layers, which are composed of features.

Basemap styles

You can use the default styles or you can create your own basemap styles that work with the basemap layer service. The following types are available:

  • Default styles: Enumerations for existing styles such as ArcGIS:Streets, ArcGIS:Topographic, and ArcGIS:Nova.
  • Custom styles: Styles you create and save as items using the ArcGIS Vector Tile Style Editor.

How to display a custom basemap style

  1. Create a style with the ArcGIS Vector Tile Style Editor.
  2. Go to the new basemap layer's item page and copy its item ID.
  3. Reference the Esri Leaflet and vector plugins.
  4. Instantiate the L.esri.Vector.vectorBasemapLayer class and set the item ID.

Example

Display a custom basemap layer

This example illustrates how you can set the item ID of a custom vector basemap layer in place of a default basemap layer style.

Use dark colors for code blocksCopy
             
1
2
3
4
5
6
7
8
9
10
11
12
13
<script src="https://unpkg.com/esri-leaflet@3.0.8/dist/esri-leaflet.js"
    integrity="sha512-oUArlxr7VpoY7f/dd3ZdUL7FGOvS79nXVVQhxlg6ij4Fhdc4QID43LUFRs7abwHNJ0EYWijiN5LP2ZRR2PY4hQ=="
    crossorigin=""></script>

<script src="https://unpkg.com/esri-leaflet-vector@4.0.0/dist/esri-leaflet-vector.js"
    integrity="sha512-7rLAors9em7cR3/583gZSvu1mxwPBUjWjdFJ000pc4Wpu+fq84lXF1l4dbG4ShiPQ4pSBUTb4e9xaO6xtMZIlA=="
    crossorigin=""></script>

<script>
  L.esri.Vector.vectorBasemapLayer("6976148c11bd497d8624206f9ee03e30", {
    apiKey: apiKey
  }).addTo(map);
</script>

To learn more, visit the Create a custom basemap style and Display a custom vector tile style tutorials.

Feature styles

You can style and display points, lines, and polygons in a map by defining symbols for features. To style features in a feature layer, you define symbols and apply them with a renderer. For data-driven visualization, the symbol is always determined based on a data (attribute) value returned from a field in the data layer.

How to style a feature layer

  1. Import your data from a CSV, XLS, GeoJSON, or Shapefile file to create a hosted feature layer.
  2. Get the URL for the feature layer.
  3. Reference the Esri Leaflet plugin.
  4. Instantiate the L.esri.featureLayer class and set the URL.
  5. Define the symbols for the features in the layer.

Example

Style a feature layer (polylines)

In this example, you filter features in a feature layer so that only bike trails are styled.

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
<script src="https://unpkg.com/esri-leaflet@3.0.8/dist/esri-leaflet.js"
    integrity="sha512-oUArlxr7VpoY7f/dd3ZdUL7FGOvS79nXVVQhxlg6ij4Fhdc4QID43LUFRs7abwHNJ0EYWijiN5LP2ZRR2PY4hQ=="
    crossorigin=""></script>

<script>
  L.esri
    .featureLayer({
      url: "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails/FeatureServer/0",
      where: "USE_BIKE = 'YES'",
      pane: "bikeTrails",
      style: () => {
        return {
          color: "#FFFFFF",
          dashArray: "2, 3",
          dashOffset: "2",
          weight: "1.5"
        };
      }
    })
    .addTo(map);
</script>

To learn more, visit the Style a feature layer tutorial.

Tutorials

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