Skip To Content ArcGIS for Developers Sign In Dashboard

ArcGIS Runtime SDK for Qt

ArcGIS tiled layer (tile cache)

Sample Viewer View Sample on GitHub

Load an offline copy of a tiled map service as a basemap.

Use case

Creating an ArcGISTiledLayer from a local tile package (.tpk & .tpkx) allows you to use that basemap tiled service when the application is offline. Dividing a raster into tiles allows the map to provide relevant tiles and level of detail to the user when panning and zooming. For example, when working in an environment that has no connectivity, this could provide access to a map for navigating your surroundings.

How to use the sample

Launch the app to view the "San Francisco offline tile package" as the basemap.

How it works

  1. Create a TileCache, specifying the path to the local tile package.
  2. Create an ArcGISTiledLayer with the tile cache.
  3. Create a Basemap with the tiled layer.
  4. Create a Map with the basemap and set it to a MapView.

Relevant API

  • ArcGISTiledLayer
  • Basemap
  • Map
  • TileCache

Offline data

Read more about how to set up the sample's offline data here.

Link Local Location
San Francisco Streets TPK <userhome>/ArcGIS/Runtime/Data/tpk/SanFrancisco.tpk

About the data

The map opens to a view of the city of San Francisco, CA. In a disconnected environment, this basemap tile service would be fully accessible to zoom and pan as if you were connected to a online service.

Additional information

ArcGISTiledLayer and TileCache supports both .tpk and .tpkx file formats.


cache, layers, offline, tile

Sample Code

import QtQuick 2.6
import Esri.ArcGISRuntime 100.9
import Esri.ArcGISExtras 1.1

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

    readonly property url dataPath: System.userHomePath + "/ArcGIS/Runtime/Data/tpk/"

    MapView {
        id: mapView
        anchors.fill: parent

        Map {
            minScale: 110000
            Basemap {
                ArcGISTiledLayer {
                    tileCache: TileCache {
                        path: dataPath + "SanFrancisco.tpk"