https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmap/open/dark-gray/labelsReturns the JSON for Open Basemaps Dark Gray Labels as a web map.
The default global place labels are in English. To display place labels in other languages, use the language parameter.
This Open Basemap Dark Gray Canvas Reference map style is symbolized with a dark gray, neutral background style with minimal colors, content, and labels that is designed to draw attention to your thematic content. This comprehensive map layer features map labels and is designed to be used with the Open Basemap Dark Gray Canvas Base layer.
Data providers:
Map data © OpenStreetMap contributors, Microsoft, Esri Community Maps contributors, Map layer by Esri. For more details see Esri and Data Attribution.
Note:
This endpoint does not support worldviews. Making a request to this endpoint with a worldview query parameter will result in a bad request.
Query parameters
| Name | Type | Required | Default value | Description |
|---|---|---|---|---|
language | string | Global | Optional, case-sensitive parameter to specify the preferred language to use for Open Basemap labels. | |
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. |
language
Optional, case-sensitive parameter to specify the preferred language to use for Open Basemap labels.
This query parameter makes use of language codes to specify the preferred language. If not set, the default behavior is to use the Global Language code, which uses the English place names provided by the style.
If an unsupported language code is used, then the service will attempt
to fall-back to the closest available language. This is done by
stripping regional and extension subtags to find a known language code.
For example, American English (en-US) or Canadian French (fr-CA)
will be interpreted as English and French respectively. Should this
fail, then the service will use the default English language (Global).
Note that Open Basemap Styles do not support the local language code.
| Language | Language Code | ISO 639-2:1998 | ISO 639-1 | Notes |
|---|---|---|---|---|
| Global | global | Uses English place names. | ||
| Arabic | ar | ara | Uses the Unicode font. | |
| Bosnian | bs | bos | Uses the Unicode font. | |
| Bulgarian | bg | bul | Uses the Unicode font. | |
| Catalan | ca | cat | ||
| Chinese (Hong Kong) | zh-HK | zh-hk | Uses the Unicode font. | |
| Chinese (Simplified) | zh-CN | zh-cn | Uses the Unicode font. | |
| Chinese (Taiwan) | zh-TW | zh-tw | Uses the Unicode font. | |
| Croatian | hr | hrv | Uses the Unicode font. | |
| Czech | cs | cze | Uses the Unicode font. | |
| Danish | da | dan | ||
| Dutch | nl | dut | Uses the Unicode font. | |
| English | en | eng | ||
| Estonian | et | est | ||
| Finnish | fi | fin | ||
| French | fr | fre | ||
| German | de | ger | ||
| Greek | el | gre | Uses the Unicode font. | |
| Hebrew | he | heb | Uses the Unicode font. | |
| Hungarian | hu | hun | ||
| Indonesian | id | ind | ||
| Italian | it | ita | ||
| Japanese | ja | jpn | Uses the Unicode font. | |
| Korean | ko | kor | Uses the Unicode font. | |
| Latvian | lv | lav | ||
| Lithuanian | lt | lit | ||
| Norwegian | nb or no | nor | ||
| Polish | pl | pol | ||
| Portuguese (Brazil) | pt-BR | pt-br | ||
| Portuguese (Portugal) | pt-PT | pt | ||
| Romanian | ro | rum | Uses the Unicode font. | |
| Russian | ru | rus | Uses the Unicode font. | |
| Serbian | sr | srp | Uses the Unicode font. | |
| Slovak | sk | slk | Uses the Unicode font. | |
| Slovenian | sl | slv | Uses the Unicode font. | |
| Spanish | es | spa | ||
| Swedish | sv | swe | ||
| Thai | th | tha | Uses the Unicode font. | |
| Turkish | tr | tur | ||
| Ukrainian | uk | ukr | Uses the Unicode font. | |
| Vietnamese | vi | vie |
- Default
- Global
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
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/webmap/open/dark-gray/labels \
-H 'Authorization: Bearer <YOUR_TOKEN>'