Introduction to maps

A is a collection of . You use a map together with a to display layers of geographic data in 2D. Most applications contain a to display geographic data with streets or satellite imagery. The data for a basemap layer is typically provided by basemap services, such as the or .

You can use basemap layers to:

  • Display different types of geographic data of the world for a map.
  • Display vector tile styles such as streets, navigation, outdoor, and light gray canvas.
  • Display map tiles for oceans, satellite, imagery, and hillshade.
  • Display custom vector basemap styles with your own colors, glyphs, and fonts.

Basemap styles service

The basemap styles service is a that provides and data for the extent of the world. The service includes ArcGIS and OSM styles. There are default basemap styles such as streets, navigation, light gray canvas, and imagery. The data for each style is provided through vector tile layers and map tile layers hosted in ArcGIS and is stored in a Web Mercator spatial reference.

How to access basemap styles service

To access vector basemap layers, you reference both the main Esri Leaflet plugin and the vectorBasemapLayer plugin.

  1. Reference the Esri Leaflet and vector plugins.
  2. Set the and define a basemap style enumeration.
  3. Instantiate the vectorBasemapLayer class and pass the basemap enumeration.
  4. Add it to the map.

Example

This example loads and displays the arcgis/streets style from the . To see all of the basemap style enumerations available, go to the Basemap styles service API reference.

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

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

<script>

  const accessToken = "YOUR_ACCESS_TOKEN";
  const basemapEnum = "arcgis/streets";

  const map = L.map('map', {
    minZoom: 2
  }).setView([34.02,-118.805], 13);

  L.esri.Vector.vectorBasemapLayer(basemapEnum, {
    token: accessToken,
    version: 2
  }).addTo(map);

</script>

Static basemap tiles service (beta)

The static basemap tiles service is a that provides basemap tiles for the extent of the world. The service supports default basemap styles such as streets, navigation, outdoor, and light gray canvas. The tiles are supplied as 512x512 .png files in a Web Mercator spatial reference.

How to access static basemap tiles service

To access static basemap tiles, you reference both the main Esri Leaflet plugin and the staticBasemapTileLayer plugin.

  1. Reference the Esri Leaflet and static basemap tile plugins.
  2. Set the and define a basemap style enumeration.
  3. Instantiate the staticBasemapTileLayer class and pass the basemap enumeration.
  4. Add it to the map.

Example

This example loads and displays the arcgis/outdoor style from the (beta). To see all of the basemap style enumerations available, go to the Static basemap tiles service (beta) API reference.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<!-- Esri Leaflet -->
<script src="https://unpkg.com/esri-leaflet@3.0.14/dist/esri-leaflet.js"></script>

<!-- Static basemap tile plugin -->
<script src="https://unpkg.com/esri-leaflet-static-basemap-tile@1.0.0-beta.2/dist/esri-leaflet-static-basemap-tile.js"></script>

<script>

  const accessToken = "YOUR_ACCESS_TOKEN";
  const basemapEnum = "beta/arcgis/outdoor";

  const map = L.map("map", {
    minZoom: 2
  }).setView([37.1174, -91.2996], 5);

  L.esri.Static.staticBasemapTileLayer(basemapEnum, {
    token: accessToken
  }).addTo(map);

</script>

Tutorials

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

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close