Skip To Content ArcGIS for Developers Sign In Dashboard

ArcGIS Runtime SDK for Qt

Picture marker symbol

Sample Viewer View Sample on GitHub

Use pictures for markers.

Use case

When marking geoelements on a map, using custom, unique symbols can be helpful for highlighting and differentiating between locations. For example, a tourism office may use pictures of landmarks as symbols on an online map or app, to help prospective visitors to orient themselves more easily around a city.

How to use the sample

When launched, this sample displays a map with three picture marker symbols. Pan and zoom to explore the map.

How it works

  1. Create a PictureMarkerSymbol using the URk to an online or local image.
  2. Create a Graphic and set its symbol to the picture marker symbol.

Relevant API

  • PictureMarkerSymbol

Offline Data

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

Link Local Location
orange_symbol Png File <userhome>/ArcGIS/Runtime/Data/symbol/orange_symbol.png

About the data

The picture marker symbols in this sample are all constructed from different types of resources:

  • Campsite symbol constructed from a URL
  • Blue pin with a star stored in the resource folder that comes with the application
  • Orange pin created from a file path on disk (which is written to disk when the app starts and cleaned up when the app closes).


graphics, marker, picture, symbol, visualization

Sample Code

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

Rectangle {
    clip: true
    width: 800
    height: 600

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

    ViewpointExtent {
        id: startingVP

        extent: Envelope {
            xMin: -229100
            xMax: -223300
            yMin: 6550700
            yMax: 6552100
            spatialReference: SpatialReference { wkid: 3857 }

    // Map view UI presentation at top
    MapView {
        id: mapView
        anchors.fill: parent

        Map {
            BasemapTopographic {}

            initialViewpoint: startingVP

        GraphicsOverlay {

            // create Campsite Symbol from URL
            Graphic {

                Point {
                    x: -228835
                    y: 6550763
                    spatialReference: SpatialReference { wkid: 3857 }

                PictureMarkerSymbol {
                    url: ""
                    width: 38.0
                    height: 38.0

            // create blue symbol from local resource
            Graphic {

                Point {
                    x: -223560
                    y: 6552021
                    spatialReference: SpatialReference { wkid: 3857 }

                PictureMarkerSymbol {
                    url: "qrc:/Samples/DisplayInformation/Picture_Marker_Symbol/blue_symbol.png"
                    width: 80.0
                    height: 80.0

            // create orange symbol from file path
            Graphic {

                Point {
                    x: -226773
                    y: 6550477
                    spatialReference: SpatialReference { wkid: 3857 }

                PictureMarkerSymbol {
                    url: dataPath + "/symbol/orange_symbol.png"
                    width: 64.0
                    height: 64.0