XYZ
- Last UpdatedMar 04, 2025
- 1 minute read
XYZ Tiles is a method of expressing map tile mosaics, indexed by (x,y) offsets and zoom levels (z). This format is widely used and can be applied to access layers from various sources.
For example:
|
Source |
URL Template |
|---|---|
|
Esri Satellite |
https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x} |
|
Esri World Topo |
https://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer/tile/{z}/{y}/{x} |
|
CartoDB |
https://cartodb-basemaps-a.global.ssl.fastly.net/light_all/{z}/{x}/{y}.png |
|
Open Street Map |
|
|
OSM Cycle Map |
|
|
Wikimedia |
There are multiple providers supporting this type of layers, one of which is ArcGIS basemap layer services. An API key (access token) is required to use these services. For more information about obtaining an API key, see the Esri site: https://developers.arcgis.com/documentation/mapping-apis-and-services/security/api-keys/.
If you are using a third-party URL (mapbox, maptile, etc.,), ensure your usage is in compliance the provider's terms of use.
The following table provides the specific configurable options available for this layer:
|
Property |
Type |
Description |
|---|---|---|
|
type |
xyz |
A type of Layer. |
|
url |
String |
Defines URL template. It Must include {x}, {y} or {-y}, and {z} placeholders. A {?-?} template pattern, for example subdomain{a-f}.domain.com, may be used. |
Example of XYZ
Below is an example of an XYZ ArcGIS layer URL:
-
Configuration and map preview
-
JSON string configuration
{
"title": "XYZ",
"type": "xyz",
"url": "https://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer/tile/{z}/{y}/{x}&token={ACCESS_TOKEN}",
"isBaseMap": true
}