ESM: import BasemapStyle from "@arcgis/core/support/BasemapStyle.js";
CDN: const BasemapStyle = await $arcgis.import("@arcgis/core/support/BasemapStyle.js");
Class: @arcgis/core/support/BasemapStyle
Since: ArcGIS Maps SDK for JavaScript 4.28
The style of the basemap from the basemap styles service (v2). The basemap styles service is a ready-to-use location service that serves vector and image tiles representing geographic features around the world.
You can use the basemap styles service to display:
Use of the basemap style service requires authentication via an API key or user authentication. To learn more about API keys, see the API keys section in the Esri Developer documentation.
Example
const basemap = new Basemap({
style: new BasemapStyle({
id: "arcgis/human-geography",
language: "es" // place labels will be displayed in spanish
})
})
Constructors
new BasemapStyle(properties)
Parameter
optionalSee the properties for a list of all the properties that may be passed into the constructor.
Show inherited properties Hide inherited properties
Property DetailsSince: ArcGIS Maps SDK for JavaScript 4.31 BasemapStyle since 4.28, apiKey added at 4.31.
An authorization string used to access a resource or service. API keys are generated and managed in the portal. An API key is tied explicitly to an ArcGIS account; it is also used to monitor service usage. Setting a fine-grained API key on a specific class overrides the global API key.
Inherited
Property declaredClass Stringreadonly
The name of the class. The declared class name is formatted as esri.folder.className
.
The id of the basemap style. The values are of the form {provider}/{style}
, for example `arcgis/navigation``. See Basemap styles -> Requests for the full list of available styles.
Example
// sets the basemap to the ArcGIS navigation night style
basemap.style = {
id: "arcgis/navigation-night"
}
// sets the basemap to the ArcGIS outdoor style
basemap.style.id = "arcgis/outdoor";
The language of the place labels in the basemap style. Choose from a variety of supported languages, including global
and local
.
If not set, the app's current locale is used. If the app's locale is not supported by the service, the language will fall back to "global"
.
Example
// basemap place labels will in spanish
basemap.style = {
id: "arcgis/outdoor",
language: "es"
}
// basemap style will use the names of places in their local language (e.g. "Lisboa" for Lisbon)
basemap.style.language = "local";
Since: ArcGIS Maps SDK for JavaScript 4.29 BasemapStyle since 4.28, places added at 4.29.
Indicates whether to display places with the basemap style. Only supported with the arcgis/navigation
and arcgis/navigation-night
styles.
Possible Values:"all" |"attributed" |"none"
Example
const basemapWithPlaces = new Basemap({
style: new BasemapStyle({
id: "arcgis/navigation",
places: "all"
})
})
serviceUrl String
The URL to the basemap styles service.
Default Value:"https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2"
Since: ArcGIS Maps SDK for JavaScript 4.29 BasemapStyle since 4.28, worldview added at 4.29.
Displays country boundaries and labels based on a specific view of a country. Choose from a variety of supported worldviews.
Worldviews can only be specified for arcgis
basemap styles. When a specific worldview is chosen, it is possible for some place labels to change language. However, when a specific language is provided, it will take priority over the language changes associated with the worldview.
Example
const moroccoBasemap = new Basemap({
style: new BasemapStyle({
id: "arcgis/streets",
worldview: "morocco",
language: "ar"
})
})
Show inherited methods Hide inherited methods
Method DetailsInherited
Method addHandles(handleOrHandles, groupKey)
Adds one or more handles which are to be tied to the lifecycle of the object. The handles will be removed when the object is destroyed.
// Manually manage handles
const handle = reactiveUtils.when(
() => !view.updating,
() => {
wkidSelect.disabled = false;
},
{ once: true }
);
this.addHandles(handle);
// Destroy the object
this.destroy();
Parameters
Handles marked for removal once the object is destroyed.
groupKey *
optionalKey identifying the group to which the handles should be added. All the handles in the group can later be removed with Accessor.removeHandles(). If no key is provided the handles are added to a default group.
Inherited
Method hasHandles(groupKey){Boolean}
Returns true if a named group of handles exist.
Parameter
groupKey *
optionalA group key.
Returns
Type Description Boolean Returnstrue
if a named group of handles exist.
Example
// Remove a named group of handles if they exist.
if (obj.hasHandles("watch-view-updates")) {
obj.removeHandles("watch-view-updates");
}
Inherited
Method removeHandles(groupKey)
Removes a group of handles owned by the object.
Parameter
groupKey *
optionalA group key or an array or collection of group keys to remove.
Example
obj.removeHandles(); // removes handles from default group
obj.removeHandles("handle-group");
obj.removeHandles("other-handle-group");
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4