Skip to content

/arcgis/streets-night/static/tile/{level}/{row}/{column}

GET
Use dark colors for code blocksCopy
1
https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/arcgis/streets-night/static/tile/{level}/{row}/{column}
Static basemap tiles for the ArcGIS Streets Night style in PNG format.

Returns static basemap tiles for the ArcGIS Streets Night style in PNG format.

ArcGIS Streets Night

Data providers:

Esri, TomTom, Garmin, FAO, NOAA, USGS, © OpenStreetMap contributors, and the GIS User Community. For more details see Esri and data attribution.

Query parameters

NameTypeRequiredDescription
languagestring

Optional case-sensitive parameter to specify the preferred language for basemap labels.

worldviewstring

Optional, case-sensitive parameter to control the boundary lines and labels displayed with some ArcGIS styles.

tokenstring

The authentication token used to access the static basemap tiles service.

language

Optional case-sensitive parameter to specify the preferred language for basemap labels.

This query parameter uses language codes to specify the preferred language. If not set, or if no translation is available, the default basemap labels will be used.

The language codes use the CLDR (Common Locale Data Repository) format string that uses a two letter language code (e.g. "fr" for French) optionally followed by a two letter country code (e.g. "fr-CA" for French in Canada).

If an unsupported language code is used, then the service will attempt to fall-back to the closest available language. This is done by stripping regional and extension sub-tags to find a known language code. For example, French Canadian (fr-CA) is unsupported so this falls back to French fr.

Should the fallback fail, then the service will default to showing the default basemap labels.

Language codes:

  • English - en
  • Dutch - nl
  • Danish - da
  • Finnish - fi
  • French - fr
  • German - de
  • Norwegian - no or nb

Note: if a worldview parameter is provided to the query, the language parameter will be ignored.

Enumerated values

en
Click to copy
nl
Click to copy
da
Click to copy
fi
Click to copy
fr
Click to copy
de
Click to copy
nb
Click to copy
no
Click to copy

worldview

Optional, case-sensitive parameter to control the boundary lines and labels displayed with some ArcGIS styles.

To select a US edition of a basemap style, set the worldview parameter to unitedStatesOfAmerica.

If the worldview parameter is not set, the style will use the standard set of boundary lines and labels as defined by the style, rather than the specific view of a single country.

The worldview parameter allows you to display an edition of basemap borders and labels based on the specific view of a country. Please note that it is not that country's international policy outside of their country.

Note: if this query parameter is set, any provided language parameter will be ignored.

Enumerated values

unitedStatesOfAmerica
Click to copy

token

The authentication token used to access the static basemap tiles service.

The token parameter can be:

  • an API key
  • a short-lived token

API keys and short-lived tokens must be created from an ArcGIS Location Platform account, with the premium:user:staticbasemaptiles privilege.

See ArcGIS security documentation for more information on authentication.

This parameter is required unless you supply an access token in the request header with one of the following keys using the "Bearer" scheme:

  • Authorization: Bearer <YOUR_TOKEN>
  • X-Esri-Authorization: Bearer <YOUR_TOKEN>

Path parameters

NameTypeRequiredDescription
levelinteger

The level of detail (or "tile matrix set") requested for a tile.

rowinteger

Row index of the tile on the selected level of detail.

columninteger

Column index of the tile on the selected level of detail.

level

The level of detail (or "tile matrix set") requested for a tile.

The level parameter is described as the z component in some systems.

Supplying a level of 0 returns the smallest scale of tiles (e.g. the global scale) and a level of 22 returns ths largest scale (e.g. street scale).

Note that the static basemap tiles service uses the tiling scheme of the underlying vector tile service (512x512 pixels), rather than the traditional image tile scheme (256x256 pixels). This means that static basemap tiles service zoom levels are 1 less than those of other APIs. For example: level 12 is equivalent to level 13 for other image map tile services.

The table below shows the resolution and scale of each level:

levelresolutionscale
078271.5169641:295828763.795777
139135.758481999951:147914381.897889
219567.879241000051:73957190.948944
39783.939620499951:36978595.474472
44891.969810249981:18489297.737236
52445.984905124991:9244648.868618
61222.9924525624951:4622324.434309
7611.4962262812451:2311162.217155
8305.748113140691:1155581.108577
9152.8740565702791:577790.554289
1076.43702828520551:288895.277144
1138.21851414253661:144447.638572
1219.10925707126831:72223.819286
139.554628535634151:36111.909643
144.7773142678170751:18055.954822
152.3886571339746851:9027.977411
161.194328566987341:4513.9887055
170.5971642834275251:2256.9943525
180.29858214177990851:1128.4971765
190.14929107082380851:564.248588
200.074645535411904161:282.124294
210.037322767705952081:141.062147
220.018661383852976041:70.5310735

For more information on levels of detail see this page.

Minimum
0
Maximum
22

row

Row index of the tile on the selected level of detail.

The row parameter is described as the y component in some systems.

column

Column index of the tile on the selected level of detail.

The column parameter is described as the x component in some systems.

Response status

StatusMeaningDescriptionSchema
200OK

Tile in PNG format with a size of 512 x 512 pixels.

string(binary)
400Bad Request

Invalid query parameters.

Error
401Unauthorized

Authentication Error. The API key or token is missing, invalid or expired.

Error
403Forbidden

The required parameter 'token' is valid, but does not have permission to access the service.

Error
404Not Found

The requested resource was not found.

Error
5XX**Server Error**

An error occurred on the server.

Error

Examples

Request

Use dark colors for code blocksCopy
1
2
3
# You can also use wget
curl -X GET https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/arcgis/streets-night/static/tile/10/{row}/{column} \
  -H 'Authorization: Bearer <YOUR_TOKEN>'

Response

Use dark colors for code blocksCopy
1
"string"

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