Skip to content

/self

GET
Use dark colors for code blocksCopy
1
https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/self
Describes the static basemap tiles service.

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

NameTypeRequiredDescription
tokenstring

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

StatusMeaningDescriptionSchema
200OK

A successful response for the root self request.

ServiceSelf
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
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/self \
  -H 'Authorization: Bearer <YOUR_TOKEN>'

Response

Use dark colors for code blocksCopy
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
{
  "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."
    }
  ]
}

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