Learn how to perform data-driven styling to customize the appearance of vector tiles based on their underlying feature data.
You can use Esri Leaflet to display vector tile data using custom styles. Esri Leaflet Vector supports the MapLibre style specification, which allows you to customize the fill, outline, opacity, and other properties of vector tiles to display data effectively. If your vector tiles are published from a feature service, you can also perform data-driven visualizations based on attributes of the original feature service.
In this tutorial, you style land parcels from a public vector tile service according to their use type.
Prerequisites
You need an ArcGIS Location Platform or ArcGIS Online account.
Steps
Review the source data
This tutorial uses the Santa Monica Mountains Parcels vector tile service. This vector tile service was created by publishing a feature service as vector tiles using the portal. It contains the attributes of the original feature service, which can be accessed to style layers in your application. Find the original feature service in your portal to view the names and values of different attributes.
-
Go to the item page for the Santa Monica Mountains Parcels vector tile layer.
-
Under Details, find the Created from property. Follow the link to view the item page for the original feature layer, Santa_Monica_Mountains_Parcels.
-
Click the Data tab to view the layer's features and attributes. Each feature represents a land parcel and has attributes such as an address, use code, and number of square feet.
-
Review the values of the
Use
field. You will use this field to style vector tiles in your application.Type
Create a new pen
- To get started, you can complete the Display a map 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.
- Privileges
-
Copy the API key access token to your clipboard when prompted.
-
In CodePen, update the
access
variable to use your access token.Token Use dark colors for code blocks const map = L.map("map", { minZoom: 2 }) map.setView([34.02, -118.805], 13); const accessToken = "YOUR_ACCESS_TOKEN"; const basemapEnum = "arcgis/streets"; L.esri.Vector.vectorBasemapLayer(basemapEnum, { token: accessToken }).addTo(map);
-
Run the code to ensure the basemap is displayed in the map.
To learn about the other types of authentication available, go to Types of authentication.
Add a vector tile layer
Use the Vector
class from Esri Leaflet Vector to add data from the Santa Monica Mountains Parcels vector tile service to your application.
-
Create a
Vector
and set theTile Layer url
to the URL of the Santa Monica Mountains Parcels vector tile service. Add it to the map.Use dark colors for code blocks L.esri.Vector.vectorBasemapLayer(basemapEnum, { token: accessToken, pane: "tilePane" }).addTo(map); const parcelsUrl = "https://vectortileservices3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Santa_Monica_Mountains_Parcels_VTL/VectorTileServer"; L.esri.Vector.vectorTileLayer( parcelsUrl, ).addTo(map); </script>
Style parcels by use type
Use the MapLibre style specification to style land parcels according to their Use
category.
Since Leaflet does not support WebGL, Esri Leaflet Vector uses MapLibre GL JS internally to render vector tiles.
-
Add a
style
function to theVector
.Tile Layer Use dark colors for code blocks L.esri.Vector.vectorTileLayer( parcelsUrl, { style: function (style) { return style } } ).addTo(map);
-
Add a custom
fill-color
to the new style layer. Useget
to retrieveUse
attribute values, viewed in the previous step. UseType case
to create a conditional expression that assigns a unique color to each use type.Use dark colors for code blocks L.esri.Vector.vectorTileLayer( parcelsUrl, { style: function (style) { style.layers[0].paint = { "fill-color": ['case', ['==', ['get','UseType'], 'Residential'], '#E8E191', // Yellow ['==', ['get','UseType'], 'Commercial'], '#E580A2', // Red ['==', ['get','UseType'], 'Government'], '#79E284', // Green ['==', ['get','UseType'], 'Industrial'], '#C080E5', // Purple ['==', ['get','UseType'], 'Institutional'], '#80BBE5', // Blue '#bfbfbf' ], } return style } } ).addTo(map);
-
Run the app. The vector tiles should appear with custom colors for residential, commercial, government, industrial, and institutional land parcels. All remaining parcels should be displayed in gray.
Add an outline layer
Add another style layer to the MapLibre style object to display parcel outlines.
-
Add a
line
layer to the list oflayers
in the style object. Set the source toesri
and thesource-layer
toSanta
to reference the vector tile service._Monica _Mountains _Parcels Use dark colors for code blocks { style: function (style) { style.layers[0].paint = { "fill-color": ['case', ['==', ['get','UseType'], 'Residential'], '#E8E191', // Yellow ['==', ['get','UseType'], 'Commercial'], '#E580A2', // Red ['==', ['get','UseType'], 'Government'], '#79E284', // Green ['==', ['get','UseType'], 'Industrial'], '#C080E5', // Purple ['==', ['get','UseType'], 'Institutional'], '#80BBE5', // Blue '#bfbfbf' ], } style.layers.push({ id: "parcels-outline", source: "esri", "source-layer": "Santa_Monica_Mountains_Parcels", type:'line', }) return style } }
-
Style the color, width, and opacity of the parcel outlines.
Use dark colors for code blocks style.layers.push({ id: "parcels-outline", source: "esri", "source-layer": "Santa_Monica_Mountains_Parcels", type:'line', paint:{ 'line-color':'#000000', 'line-width':0.25, 'line-opacity':0.25 } })
Run the app
In CodePen, run your code to display the map.
You should see the styled vector tile layer with parcels displayed on the basemap layer. Parcels should be styled in different colors based on their use type, and thin outlines should be present around each parcel.
What's next?
Learn how to use additional ArcGIS location services in these tutorials: