https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/self
Returns JSON describing the static basemap tiles service.
This self describing endpoint includes details on supported styles, including the name, thumbnail and a list of supported languages and worldviews. The information for each style also includes the URLs to be used for requesting tiles.
You can use this information to build a dynamic user interface that presents a user with the available selection of basemap styles.
Query parameters
Name | Type | Required | Description |
---|---|---|---|
token | string | The authentication token used to access the static basemap tiles service. |
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>
Response status
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | A successful response for the root self request. | ServiceSelf |
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 |
5XX | **Server Error** | An error occurred on the server. | Error |
Examples
Request
# You can also use wget
curl -X GET https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/self \
-H 'Authorization: Bearer <YOUR_TOKEN>'
Response
{
"languages": [
{
"name": "French",
"code": "fr"
}
],
"styleFamilies": [
{
"name": "ArcGIS",
"code": "arcgis"
}
],
"worldviews": [
{
"name": "United States of America",
"code": "unitedStatesOfAmerica"
}
],
"styles": [
{
"name": "ArcGIS Navigation",
"deprecated": false,
"complete": true,
"path": "/arcgis/navigation",
"provider": "arcgis",
"styleFamily": "arcgis",
"url": "https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/arcgis/navigation/static",
"templateUrl": "https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/arcgis/navigation/static/tile/{z}/{y}/{x}",
"thumbnailUrl": "https://www.arcgis.com/sharing/rest/content/items/ea3befe305494bb5b2acd77e1b3135dc/info/thumbnail/thumbnail1607389425104.jpeg",
"supportedLanguageCodes": [
[
"fr",
"de"
]
],
"supportedWorldviewCodes": [
[
"unitedStatesOfAmerica"
]
],
"description": "This layer provides a detailed basemap for the world featuring a custom navigation map style."
}
]
}