Skip To Content ArcGIS for Developers Sign In Dashboard

ArcGIS Runtime SDK for Qt

Vector tiled layer (URL)

Sample Viewer View Sample on GitHub

Load an ArcGIS Vector Tiled Layer from a URL.

Use case

Vector tile basemaps can be created in ArcGIS Pro and published as offline packages or online services. ArcGISVectorTiledLayer has many advantages over traditional raster based basemaps (ArcGISTiledLayer), including smooth scaling between different screen DPIs, smaller package sizes, and the ability to rotate symbols and labels dynamically.

How to use the sample

Use the drop down menu to load different vector tile basemaps.

How it works

  1. An ArcGISVectorTiledLayer is constructed with an ArcGIS Online service URL
  2. The layer instance is added to the Map

Relevant API

  • ArcGISVectorTiledLayer
  • Basemap


tiles, vector, vector basemap, vector tiled layer, vector tiles

Sample Code

import QtQuick 2.6
import QtQuick.Controls 2.2
import Esri.ArcGISRuntime 100.9

Rectangle {
    width: 800
    height: 600
    //! [display vector tiled layer]
    // Create MapView that contains a Map
    MapView {
        id: mapview
        anchors.fill: parent
        Map {
            id: map
            Basemap {
                // Nest an ArcGISVectorTiledLayer Layer in the Basemap
                ArcGISVectorTiledLayer {
                    url: ""
            initialViewpoint: ViewpointCenter {
                center: Point { x:-80.18; y: 25.778135; spatialReference: SpatialReference { wkid: 4326 } }
                targetScale: 150000
    //! [display vector tiled layer]

    ComboBox {
        id: comboBoxBasemap
        anchors {
            left: parent.left
            margins: 15
        property int modelWidth: 0
        width: modelWidth + leftPadding + rightPadding + indicator.width
        model: ["Mid-Century","Colored Pencil","Newspaper","Nova", "World Street Map (Night)"]
        onCurrentTextChanged: {
            // Call this JavaScript function when the current selection changes
            if (map.loadStatus === Enums.LoadStatusLoaded)

        Component.onCompleted : {
            for (let i = 0; i < model.length; ++i) {
                metrics.text = model[i];
                modelWidth = Math.max(modelWidth, metrics.width);

        TextMetrics {
            id: metrics
            font: comboBoxBasemap.font

        function changeBasemap() {
            // Determine the selected basemap, create that type, and set the Map's basemap
            let layer;
            switch (comboBoxBasemap.currentText) {
            case "Mid-Century":
                layer = ArcGISRuntimeEnvironment.createObject("ArcGISVectorTiledLayer", {url:""});
            case "Colored Pencil":
                layer = ArcGISRuntimeEnvironment.createObject("ArcGISVectorTiledLayer", {url:""});
            case "Newspaper":
                layer = ArcGISRuntimeEnvironment.createObject("ArcGISVectorTiledLayer", {url:""});
            case "Nova":
                layer = ArcGISRuntimeEnvironment.createObject("ArcGISVectorTiledLayer", {url:""});
            case "World Street Map (Night)":
                layer = ArcGISRuntimeEnvironment.createObject("ArcGISVectorTiledLayer", {url:""});
            const newBasemap = ArcGISRuntimeEnvironment.createObject("Basemap");
            map.basemap = newBasemap;