https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/light-gray/baseReturns the JSON for ArcGIS Light Gray Base as a Mapbox style (version 8).
This (v2) vector tile layer provides a detailed basemap for the world featuring a light neutral background style with minimal colors, labels, and features.
Data providers:
Esri, TomTom, Garmin, FAO, NOAA, USGS, © OpenStreetMap contributors, and the GIS User Community. For more details see Esri and Data Attribution.
Query parameters
| Name | Type | Required | Default value | Description |
|---|---|---|---|---|
worldview | string | | Optional, case-sensitive parameter to control the boundary lines and | |
token | string | | The authentication token, used to access the Basemap styles service. | |
f | string | json | An optional parameter to specify the format in which the response is given. It can either be json or pjson. | |
echoToken | boolean | | An optional parameter to control whether the response includes the token to access style resources. |
worldview
Optional, case-sensitive parameter to control the boundary lines and labels displayed with some ArcGIS styles.
To select a US edition of a basemap style, set the worldview parameter
to unitedStatesOfAmerica.
If the worldview parameter is not set, the style will use the standard
set of boundary lines and labels as defined by the style, rather than
the specific view of a single country.
The worldview parameter allows you to display an edition of basemap
borders and labels based on the specific view of a country. Please note
that it is not that country's international policy outside of their
country.
When a specific worldview is chosen, it is possible for some labels to change language. However, when the language query parameter is used in combination with the worldview selection, the explicitly selected language will take priority over any language changes associated with the worldview.
Enumerated values
token
The authentication token, used to access the Basemap styles service.
The token parameter can be:
- an API key
- a short-lived token
- a session token generated by the
sessions/startendpoint
API keys and short-lived tokens must be created from an account with the
premium:user:basemaps
privilege.
Session tokens must be created from an ArcGIS Location Platform account
with the premium:user:basemaps privilege.
Note that session tokens cannot be used with the sessions/start
endpoint or to fetch custom styles.
Developer guide: To learn more, go to Security and 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>
f
An optional parameter to specify the format in which the response is given. It can either be json or pjson.
- Default
- json
Enumerated values
echoToken
An optional parameter to control whether the response includes the token to access style resources.
If the echoToken parameter is not provided, the basemap styles
response defaults to automatically including the token. If echoToken
is provided with a false value, the response will not include the token.
In this case, the token must be included with all tile and glyph
requests. This approach is more secure.
- Default
- true
Response status
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | A successful response to a style request. | Style |
| 400 | Bad Request | Invalid query parameters / Incorrect portal item type. | Error |
| 401 | Unauthorized | Authentication Error. The API key or token is missing, invalid or expired. | Error |
| 403 | Forbidden | The requested resource cannot be accesed because of incorrent sharing permissions. | Error |
| 5XX | **Server Error** | An error occurred on the server. | Error |
Examples
Request
# You can also use wget
curl -X GET https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/light-gray/base \
-H 'Authorization: Bearer <YOUR_TOKEN>'