Add a vector tile layer

Learn how to add a vector tile layer to a map.

A vector tile layer is a hosted data layer with vector tile data. You can create a vector tile layer by publishing your data with data management tools.

In this tutorial, you display a parcels layer from a public vector tile service with its default styling.

Prerequisites

Steps

Create a new pen

1. To get started, either complete the Display a map tutorial or use this pen.

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.

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

2. In CodePen, update apiKey to use your key.

   Use dark colors for code blocks

                                                              

   Change line

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
         const apiKey = "YOUR_API_KEY";
   
         const basemapEnum = "ArcGIS:Streets";
   
         const map = L.map("map", {
           minZoom: 2
         }).setView([34.02, -118.805], 13);
   
         L.esri.Vector.vectorBasemapLayer(basemapEnum, {
           apiKey: apiKey,
           pane: "tilePane"
         }).addTo(map);
   

Add a vector tile layer

To access the vector tile service, you use the vectorTileLayer class.

1. Create a vectorTileLayer and set the url of the layer before adding it to the map.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
      L.esri.Vector.vectorBasemapLayer(basemapEnum, {
        apiKey: apiKey,
        pane: "tilePane"
      }).addTo(map);

      L.esri.Vector.vectorTileLayer(
        "https://vectortileservices3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Santa_Monica_Mountains_Parcels_VTL/VectorTileServer"
      ).addTo(map);

    </script>

Run the app

In CodePen, run your code to display the map.

You should see the vector tile layer with parcels displayed on the basemap layer.

What's next?

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

Add an image tile layer

Add an image tile layer to a map.

Style a feature layer

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

Search for an address

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