ArcGIS Imagery as a web map.
Returns the JSON for ArcGIS Imagery as a web map.
The default global place labels are in English. To display place labels in other languages, use the language
parameter.
This layer presents low-resolution satellite imagery for the world and high-resolution satellite and aerial imagery, typically within 3-5 years of currency, for most of the world.
For more information about the style, data providers, attribution, and terms of use, go to the item page in ArcGIS.
Query parameters
Name | Type | Required | Default value | Description |
---|---|---|---|---|
|
| Optional, case-sensitive parameter to specify the preferred language to use for ArcGIS basemap labels. | ||
|
| Optional, case-sensitive parameter to control the boundary lines and labels displayed with some ArcGIS styles. | ||
|
| 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. | ||
|
| Optional, case-sensitive parameter to control the places returned with the style. |
language
Optional, case-sensitive parameter to specify the preferred language to use for ArcGIS 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, usually English.
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 (Global).
Language | Language Code | ISO 639-2:1998 | ISO 639-1 | Notes |
---|---|---|---|---|
Global | global | Uses global place names. This default option will use the basemap style default, usually English. | ||
Local | local | Uses the local place names. This will use the names of places in their local language - Eg. Lisboa for Lisbon. | ||
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
- global
Enumerated values
worldview
Optional, case-sensitive parameter to control the boundary lines and labels displayed with some ArcGIS styles.
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 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 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
places
Optional, case-sensitive parameter to control the places returned with the style.
If not set, the default behavior is to display no places, places=none
.
Places | Places Code | Notes |
---|---|---|
All | all | Include all places available with the style. |
Attributed | attributed | Include all places that have attributes (esri_place_id, name, category). |
None | none | Remove all places from the style. |
An esri_place_id can be used with the Places service to request additional attributes for a place. To learn how to request attributes, go to /places/{place
.
Developer guide: To learn more about this workflow, go to Places for basemaps. Note: Custom styles can be created from provided styles with places functionality enabled by default by manipulating the JSON in the Vector Tile Style Editor.
- Default
- none
Enumerated values
Examples
Request
# You can also use wget
curl -X GET https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/imagery \
-H 'Accept: application/json'
Response
200 Response
{}
Status | Meaning | Description | Schema |
---|---|---|---|
| A successful response for a webmap 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. |