Skip To Content ArcGIS for Developers Sign In Dashboard

ArcGIS Runtime SDK for Qt

Set initial map area

Sample Viewer View Sample on GitHub

Display a map with a predefined initial extent.

Use case

You can set a map's initial location when you want to highlight a particular feature or area to establish the context.

How to use the sample

When the map loads, note the specific location of the initial map view.

How it works

  1. Create a Envelope(xMin, yMin, xMax, yMax, SpatialReference).
  2. Create a ViewpointExtent containing the envelope.
  3. Set the initial viewpoint of the map to the viewpoint extent.

Relevant API

  • Basemap
  • Map
  • MapView

About the data

The map opens with satellite imagery of a guitar-shaped field in the Pampas region of north central Argentina.


basemap, center, envelope, extent, initial, lat, latitude, level of detail, location, LOD, long, longitude, scale, zoom level

Sample Code

import QtQuick 2.6
import Esri.ArcGISRuntime 100.9

Rectangle {
    width: 800
    height: 600

    // Create MapView that contains a Map with the Imagery Basemap
    MapView {
        id: mapView
        anchors.fill: parent
        Map {
            BasemapImagery {}
            initialViewpoint: viewpoint

    // Create the intial Viewpoint
    ViewpointExtent {
        id: viewpoint
        extent: Envelope {
            xMin: -12211308.778729
            yMin: 4645116.003309
            xMax: -12208257.879667
            yMax: 4650542.535773
            spatialReference: SpatialReference { wkid: 102100 }