Skip To Content ArcGIS for Developers Sign In Dashboard

ArcGIS Runtime SDK for Qt

Web tiled layer

Sample Viewer View Sample on GitHub

Display a tiled web layer.

Use case

Tiled map services are a set of pre-generated images (e.g. "tiles") arranged in folders for each row, column, and zoom level. As you navigate the map, map tiles are requested for the current extent. ArcGISTiledLayer and WMTSLayer are types of tiled map services used for specific data types. WebTiledLayer is useful for displaying other data sources that contain tiles arranged in a row/column/level directory structure, such as OpenStreetMap.

How to use the sample

Run the sample and a map will appear. As you navigate the map, map tiles will be fetched automatically and displayed on the map.

How it works

Web tiled services use a uniform addressing scheme with pre-rendered tiles. Image tiles are accessed via a URL template string, with parameters for subdomain, level, column, and row.

  • Subdomain is optional and allows Runtime to balance requests among multiple servers for enhanced performance.
  • Level, row, and column select the tiles to load based on the visible extent of the map.

To display the web tiled layer, this sample:

  1. Creates a WebTiledLayer from a URL and a list of subdomains.
  2. Creates a new Basemap from the layer.
  3. Updates the attribution on the layer. Note: this is a necessary step because web tiled services don't have associated service metadata.
  4. Displays the basemap.

For more information about web tiled layers, see the following resources:

Relevant API

  • Basemap
  • WebTiledLayer

About the data

The basemap in this sample is provided by Stamen Design. Stamen publishes tiled services based on OpenStreetMap data with several unique styles applied.


layer, OGC, Open Street Map, OpenStreetMap,, tiled, tiles

Sample Code

import QtQuick 2.6
import Esri.ArcGISRuntime 100.9

Rectangle {
    id: rootRectangle
    clip: true
    width: 800
    height: 600

    // Map view UI presentation at top
    MapView {
        id: mapView

        anchors.fill: parent

        Map {
            Basemap {
                // Create a WebTiledLayer with a template URL, sub domains, and copyright information
                WebTiledLayer {
                    templateUrl: "https://stamen-tiles-{subDomain}{level}/{col}/{row}.png"
                    subDomains: ["a", "b", "c", "d"]
                    attribution: "Map tiles by <a href=\"\">Stamen Design</a>, " +
                                 "under <a href=\"\">CC BY 3.0</a>. " +
                                 "Data by <a href=\"\">OpenStreetMap</a>, " +
                                 "under <a href=\"\">ODbL</a>."

            // Set initial viewpoint
            ViewpointCenter {
                Point {
                    x: -13167861
                    y: 4382202
                    spatialReference: SpatialReference { wkid: 3857 }
                targetScale: 50000