Version: 1.6.3.X

Supported Basemaps

Maptaskr Power Maps supports various layer types for flexible and efficient data visualization. Compatible layers include standard geographic data formats, such as raster, imagery and vector layers. Users can also add custom layers for specific Dataverse datasets, such as accounts or work orders, to suit different needs.

This guide will go through all supported layers and various examples of implementations as well as supported functionality for each one.

Basemap Type	Description
MapLibre Style Basemap	A vector or raster basemap rendered from a MapLibre-compatible style JSON.
Raster Tile Basemap (XYZ/Slippy)	A raster tile basemap using the XYZ/Slippy tiling scheme.
ArcGIS Tiled Map Service Basemap	A cached raster basemap sourced from an ArcGIS MapServer tile service.
ArcGIS Map Service Basemap	A raster basemap rendered on demand by an ArcGIS MapServer service.
OGC WMS Service Basemap	A raster basemap generated by an OGC Web Map Service.
OGC WMTS Service Basemap	A cached raster basemap served as OGC Web Map Tile Service tiles.

MapLibre Style Basemap

Required Endpoints

You must provide a URL to a MapLibre-compatible style JSON. This JSON defines the vector tile source(s), layers, fonts, and sprites. MapLibre style JSON layers are very similar to Mapbox Style JSON and ArcGIS Vector Tile format layers.

Find out more from the following resources:

Example:

Type	Example
URL	`https://api.maptiler.com/maps/streets/style.json`

Required Response

Details

{
    "currentVersion": 10.81,
    "name": "{Layer Name}",
    "copyrightText": "{Copyright text}",
    "capabilities": "TilesOnly,Tilemap",
    "type": "indexedVector",
    "tileMap": "tilemap",
    "defaultStyles": "resources/styles",
    "tiles": [
        "tile/{z}/{y}/{x}.pbf"
    ],
    "exportTilesAllowed": true,
    "initialExtent": {
        "xmin": -20037507.0671618,
        "ymin": -20037507.0671618,
        "xmax": 20037507.0671618,
        "ymax": 20037507.0671618,
        "spatialReference": {
            "wkid": 102100,
            "latestWkid": 3857
        }
    },
    "fullExtent": {
        "xmin": -20037507.0671618,
        "ymin": -20037507.0671618,
        "xmax": 20037507.0671618,
        "ymax": 20037507.0671618,
        "spatialReference": {
            "wkid": 102100,
            "latestWkid": 3857
        }
    },
    "minScale": 0,
    "maxScale": 0,
    "tileInfo": {
        "rows": 512,
        "cols": 512,
        "dpi": 96,
        "format": "pbf",
        "origin": {
            "x": -20037508.342787,
            "y": 20037508.342787
        },
        "spatialReference": {
            "wkid": 102100,
            "latestWkid": 3857
        },
        "lods": [
            {
                "level": 0,
                "resolution": 78271.516964,
                "scale": 295828763.7957775
            },
            {
                "level": 1,
                "resolution": 39135.75848199995,
                "scale": 147914381.8978885
            },
            {
                "level": 2,
                "resolution": 19567.87924100005,
                "scale": 73957190.9489445
            },
            {
                "level": 3,
                "resolution": 9783.93962049995,
                "scale": 36978595.474472
            },
            {
                "level": 4,
                "resolution": 4891.96981024998,
                "scale": 18489297.737236
            },
            {
                "level": 5,
                "resolution": 2445.98490512499,
                "scale": 9244648.868618
            },
            {
                "level": 6,
                "resolution": 1222.992452562495,
                "scale": 4622324.434309
            },
            {
                "level": 7,
                "resolution": 611.496226281245,
                "scale": 2311162.2171545
            },
            {
                "level": 8,
                "resolution": 305.74811314069,
                "scale": 1155581.1085775
            },
            {
                "level": 9,
                "resolution": 152.874056570279,
                "scale": 577790.5542885
            },
            {
                "level": 10,
                "resolution": 76.4370282852055,
                "scale": 288895.2771445
            },
            {
                "level": 11,
                "resolution": 38.2185141425366,
                "scale": 144447.638572
            },
            {
                "level": 12,
                "resolution": 19.1092570712683,
                "scale": 72223.819286
            },
            {
                "level": 13,
                "resolution": 9.55462853563415,
                "scale": 36111.909643
            },
            {
                "level": 14,
                "resolution": 4.777314267817075,
                "scale": 18055.9548215
            },
            {
                "level": 15,
                "resolution": 2.388657133974685,
                "scale": 9027.977411
            },
            {
                "level": 16,
                "resolution": 1.19432856698734,
                "scale": 4513.9887055
            },
            {
                "level": 17,
                "resolution": 0.597164283427525,
                "scale": 2256.9943525
            },
            {
                "level": 18,
                "resolution": 0.2985821417799085,
                "scale": 1128.4971765
            },
            {
                "level": 19,
                "resolution": 0.1492910708238085,
                "scale": 564.248588
            },
            {
                "level": 20,
                "resolution": 0.07464553541190416,
                "scale": 282.124294
            },
            {
                "level": 21,
                "resolution": 0.03732276770595208,
                "scale": 141.062147
            },
            {
                "level": 22,
                "resolution": 0.01866138385297604,
                "scale": 70.5310735
            }
        ]
    },
    "maxzoom": 22,
    "minLOD": 0,
    "maxLOD": 16,
    "resourceInfo": {
        "styleVersion": 8,
        "tileCompression": "gzip",
        "cacheInfo": {
            "storageInfo": {
                "packetSize": 128,
                "storageFormat": "compactV2"
            }
        }
    },
    "serviceItemId": "{serviceItemId}",
    "maxExportTilesCount": 10000
}

Raster Tile Basemap (XYZ/Slippy)

Required Endpoints

Slippy maps use a URL template to retrieve tiles based on the zoom level and x/y tile coordinates:

Type	Example
Main URL	`https://{domain}/{z}/{x}/{y}`

Where:

{z} = zoom level

{x} = tile column

{y} = tile row

{domain} = url to load the tiles from

The URL must include all three {z}, {x}, and {y} placeholders. Power Maps replaces them with the requested tile coordinates and expects an image response.

Required Response

Details

{
 "currentVersion": 11.3,
 "cimVersion": "3.3.0",
 "serviceDescription": "<div style='text-align:Left;font-size:12pt'><p><span>World Imagery provides one meter or better satellite and aerial imagery in many parts of the world and lower resolution satellite imagery worldwide. The map includes 15m TerraColor imagery at small and mid-scales (~1:591M down to ~1:288k) for the world. The map features Maxar imagery at 0.3m resolution for select metropolitan areas around the world, 0.5m resolution across the United States and parts of Western Europe, and 1m resolution imagery across the rest of the world. In addition to commercial sources, the World Imagery map features high-resolution aerial photography contributed by the GIS User Community. This imagery ranges from 0.3m to 0.03m resolution (down to ~1:280 in select communities). For more information on this map, including the terms of use, visit us online at https://goto.arcgisonline.com/maps/World_Imagery<\/span><\/p><\/div>",
 "mapName": "Layers",
 "description": "<DIV STYLE=\"text-align:Left;font-size:12pt\"><P><SPAN>World Imagery provides one meter or better satellite and aerial imagery in many parts of the world and lower resolution satellite imagery worldwide. The map includes 15m TerraColor imagery at small and mid-scales (~1:591M down to ~1:288k) for the world. The map features Maxar imagery at 0.3m resolution for select metropolitan areas around the world, 0.5m resolution across the United States and parts of Western Europe, and 1m resolution imagery across the rest of the world. In addition to commercial sources, the World Imagery map features high-resolution aerial photography contributed by the GIS User Community. This imagery ranges from 0.3m to 0.03m resolution (down to ~1:280 in select communities). For more information on this map, including the terms of use, visit us online at https://goto.arcgisonline.com/maps/World_Imagery<\/SPAN><\/P><\/DIV>",
 "copyrightText": "Source: Esri, Maxar, Earthstar Geographics, and the GIS User Community",
 "supportsDynamicLayers": false,
 "layers": [
  {
   "id": 0,
   "name": "{{Layer Name}}",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 0,
   "maxScale": 0,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 1,
   "name": "Low Resolution 15m Imagery",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 0,
   "maxScale": 0,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 2,
   "name": "High Resolution 60cm Imagery",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 0,
   "maxScale": 0,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 3,
   "name": "High Resolution 30cm Imagery",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 0,
   "maxScale": 0,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 4,
   "name": "Citations",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 0,
   "maxScale": 0,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 5,
   "name": "1.9cm Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 106,
   "maxScale": 0,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 6,
   "name": "3.7cm Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 212,
   "maxScale": 106,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 7,
   "name": "7.5cm Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 425,
   "maxScale": 212,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 8,
   "name": "15cm Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 850,
   "maxScale": 425,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 9,
   "name": "30cm Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 1700,
   "maxScale": 850,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 10,
   "name": "60cm Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 3400,
   "maxScale": 1700,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 11,
   "name": "1.2m Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 6800,
   "maxScale": 3400,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 12,
   "name": "2.4m Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 13500,
   "maxScale": 6800,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 13,
   "name": "4.8m Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 27000,
   "maxScale": 13500,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 14,
   "name": "9.6m Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 54000,
   "maxScale": 27000,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 15,
   "name": "19m Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 108000,
   "maxScale": 54000,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 16,
   "name": "38m Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 216000,
   "maxScale": 108000,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 17,
   "name": "75m Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 432000,
   "maxScale": 216000,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  },
  {
   "id": 18,
   "name": "150m Resolution Metadata",
   "parentLayerId": -1,
   "defaultVisibility": true,
   "subLayerIds": null,
   "minScale": 0,
   "maxScale": 432000,
   "type": "Feature Layer",
   "geometryType": "esriGeometryPolygon",
   "supportsDynamicLegends": true
  }
 ],
 "tables": [],
 "spatialReference": {
  "wkid": 102100,
  "latestWkid": 3857,
  "xyTolerance": 0.001,
  "zTolerance": 0.001,
  "mTolerance": 0.001,
  "falseX": -20037700,
  "falseY": -30241100,
  "xyUnits": 10000,
  "falseZ": -100000,
  "zUnits": 10000,
  "falseM": -100000,
  "mUnits": 10000
 },
 "singleFusedMapCache": true,
 "tileInfo": {
  "rows": 256,
  "cols": 256,
  "dpi": 96,
  "format": "JPEG",
  "compressionQuality": 90,
  "origin": {
   "x": -2.0037508342787E7,
   "y": 2.0037508342787E7
  },
  "spatialReference": {
   "wkid": 102100,
   "latestWkid": 3857,
   "xyTolerance": 0.001,
   "zTolerance": 0.001,
   "mTolerance": 0.001,
   "falseX": -2.2041259214859996E7,
   "falseY": -3.2754895973320004E7,
   "xyUnits": 1.4298050400783738E8,
   "falseZ": -100000,
   "zUnits": 10000,
   "falseM": -100000,
   "mUnits": 10000
  },
  "lods": [
   {
    "level": 0,
    "resolution": 156543.03392800014,
    "scale": 5.91657527591555E8
   },
   {
    "level": 1,
    "resolution": 78271.51696399994,
    "scale": 2.95828763795777E8
   },
   {
    "level": 2,
    "resolution": 39135.75848200009,
    "scale": 1.47914381897889E8
   },
   {
    "level": 3,
    "resolution": 19567.87924099992,
    "scale": 7.3957190948944E7
   },
   {
    "level": 4,
    "resolution": 9783.93962049996,
    "scale": 3.6978595474472E7
   },
   {
    "level": 5,
    "resolution": 4891.96981024998,
    "scale": 1.8489297737236E7
   },
   {
    "level": 6,
    "resolution": 2445.98490512499,
    "scale": 9244648.868618
   },
   {
    "level": 7,
    "resolution": 1222.992452562495,
    "scale": 4622324.434309
   },
   {
    "level": 8,
    "resolution": 611.4962262813797,
    "scale": 2311162.217155
   },
   {
    "level": 9,
    "resolution": 305.74811314055756,
    "scale": 1155581.108577
   },
   {
    "level": 10,
    "resolution": 152.87405657041106,
    "scale": 577790.554289
   },
   {
    "level": 11,
    "resolution": 76.43702828507324,
    "scale": 288895.277144
   },
   {
    "level": 12,
    "resolution": 38.21851414253662,
    "scale": 144447.638572
   },
   {
    "level": 13,
    "resolution": 19.10925707126831,
    "scale": 72223.819286
   },
   {
    "level": 14,
    "resolution": 9.554628535634155,
    "scale": 36111.909643
   },
   {
    "level": 15,
    "resolution": 4.77731426794937,
    "scale": 18055.954822
   },
   {
    "level": 16,
    "resolution": 2.388657133974685,
    "scale": 9027.977411
   },
   {
    "level": 17,
    "resolution": 1.1943285668550503,
    "scale": 4513.988705
   },
   {
    "level": 18,
    "resolution": 0.5971642835598172,
    "scale": 2256.994353
   },
   {
    "level": 19,
    "resolution": 0.29858214164761665,
    "scale": 1128.497176
   },
   {
    "level": 20,
    "resolution": 0.14929107082380833,
    "scale": 564.248588
   },
   {
    "level": 21,
    "resolution": 0.07464553541190416,
    "scale": 282.124294
   },
   {
    "level": 22,
    "resolution": 0.03732276770595208,
    "scale": 141.062147
   },
   {
    "level": 23,
    "resolution": 0.01866138385297604,
    "scale": 70.5310735
   }
  ]
 },
 "storageInfo": {
  "storageFormat": "esriMapCacheStorageModeCompactV2",
  "packetSize": 128
 },
 "initialExtent": {
  "xmin": -2.2815791376046296E7,
  "ymin": -2.199198808761979E7,
  "xmax": 2.2815791376046296E7,
  "ymax": 2.2036142269084483E7,
  "spatialReference": {
   "cs": "pcs",
   "wkid": 102100
  }
 },
 "fullExtent": {
  "xmin": -2.003750722959434E7,
  "ymin": -1.997186888040859E7,
  "xmax": 2.003750722959434E7,
  "ymax": 1.9971868880408563E7,
  "spatialReference": {
   "cs": "pcs",
   "wkid": 102100
  }
 },
 "datesInUnknownTimezone": false,
 "minScale": 0,
 "maxScale": 0,
 "units": "esriMeters",
 "supportedImageFormatTypes": "PNG32,PNG24,PNG,JPG,DIB,TIFF,EMF,PS,PDF,GIF,SVG,SVGZ,BMP",
 "documentInfo": {
  "Title": "Layers",
  "Author": "",
  "Comments": "<DIV STYLE=\"text-align:Left;font-size:12pt\"><P><SPAN>World Imagery provides one meter or better satellite and aerial imagery in many parts of the world and lower resolution satellite imagery worldwide. The map includes 15m TerraColor imagery at small and mid-scales (~1:591M down to ~1:288k) for the world. The map features Maxar imagery at 0.3m resolution for select metropolitan areas around the world, 0.5m resolution across the United States and parts of Western Europe, and 1m resolution imagery across the rest of the world. In addition to commercial sources, the World Imagery map features high-resolution aerial photography contributed by the GIS User Community. This imagery ranges from 0.3m to 0.03m resolution (down to ~1:280 in select communities). For more information on this map, including the terms of use, visit us online at https://goto.arcgisonline.com/maps/World_Imagery<\/SPAN><\/P><\/DIV>",
  "Subject": "imagery, satellite, aerial, 500m (World), 15m (World)",
  "Category": "",
  "Version": "3.1.0",
  "AntialiasingMode": "Fast",
  "TextAntialiasingMode": "Force",
  "Keywords": "World,Global,United States"
 },
 "supportsQueryDomains": true,
 "capabilities": "Map,Query,Data,Tilemap",
 "supportedQueryFormats": "JSON, geoJSON, PBF",
 "exportTilesAllowed": false,
 "referenceScale": 0.0,
 "datumTransformations": [
  {
   "geoTransforms": [
    {
     "wkid": 108001,
     "latestWkid": 1241,
     "transformForward": true,
     "name": "NAD_1927_To_NAD_1983_NADCON"
    }
   ]
  },
  {
   "geoTransforms": [
    {
     "wkid": 108001,
     "latestWkid": 1241,
     "transformForward": false,
     "name": "NAD_1927_To_NAD_1983_NADCON"
    }
   ]
  }
 ],
 "supportsDatumTransformation": true,
 "archivingInfo": {"supportsHistoricMoment": false},
 "supportsClipping": true,
 "supportsSpatialFilter": true,
 "supportsTimeRelation": true,
 "supportsQueryDataElements": true,
 "mapUnits": {"wkid": 9001},
 "maxRecordCount": 100,
 "maxImageHeight": 4096,
 "maxImageWidth": 4096,
 "supportedExtensions": "KmlServer"
}

ArcGIS Tiled Map Service Basemap

An ArcGIS Tiled Map Service Basemap displays a cached ArcGIS MapServer tile service as the map background.

Required Endpoint

Provide an ArcGIS MapServer URL:

https://{server}/arcgis/rest/services/{service}/MapServer

Power Maps resolves this to the MapServer tile endpoint. The service must use Web Mercator (WKID 3857, 102100, or 102113), and return PNG, PNG8, PNG24, PNG32, JPEG, or MIXED tiles.

info

Use an ArcGIS Tiled Map Service Basemap for pre-rendered background mapping. It does not provide feature-level data or interaction. For a full description of the service requirements, see ArcGIS Tiled Map Service Layer.

ArcGIS Map Service Basemap

An ArcGIS Map Service Basemap requests a rendered map image from an ArcGIS MapServer service. Use this type when the service is not a cached tiled MapServer.

Required Endpoint

Provide the root ArcGIS MapServer URL:

https://{server}/arcgis/rest/services/{service}/MapServer

Power Maps reads the service metadata and requests images from its export endpoint. Do not use a layer-specific, export, or query-parameter URL.

Service Requirements

The service metadata must contain one or more layers.
The service must return an image from the export endpoint.
The service extent must use a spatial reference that Power Maps can project to Web Mercator.

OGC WMS Service Basemap

An OGC Web Map Service (WMS) Basemap requests raster map images from a WMS server.

Required Endpoint

Provide the base WMS service endpoint without query parameters. For example:

https://{server}/geoserver/ows

Power Maps adds the service=WMS, request=GetCapabilities, and GetMap parameters. Do not supply a complete GetCapabilities or GetMap URL.

Service Requirements

The GetCapabilities response must contain at least one requestable layer.
The service must support EPSG:3857, EPSG:4326, or CRS:84.
The service must return a PNG image for a GetMap request.

OGC WMTS Service Basemap

An OGC Web Map Tile Service (WMTS) Basemap displays cached raster tiles from a WMTS server.

Required Endpoint

Provide the base WMTS service endpoint without query parameters. For example:

https://{server}/geoserver/gwc/service/wmts

Power Maps adds the service=WMTS, request=GetCapabilities, and GetTile parameters. Do not supply a complete GetCapabilities or GetTile URL.

Service Requirements

The GetCapabilities response must contain at least one layer with an identifier and a style.
The layer must support a GoogleMapsCompatible, EPSG:3857, or WebMercator3857 tile matrix set.
The service must return PNG tiles for GetTile requests.

MapLibre Style Basemap​

Required Endpoints​

Example:​

Required Response​

Raster Tile Basemap (XYZ/Slippy)​

Required Endpoints​

Required Response​

ArcGIS Tiled Map Service Basemap​

Required Endpoint​

ArcGIS Map Service Basemap​

Required Endpoint​

Service Requirements​

OGC WMS Service Basemap​

Required Endpoint​

Service Requirements​

OGC WMTS Service Basemap​

Required Endpoint​

Service Requirements​

MapLibre Style Basemap

Required Endpoints

Example:

Required Response

Raster Tile Basemap (XYZ/Slippy)

Required Endpoints

Required Response

ArcGIS Tiled Map Service Basemap

Required Endpoint

ArcGIS Map Service Basemap

Required Endpoint

Service Requirements

OGC WMS Service Basemap

Required Endpoint

Service Requirements

OGC WMTS Service Basemap

Required Endpoint

Service Requirements