require(["esri/dijit/BasemapLayer"], function(BasemapLayer) { /* code goes here */ });Description
(Added at v2.1)
Defines a layer that will be added to a basemap and displayed in the
BasemapGallery
dijit.
SamplesSearch for
samplesthat use this class.
Constructors CSSesri/dijit/BasemapLayer | Download source
Properties copyrightString
The attribution information for the layer. fullExtent Extent
The full extent of the layer. initialExtent Extent
The initial extent of the layer. styleUrl String
A url to a JSON file containing the stylesheet information to render the VectorTileLayer. subDomains String[]
The subDomains where tiles are served to speed up tile retrieval (using subDomains gets around the browser limit of the max number of concurrent requests to a domain). tileInfo TileInfo
The tile info for the layer including lods, rows, cols, origin and spatial reference. tileServers String[]
Additional tile server domains for the layer. type String
The type of layer.
Constructor Details
Creates a new BasemapLayer object.
Parameters: <Object
> params Required Set of parameters used to create a basemap layer. See the list below for details. params
properties: <Number[]
> bandIds Optional If the url points to an image service, you can specify which band ids will display. If not set, the first three available band ids will display. <String
> copyright Optional The attribution information for the layer. NOTE: This property is only applicable to layers of type WebTiledLayer. <Number[]
> displayLevels Optional If the url points to a cached map service you can specify the levels to draw. If not set, all display levels the service supports are drawn. <Extent
> fullExtent Optional Specify the full extent of the layer. If no value is specified the default value, world extent in Web Mercator, is used. NOTE: This property is only applicable to layers of type WebTiledLayer. <Extent
> initialExtent Optional Specify the initial extent of the layer. If no value is specified the default value, world extent in Web Mercator, is used. NOTE: This property is only applicable to layers of type WebTiledLayer. <Boolean
> isReference Optional Set to true if the layer is a reference layer and should be drawn on top of all other layers in the map. <Number
> opacity Optional Initial opacity or transparency of the basemap layer. Values range from 0.0 to 1.0 where 0.0 is 100% transparent and 1.0 has no transparency. The default value is 1.0. <String
> styleUrl Optional A url to a JSON file containing the stylesheet information to render the VectorTileLayer. <String[]
> subDomains Optional Specify subDomains where tiles are served to speed up tile retrieval (using subDomains gets around the browser limit of the max number of concurrent requests to a domain). If subDomains are specified, the urlTemplate should include a ${subDomain} place holder. NOTE: This property is only applicable to layers of type WebTiledLayer. <String
> templateUrl Optional The URL template used to retrieve the tiles. The templateUrl
follows a pattern of http://some.domain.com/${Z}/${X}/${Y}/
where Z corresponds to a zoom level, and X and Y represent tile column and row, respectively. Required if the BasemapLayer is a WebTiledLayer. <TileInfo
> tileInfo Optional Define the tile info for the layer including lods, rows, cols, origin and spatial reference. NOTE: This property is only applicable to layers of type WebTiledLayer. <String[]
> tileServers Optional Define additional tile server domains for the layer. NOTE: This property is only applicable to layers of type WebTiledLayer. <String
> type Optional The type of layer. Valid values are "BingMapsAerial", "BingMapsHybrid", "BingMapsRoad", "OpenStreetMap", "VectorTileLayer" or "WebTiledLayer". For Bing and OpenStreetMap basemaps specify type property. For WebTiledLayer basemap both url and type are required. For VectorTileLayer both styleUrl and type are required. <String
> url Optional URL to the ArcGIS Server REST resource that represents a map or image service. Must specify either the url or type parameter. <Number[]
> visibleLayers Optional If the url points to a dynamic map service you can specify a subset of layers to display. If not set, all visible layers are displayed. Sample:
require([ "esri/dijit/BasemapLayer", ... ], function(BasemapLayer, ... ) { var publicSafetyLayer = new BasemapLayer({ url: "https://www.example.com/argis/rest/services/PublicSafety/PublicSafetyBasemap/MapServer" }); // add vector tile layer as a basemap layer var vtlayer = new BasemapLayer({ styleUrl: "https://www.arcgis.com/sharing/rest/content/items/5ad3948260a147a993ef4865e3fad476/resources/styles/root.json", type: "VectorTileLayer" }); });
Property Details
The attribution information for the layer. NOTE: This property is only applicable to layers of type WebTiledLayer. (Added at v3.7)
The full extent of the layer. If no value is specified the default value, world extent in Web Mercator, is used. NOTE: This property is only applicable to layers of type WebTiledLayer. (Added at v3.7)
The initial extent of the layer. If no value is specified the default value, world extent in Web Mercator, is used. NOTE: This property is only applicable to layers of type WebTiledLayer. (Added at v3.7)
A url to a JSON file containing the stylesheet information to render the VectorTileLayer. (Added at v3.15)
Sample:var vtlayer = new BasemapLayer({ styleUrl: "https://www.arcgis.com/sharing/rest/content/items/5ad3948260a147a993ef4865e3fad476/resources/styles/root.json", type: "VectorTileLayer" });
The subDomains where tiles are served to speed up tile retrieval (using subDomains gets around the browser limit of the max number of concurrent requests to a domain). NOTE: This property is only applicable to layers of type WebTiledLayer. (Added at v3.7)
The tile info for the layer including lods, rows, cols, origin and spatial reference. NOTE: This property is only applicable to layers of type WebTiledLayer. (Added at v3.7)
Additional tile server domains for the layer. NOTE: This property is only applicable to layers of type WebTiledLayer. (Added at v3.7)
The type of layer. For Bing and OpenStreetMap basemaps specify type property. For WebTiledLayer basemap both url and type are required. For VectorTileLayer both styleUrl and type are required. (Added at v3.7)
Known values: "BingMapsAerial" | "BingMapsHybrid" | "BingMapsRoad" | "OpenStreetMap" | "WebTiledLayer" | "VectorTileLayer"
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