Skip to content

Types

DocumentInfo

Example
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
{
  "Title": "ArcGIS Streets",
  "Author": "Esri",
  "Comments": "string",
  "Subject": "imagery, satellite, aerial",
  "Category": "imageryBaseMapsEarthCover (Imagery, basemaps, and land cover)",
  "AntialiasingMode": "None",
  "TextAntialiasingMode": "None",
  "Keywords": "World,Global,United States"
}

Provides various information about the service such as title, author, keywords and comments.

Properties

NameTypeRequiredDescription
Titlestring

The document title.

Authorstring

The document author.

Commentsstring

The document comments.

Subjectstring

The document subject.

Categorystring

The document category.

AntialiasingModestring

The anti-aliasing mode.

TextAntialiasingModestring

The text anti-aliasing mode.

Keywordsstring

The document keywords.

Enumerated values

AntialiasingMode
None
Click to copy
Fastest
Click to copy
Fast
Click to copy
Normal
Click to copy
Best
Click to copy
TextAntialiasingMode
None
Click to copy
Normal
Click to copy
Force
Click to copy

Error

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

Properties

NameTypeRequiredDescription
errorobject

Error information

error properties

NameTypeRequiredDescription
codeinteger

A code identifying the type of error.

This can be an HTTP status code, 498 (invalid or expired token), or 499 (missing token).

messagestring

A message describing the error.

details[string]

List of details about the error.

Enumerated values

code
400
Click to copy
401
Click to copy
403
Click to copy
404
Click to copy
498
Click to copy
499
Click to copy
500
Click to copy

Extent

Example
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
{
  "spatialReference": {
    "wkid": 102100,
    "latestWkid": 3857
  },
  "xmax": 20037507.22959434,
  "xmin": -20037507.22959434,
  "ymax": 19971868.880408563,
  "ymin": -19971868.880408563
}

Defines a bounding geometry given the lower-left and upper-right corners of the bounding box.

Properties

NameTypeRequiredDescription
spatialReferenceSpatialReference

An object used to specify the spatial reference of the given geometry.

xmaxnumber

A numeric value indicating the top-right X-coordinate of an extent envelope.

xminnumber

A numeric value indicating the bottom-left X-coordinate of an extent envelope.

ymaxnumber

A numeric value indicating the top-right Y-coordinate of an extent envelope.

yminnumber

A numeric value indicating the bottom-left Y-coordinate of an extent envelope.

LevelOfDetail

Example
Use dark colors for code blocksCopy
1
2
3
4
5
{
  "level": 6,
  "resolution": 1222.992452562495,
  "scale": 4622324.434309
}

A level of detail (LOD) in a tiling scheme.

Properties

NameTypeRequiredDescription
levelinteger

ID for each level.

resolutionnumber

Resolution in map units of each pixel in a tile for each level.

scalenumber

Scale for each level.

MetaData

Example
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
{
  "serviceDescription": "string",
  "mapName": "ArcGIS Streets",
  "description": "This layer provides a detailed basemap for the world symbolized with a classic Esri street map style.",
  "copyrightText": "Sources: Esri, TomTom, Garmin, FAO, NOAA, USGS, © OpenStreetMap contributors, and the GIS User Community",
  "supportsDynamicLayers": false,
  "spatialReference": {
    "wkid": 102100,
    "latestWkid": 3857
  },
  "singleFusedMapCache": true,
  "tileInfo": {
    "rows": 512,
    "cols": 512,
    "dpi": 96,
    "compressionQuality": 75,
    "format": "PNG",
    "lods": [
      {
        "level": 6,
        "resolution": 1222.992452562495,
        "scale": 4622324.434309
      }
    ],
    "origin": {
      "m": 0,
      "spatialReference": {
        "wkid": 102100,
        "latestWkid": 3857
      },
      "x": 0,
      "y": 0,
      "z": 0
    },
    "spatialReference": {
      "wkid": 102100,
      "latestWkid": 3857
    }
  },
  "initialExtent": {
    "spatialReference": {
      "wkid": 102100,
      "latestWkid": 3857
    },
    "xmax": 20037507.22959434,
    "xmin": -20037507.22959434,
    "ymax": 19971868.880408563,
    "ymin": -19971868.880408563
  },
  "fullExtent": {
    "spatialReference": {
      "wkid": 102100,
      "latestWkid": 3857
    },
    "xmax": 20037507.22959434,
    "xmin": -20037507.22959434,
    "ymax": 19971868.880408563,
    "ymin": -19971868.880408563
  },
  "minScale": 0,
  "maxScale": 0,
  "units": "esriMeters",
  "supportedImageFormatTypes": "PNG",
  "documentInfo": {
    "Title": "ArcGIS Streets",
    "Author": "Esri",
    "Comments": "string",
    "Subject": "imagery, satellite, aerial",
    "Category": "imageryBaseMapsEarthCover (Imagery, basemaps, and land cover)",
    "AntialiasingMode": "None",
    "TextAntialiasingMode": "None",
    "Keywords": "World,Global,United States"
  },
  "capabilities": "Map",
  "exportTilesAllowed": false,
  "maxRecordCount": 100,
  "maxImageHeight": 512,
  "maxImageWidth": 512
}

The metadata.

Properties

NameTypeRequiredDescription
serviceDescriptionstring

A description of the static basemap tiles service.

mapNamestring

The name of the basemap style.

descriptionstring

A description of the map.

copyrightTextstring

Copyright information for the map.

supportsDynamicLayersboolean

Whether the service supports dynamic layers.

spatialReferenceSpatialReference

The spatial reference of the map.

singleFusedMapCacheboolean

Whether the service has a single fused map cache.

tileInfoTileInfo

The tile information of the service.

initialExtentExtent

The initial extent of the service.

fullExtentExtent

The full extent of the service.

minScale

A number representing the minimum scale at which the layer will be visible. The number is the scale's denominator.

maxScale

A number representing the maximum scale at which the layer will be visible. The number is the scale's denominator.

unitsstring

Units used by the service.

supportedImageFormatTypesstring

The image format types supported by the service when generating a map image.

documentInfoDocumentInfo

Information about the service.

capabilitiesstring

The service's capabilities.

exportTilesAllowedboolean

Whether exporting tiles in compact format (.tpk) is supported.

maxRecordCountinteger

The maximum number of records that will be returned at once for a query.

maxImageHeightinteger

The maximum image height in pixels.

maxImageWidthinteger

The maximum image width in pixels.

Enumerated values

units
esriMeters
Click to copy

Point

Example
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
{
  "m": 0,
  "spatialReference": {
    "wkid": 102100,
    "latestWkid": 3857
  },
  "x": 0,
  "y": 0,
  "z": 0
}

Properties

NameTypeRequiredDescription
mnumber

M coordinate which contains measures used for linear referencing.

spatialReferenceSpatialReference

The spatial reference can be defined using a well-known ID (WKID) or well-known text (WKT).

xnumber

X coordinate which is measured along the east/west axis.

ynumber

Y coordinate which is measured along the north/south axis.

znumber

Z coordinate which measures height or elevation.

ServiceSelf

Example
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."
    }
  ]
}

A JSON structure which describes the static basemap tiles service. Includes a list of all supported styles.

Properties

NameTypeRequiredDescription
languages[object]

List of languages that are supported by certain basemap styles. The language code can be set in the language query parameter for tile requests of supported styles.

Check the array of supportedLanguageCodes for a style to see which languages are available.

styleFamilies[object]

A list of the available style families.

worldviews[object]

Supported worldviews that can be passed to the {?worldview} parameter.

styles[StylesItemSelf]

List of provided styles that can be used.

SpatialReference

Example
Use dark colors for code blocksCopy
1
2
3
4
{
  "wkid": 102100,
  "latestWkid": 3857
}

A spatial reference.

Properties

NameTypeRequiredDescription
wkidinteger

The well-known ID (WKID) of the coordinate system.

latestWkidinteger

Identifies the current wkid value associated with the same spatial reference. For example a WKID of '102100' (Web Mercator) has a latestWKid of '3857'.

StyleFamily

Example
Use dark colors for code blocksCopy
1
"arcgis"
Type
string
Required
false
Restrictions
none

Enumerated values

anonymous
arcgis
Click to copy

StylesItemSelf

Example
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
{
  "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."
}

Describes a given style.

Properties

NameTypeRequiredDescription
namestring

Name of the style.

deprecatedboolean

Details whether the style is deprecated.

completeboolean

Details whether the style can be used as a complete basemap, or whether it requires additional layers.

To present a list of static basemap tiles that are ready to be used stand-alone, filter out styles that are not complete.

For example, the arcgis/streets style is complete because it includes all of the basemap data required to provide the context for a mapping application. It contains a base layer of streets and buildings, with an overlay of place name labels and street names.

By contrast the arcgis/imagery/labels style only provides the place name labels and street names. Without an accompanying satellite imagery base layer this style does not provide a complete basemap.

pathstring

Endpoint path used to access the style.

providerstring

The style provider.

styleFamilyStyleFamily
urlstring(URL)

Full URL to the style metadata.

This can be used with mapping clients that read the tiling scheme etc. from the metadata XML as the entry point for fetching tiles (for example, the ArcGIS Maps SDKs).

You can append the language query parameter to this style, using the codes shown in the supportedLanguageCodes property for the style.

Append the token query parameter to this style to authenticate tile requests.

templateUrlstring(URL)

Template URL for fetching a tile from the style

This can be used with mapping clients that form tile requests using the {x}/{y}/{z} syntax (for example, Cesium JS, OpenLayers, Leaflet and MapLibre). Note that the order of arguments for this service is {z}/{y}/{x} where z equates to the level path parameter, y is row and x is column.

You can append the language query parameter to this style, using the codes shown in the supportedLanguageCodes property for the style.

Append the token query parameter to this style to authenticate tile requests.

thumbnailUrlstring(URL)

Link to a thumbnail JPG for the style.

supportedLanguageCodes[string]

A list of the language codes that are supported for this style.

Language codes can be passed to a given style with the language query parameter. You can see full details of a given language, including it's display name in the top-level languages property for the service's self endpoint.

If this array is empty for a give style, only the default language for the basemap is supported.

supportedWorldviewCodes[string]

A list of the worldview codes that are supported for this style.

Pass a worldview code to a given style with the worldview query parameter to get that edition of the basemap. You can see full details of an edition, including its display name in the top-level worldviews property for the service's self endpoint.

If this array is empty for a given style, only the default worldview for the basemap is supported.

Note: worldview is currently only supported with the default language. If a worldview parameter is provided, any language query parameter passed alongside it will be ignored.

descriptionstring

A description of the style.

Enumerated values

provider
arcgis
Click to copy

TileInfo

Example
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
{
  "rows": 512,
  "cols": 512,
  "dpi": 96,
  "compressionQuality": 75,
  "format": "PNG",
  "lods": [
    {
      "level": 6,
      "resolution": 1222.992452562495,
      "scale": 4622324.434309
    }
  ],
  "origin": {
    "m": 0,
    "spatialReference": {
      "wkid": 102100,
      "latestWkid": 3857
    },
    "x": 0,
    "y": 0,
    "z": 0
  },
  "spatialReference": {
    "wkid": 102100,
    "latestWkid": 3857
  }
}

Tile information, returned from the service.

Properties

NameTypeRequiredDescription
rowsinteger

Requested tile's row.

colsinteger

Requested tile's column.

dpinumber

The dpi of the tiling scheme.

compressionQualitynumber

Compression quality of the tile.

formatstring

Image format of the tile.

lods[LevelOfDetail]

An array of levels of detail that define the tiling scheme.

originPoint

The tiling scheme origin.

spatialReferenceSpatialReference

The spatial reference of the tiling schema.

Enumerated values

format
PNG
Click to copy

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