/arcgis/human-geography/static/tile/{level}/{row}/{column}

Click to copy

Static basemap tiles for the ArcGIS Human Geography style in PNG format.

Returns static basemap tiles for the ArcGIS Human Geography style in PNG format.

ArcGIS Human Geography

For more information about the style, data providers, attribution, and terms of use, go to the item page in ArcGIS.

Query parameters

NameTypeRequiredDefault valueDescription

string

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

string

The authentication token, created from an ArcGIS Location Platform account, with the premium:user:staticbasemaptiles privilege, 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 - nb
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

token

The authentication token, created from an ArcGIS Location Platform account, with the premium:user:staticbasemaptiles privilege, used to access the static basemap tiles service.

The token parameter can be either an API Key or short-lived token. See ArcGIS security documentation for more information on authenticating with a token or API key.

Alternatively, you can supply a 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

NameTypeRequiredDefault valueDescription

integer

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

integer

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

integer

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.

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.

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/beta/arcgis/human-geography/static/tile/{level}/{row}/{column} \
  -H 'Accept: image/png'

Response

200 Response

400 Response

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
{
  "error": {
    "code": 400,
    "message": "Parameter invalid.",
    "details": [
      "string"
    ]
  }
}
StatusMeaningDescriptionSchema

200

OK

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

string

400

Bad Request

Invalid query parameters.

Error

401

Unauthorized

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

Error

403

Forbidden

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

Error

404

Not Found

The requested resource was not found.

Error

5XX

Unknown

An error occurred on the server.

Error

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