OSM Light Gray as a style.
Returns the JSON for OSM Light Gray as a style.
Place labels are, by default, localized. To display place labels in other languages, use the language parameter.
OpenStreetMap (OSM) is a collaborative project to create a free editable map of the world. This vector basemap is based on the Daylight map distribution of OSM data and is hosted by Esri. It provides a detailed base layer for the world featuring a light neutral style with minimal colors.
For more information about the style, data providers, attribution, and terms of use, go to the item page in ArcGIS.
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 |
|---|---|---|---|---|
| | Optional, case-sensitive parameter to specify the preferred language to use for OSM basemap labels. | ||
| | The authentication token, used to access the Basemap styles service. | ||
| | Optional, case-sensitive parameter to specify the format in which responses are given. Can either be json or pjson. |
language
Optional, case-sensitive parameter to specify the preferred language to use for OSM 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 Local Language code, which uses the default 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-) or Canadian French (fr-)
will be interpreted as English and French respectively. Should this
fail, then the service will use the default label language (Local).
| Language | Language Code | ISO 639-2:1998 | ISO 639-1 | Notes |
|---|---|---|---|---|
| Global | global | Uses English place names. | ||
| Local | local | Uses the default 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 | 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
- local
Enumerated values
token
The authentication token, used to access the Basemap styles service.
The token parameter can be either an API Key or short-lived token.
Alternatively, you can supply a 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 >
The provided token must have the necessary premium privilege to use the basemap style service.
Developer guide: To learn more, go to Security and authentication.
f
Optional, case-sensitive parameter to specify the format in which responses are given. Can either be json or pjson.
- Default
- json
Enumerated values
Examples
Request
# You can also use wget
curl -X GET https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/osm/light-gray \
-H 'Accept: application/json'Response
200 Response
{}| Status | Meaning | Description | Schema |
|---|---|---|---|
| A successful response to a style request. | ||
| Invalid query parameters / Incorrect portal item type. | ||
| Authentication Error. The API key or token is missing, invalid or expired. | ||
| The requested resource cannot be accesed because of incorrent sharing permissions. | ||
| Unknown | An error occurred on the server. |