Skip to content

Types

BasemapSession

Example
Use dark colors for code blocksCopy
1
2
3
4
5
6
{
  "sessionToken": "string",
  "endTime": 0,
  "startTime": 0,
  "styleFamily": "arcgis"
}

The basemap session is a duration of time that users can use a session token to access basemap styles and tiles from this service. The basemap session usage model allows ArcGIS Location Platform developers to use unlimited ArcGIS basemap tiles for a specific amount of time which is the session duration. The maximum duration is 12 hours. There is only one usage charge to create the session token and no additional usage charges to access individual basemap tiles.

Properties

NameTypeRequiredDescription
sessionTokenstring

A session token is a token that can access this service for a set duration of time and for a fixed usage cost.

endTimenumber(int64)

The time at which the session token expires. It is represented as the number of milliseconds since unix 1970 epoch.

startTimenumber(int64)

The time at which the session token was created. It is represented as the number of milliseconds since unix 1970 epoch.

styleFamilySessionStyleFamily

The family of styles that the session token can be used to access. The styleFamily can be an ArcGIS basemap style family or an Open basemap style family.

Error

Example
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
{
  "error": {
    "code": 400,
    "message": "string",
    "details": [
      "string"
    ],
    "restInfoUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/info"
  }
}

Properties

NameTypeRequiredDescription
errorobject

Error information

error properties

NameTypeRequiredDescription
codeinteger

A code identifying the type of error, either an HTTP error code, 498 (signifying invalid or expired token), or 499 (signifying missing token).

messagestring

A message describing the error.

details[string]

List of details about the error.

restInfoUrlstring

URL that provides the basemap-styles service information.

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

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
{
  "name": "Basemap Styles",
  "version": "x.x.x",
  "description": "Brief description of Basemap styles API",
  "styleFamilies": [
    {
      "name": "ArcGIS",
      "code": "arcgis"
    }
  ],
  "languages": [
    {
      "name": "English",
      "code": "en"
    }
  ],
  "worldviews": [
    {
      "name": "China",
      "code": "china"
    }
  ],
  "places": [
    {
      "name": "Attributed",
      "code": "attributed"
    }
  ],
  "selfUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/self",
  "stylesUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/self",
  "webmapsUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/self"
}

A JSON structure which describes the Basemap Styles Service. Includes a list of all supported languages, worldviews, and places.

Properties

NameTypeRequiredDescription
namestring

Name of the service.

versionstring

Version of the service that you are using.

descriptionstring

Description of the service.

styleFamilies[object]

A list of the available style families.

languages[object]

Supported languages that can be passed to the {?language} parameters.

worldviews[object]

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

places[object]

Supported places values that can be passed to the {?places} parameters.

selfUrlstring

URL that points to self.

stylesUrlstring

URL that points to styles self.

webmapsUrlstring

URL that points to webmaps self.

SessionStyleFamily

Example
Use dark colors for code blocksCopy
1
"arcgis"

The family of styles that the session can access. This can be an ArcGIS basemap style family or an Open basemap style family.

Type
string
Required
false
Restrictions
none

Enumerated values

anonymous
arcgis
Click to copy
open
Click to copy

Style

Provides a Style JSON as defined by the Maplibre Style specification.

StyleFamily

Example
Use dark colors for code blocksCopy
1
"arcgis"

The family of the style.

Type
string
Required
false
Restrictions
none

Enumerated values

anonymous
arcgis
Click to copy
open
Click to copy
osm
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
{
  "name": "ArcGIS Human Geography Dark",
  "deprecated": false,
  "complete": true,
  "path": "/styles/arcgis/human-geography-dark",
  "provider": "arcgis",
  "styleFamily": "arcgis",
  "thumbnailUrl": "https://www.arcgis.com/sharing/rest/content/items/ea3befe305494bb5b2acd77e1b3135dc/info/thumbnail/thumbnail1659480292164.png",
  "selfUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark/self",
  "styleUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark{?language}{?worldview}{?places}",
  "rootUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark/base{?language}{?worldview}{?places}",
  "baseUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark/base/self",
  "detailUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark/detail/self",
  "labelsUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark/labels/self"
}

Describes the provided style.

Properties

NameTypeRequiredDescription
namestring

Name of the style.

deprecatedboolean

True if the style is deprecated, false otherwise.

completeboolean

True if the style can be used as a complete basemap, or false if it requires additional layers.

To present users with a list of basemap styles that are ready to be used as a stand-alone basemap, filter out styles that are marked as not complete.

For example, the arcgis/imagery style includes all of the basemap data required to provide the context for a mapping application and so is considered complete. It is comprised of a base layer of satellite imagery with an overlay of place name labels and streets.

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

pathstring

Endpoint path used to access the style.

providerstring

Style provider, arcgis or osm.

styleFamilyStyleFamily

The family of the style.

thumbnailUrlstring

Link to thumnail of style.

selfUrlstring

URL that points to self.

styleUrlstring

URL that refers to a style, potentially including parameters such as language, worldview, or places at the end if they are supported.

rootUrlstring

URL that refers to a style's base portal id layer, potentially including parameters such as language, worldview, or places at the end if they are supported.

baseUrlstring

URL that points to the base layer self.

detailUrlstring

URL that points to the detail layer self.

labelsUrlstring

URL that points to the labels layer self.

StylesSelf

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": "English",
      "code": "en"
    }
  ],
  "worldviews": [
    {
      "name": "China",
      "code": "china"
    }
  ],
  "places": [
    {
      "name": "Attributed",
      "code": "attributed"
    }
  ],
  "styleFamilies": [
    {
      "name": "ArcGIS",
      "code": "arcgis"
    }
  ],
  "styles": [
    {
      "name": "ArcGIS Human Geography Dark",
      "deprecated": false,
      "complete": true,
      "path": "/styles/arcgis/human-geography-dark",
      "provider": "arcgis",
      "styleFamily": "arcgis",
      "thumbnailUrl": "https://www.arcgis.com/sharing/rest/content/items/ea3befe305494bb5b2acd77e1b3135dc/info/thumbnail/thumbnail1659480292164.png",
      "selfUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark/self",
      "styleUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark{?language}{?worldview}{?places}",
      "rootUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark/base{?language}{?worldview}{?places}",
      "baseUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark/base/self",
      "detailUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark/detail/self",
      "labelsUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/human-geography-dark/labels/self"
    }
  ],
  "selfUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/self",
  "customStylesUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/items/{item_id}"
}

Describes the list of available style endpoints.

Properties

NameTypeRequiredDescription
languages[object]

Supported languages that can be passed to the {?language} parameters.

worldviews[object]

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

places[object]

Supported places values that can be passed to the {?places} parameters.

styleFamilies[object]

A list of the available style families.

styles[StylesItemSelf]

List of provided styles that can be used.

selfUrlstring

URL that points to self.

customStylesUrlstring

URL that points to custom styles of the output type.

Webmap

Provides a Webmap JSON as defined by the ESRI ArcGIS Webmap specification.

Contains a URL pointing to the location of the requested style.

WebmapItemSelf

Example
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "name": "ArcGIS Human Geography Dark",
  "deprecated": false,
  "complete": true,
  "path": "/styles/arcgis/human-geography-dark",
  "provider": "arcgis",
  "styleFamily": "arcgis",
  "thumbnailUrl": "https://www.arcgis.com/sharing/rest/content/items/ea3befe305494bb5b2acd77e1b3135dc/info/thumbnail/thumbnail1659480292164.png",
  "selfUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark/self",
  "styleUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark{?language}{?worldview}{?places}",
  "rootUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark/base{?language}{?worldview}{?places}",
  "baseUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark/base/self",
  "detailUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark/detail/self",
  "labelsUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark/labels/self"
}

Describes the provided style.

Properties

NameTypeRequiredDescription
namestring

Name of the style.

deprecatedboolean

True if the style is deprecated, false otherwise.

completeboolean

True if the style can be used as a complete basemap, or false if it requires additional layers.

To present users with a list of basemap styles that are ready to be used as a stand-alone basemap, filter out styles that are marked as not complete.

For example, the arcgis/imagery style includes all of the basemap data required to provide the context for a mapping application and so is considered complete. It is comprised of a base layer of satellite imagery with an overlay of place name labels and streets.

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

pathstring

Endpoint path used to access the webmap.

providerstring

Style provider, arcgis or osm.

styleFamilyStyleFamily

The family of the style. This can be an ArcGIS basemap style family or an Open basemap style family.

thumbnailUrlstring

Link to thumnail of style.

selfUrlstring

URL that points to self.

styleUrlstring

URL that refers to a style, potentially including parameters such as language, worldview, or places at the end if they are supported.

rootUrlstring

URL that refers to a style's base portal id layer, potentially including parameters such as language, worldview, or places at the end if they are supported.

baseUrlstring

URL that points to the base layer self.

detailUrlstring

URL that points to the detail layer self.

labelsUrlstring

URL that points to the labels layer self.

WebmapsSelf

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": "English",
      "code": "en"
    }
  ],
  "worldviews": [
    {
      "name": "China",
      "code": "china"
    }
  ],
  "places": [
    {
      "name": "Attributed",
      "code": "attributed"
    }
  ],
  "styleFamilies": [
    {
      "name": "ArcGIS",
      "code": "arcgis"
    }
  ],
  "styles": [
    {
      "name": "ArcGIS Human Geography Dark",
      "deprecated": false,
      "complete": true,
      "path": "/styles/arcgis/human-geography-dark",
      "provider": "arcgis",
      "styleFamily": "arcgis",
      "thumbnailUrl": "https://www.arcgis.com/sharing/rest/content/items/ea3befe305494bb5b2acd77e1b3135dc/info/thumbnail/thumbnail1659480292164.png",
      "selfUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark/self",
      "styleUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark{?language}{?worldview}{?places}",
      "rootUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark/base{?language}{?worldview}{?places}",
      "baseUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark/base/self",
      "detailUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark/detail/self",
      "labelsUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/human-geography-dark/labels/self"
    }
  ],
  "selfUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/self",
  "customStylesUrl": "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/items/{item_id}"
}

Describes the list of available webmap endpoints.

Properties

NameTypeRequiredDescription
languages[object]

Supported languages that can be passed to the {?language} parameters.

worldviews[object]

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

places[object]

Supported places values that can be passed to the {?places} parameters.

styleFamilies[object]

A list of the available style families.

styles[WebmapItemSelf]

List of provided styles that can be used.

selfUrlstring

URL that points to self.

customStylesUrlstring

URL that points to the endpoint for custom style webmaps.

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