Introduction to the Static Basemap Tiles service

What is the Static Basemap Tiles service?

The ArcGIS Static Basemap Tiles serviceThe ArcGIS Static Basemap Tiles service, also known as the Static Basemap Tiles service, is a location service that provides basemap data as pre-rendered and pre-styled map tiles for the world. It supports key styles in the ArcGIS Basemap style family. An ArcGIS Location Platform account is required to use the services.Learn more, also referred to as the Static Basemap Tiles service, is a data source that provides basemapA basemap is the foundational layer and data that provides the overall visual and geographic context for a map or scene. It typically includes geographic features and labels for land, water, roads, buildings, cities, places, and administrative boundaries, but can also include raster data such as satellite and areal images.Learn more data as pre-rendered and pre-styled map tilesA map tile, also known as a raster tile, is an image file typically in PNG format returned from a map tile service. It is part of a set of tiles that, conceptually, are pieces of a bigger map. A map tile is typically retrieved for a specific level, row, and column.Learn more for the world. The map tiles are 512 x 512 px PNG files and support the web mercator spatial referenceA spatial reference is a set of parameters, typically defined by a WKID, that define the coordinate system and spatial properties for geographic data. Applications use a spatial reference to correctly display the position of geographic data in a map or scene.Learn more. The service provides styles from the ArcGIS Basemap stylesArcGIS Basemap styles are the family of basemap styles that use authoritative data from Esri and partners such as TomTom, Garmin, FAO, NOAA, USGS, OpenStreetMap contributors, and the GIS User Community.Learn more and Open Basemap stylesOpen Basemap styles are the family of basemap styles that use open source data from Overture Maps, which includes data from OpenStreetMap (OSM), Microsoft, Esri Community Maps, and other open data sources.Learn more families. The styles are grouped into the following categories: streets, topography, satellite, reference, and creative. They include a number of popular basemap styles such as streets, navigation, and outdoor. The service can also display key styles with a preferred language or worldview.

You can use the service to:

• Build mapping applications to display map tiles for the world.
• Provide the underlying visual and geographic context for a map.
• Show map tile styles such as streets, navigation, and light-gray.
• Display key ArcGIS Basemap styles that use authoritative data providers.
• Display Open Basemap styles that use open source data providers.
• Access data for maps using ArcGIS Maps SDKs and Open source libraries.
• Set the language and worldview display preference (ArcGIS Basemap styles family only).
• Support non-WebGL and older clients.

How to use the Static Basemap Tiles service

To request a basemap, you need to use a mapping API that can access a tile service. You request tiles by using the service URL with the appropriate path parameters. The path parameters specify the style family, style name, and tile scheme. When using the ArcGIS Maps SDKs, helper classes and enumerations may be available to access each style. When using open source libraries, you typically need to define the service URL and path parameters yourself. You may also have to provide Esri and data attribution. The query parameters can be used to set preferences for the style returned.

The steps to use the service are to:

1. Get an access token with the correct privilege.
2. Define the service URL and path parameters for the appropriate style family and style name.
3. Set the query parameters to display the preferred language and worldview (if available).

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
60
61
62
63
64
      const basemapStyle = "arcgis/navigation";
      // const basemapStyle = "arcgis/streets"
      // const basemapStyle = "arcgis/outdoor"
      // const basemapStyle = "arcgis/light-gray"
      // const basemapStyle = "arcgis/dark-gray"
      const basemap = new Basemap({
        baseLayers: [
          new TileLayer({
            url: `https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/${basemapStyle}/static`,
          }),
        ],
      });

      const map = new Map({
        basemap: basemap,
      });

      const view = new MapView({
        container: "viewDiv",
        map: map,
        center: [-91.2996, 37.1174], // USA (x, y)
        zoom: 4,
      });

Service URL

1
https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1

Path parameters

These are required parameters to specify the style to access.

1
https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/{style_family}/{style}/static/tile/{z}/{y}/{x}

Query parameters

These are optional parameters to set style preferences and the access token. Some are only available for key styles.

Tokens

Access token

To request styles from the basemap service, you need an access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more. To use an access token, you first need to implement a type of authentication. The resulting token must have the premium:user:staticbasemaptiles privilege. Using the access token directly to access styles will result in basemap tile usage chargesBasemap usage is the type of consumption that occurs when accessing basemaps from a basemap service. It is measured by the number of tiles consumed or sessions created.Learn more. To learn more, go to Basemap usage > Tile usage model.

How to use access tokens

Query parameter

An access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more can be used as the value of the token query parameter.

1
https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/{style_family}/{style_name}/{z}/{y}/{x}?token=<YOUR_ACCESS_TOKEN>

Authorization header

An access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more can also be used as the value for an authorization header. This is the preferred method.

1
2
3
GET https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/{style_family}/{style_name}/{z}/{y}/{x} HTTP/1.1
  Host: basemapstyles-api.arcgis.com
  Authorization: Bearer <YOUR_ACCESS_TOKEN>

Attribution

All applications that use an ArcGIS API, SDK, service, content, or data must display Esri and data attribution. This also applies to applications that use ArcGIS Basemap servicesArcGIS Basemap services, also referred to as Basemap services, are location services hosted by Esri that provide data sources for building mapping applications. It includes the ArcGIS Basemap Styles service and ArcGIS Static Basemap Tiles service. Each service provides a specific type of basemap data and set of styles.Learn more. When using the ArcGIS Maps SDKs, the correct attribution is typically displayed for you in the map. However, when using open source or other third party libraries, you may need to take additional steps to access the basemap service and display the attribution for Esri and data providers.

Tiling scheme

The tiles are served as 512 x 512 pixels and are based on the ArcGIS MapServer specification.

Example

1
https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/{style_family}/{style_name}/{z}/{y}/{x}

Style family and names

The service supports styles from the ArcGIS Basemap styles and Open Basemap styles families. The ArcGIS style family data providers include

TomTom, Garmin, FAO, NOAA, USGS, OpenStreetMap (OSM) contributors, and the GIS User Community.

OpenStreetMap (OSM), Microsoft, Esri Community Maps, and other open data sources.

Below is a list of the supported style families and style names:

• arcgis/navigation
• arcgis/navigation-night
• arcgis/streets
• arcgis/streets-night
• arcgis/outdoor
• arcgis/light-gray
• arcgis/dark-gray
• arcgis/imagery-labels
• arcgis/oceans-labels
• arcgis/community
• arcgis/nova
• arcgis/midcentury
• arcgis/newspaper
• arcgis/human-geography
• arcgis/human-geography-dark
• open/osm-style
• open/navigation
• open/navigation-dark
• open/streets
• open/hybrid-detail
• open/light-gray
• open/dark-gray

To learn how to access the service to get these styles, go to ArcGIS Basemap styles or Open Basemap styles.

What's next?

Learn how to build mapping applications with the Static Basemap Tiles service.