Maps (2D)

Create and display a map

You can display a basic map by creating one with a basemap layer, setting its initial extent, and adding it to a map view. To learn how to add additional data, see the Layers topic.

Steps

1. Create a new Map , passing a BasemapStyle into the constructor.

   More info

   This code is created by Qt Creator when you create the project and select the Qt Quick C++ app template. You select the basemap style in the dropdown menu.

   Use dark colors for code blocksCopy

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   Display_a_map::Display_a_map(QObject* parent /* = nullptr */):
       QObject(parent),
       m_map(new Map(BasemapStyle::ArcGISTopographic, this))
   

2. Optionally, add one or more data layers to the map.

3. Assign the map to a MapView to render the map.

4. Set the map view Viewpoint to focus on a specified area of the map.

   Expand

   Use dark colors for code blocksCopy

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   void Display_a_map::setupMap()
   {
       const Point center(-118.805, 34.027, SpatialReference::wgs84());
       const Viewpoint viewpoint(center, 72223.819286);
       m_mapView->setViewpoint(viewpoint);
   }
   
   // Set the view. The setMapView function is created by Qt Creator when you
   // create the project and select the Qt Quick C++ app template.
   void Display_a_map::setMapView(MapQuickView* mapView)
   {
       if (!mapView || mapView == m_mapView)
       {
           return;
       }
   
       m_mapView = mapView;
       m_mapView->setMap(m_map);
       setupMap();
       emit mapViewChanged();
   }

You can also create and save a web map using ArcGIS Pro or the ArcGIS Online map viewer and open it in your ArcGIS Runtime app.

Display a web map

You can open a web map saved as an item in a portal, such as ArcGIS Online, using its item ID or URL. A portal item can be secured to only allow access for authorized users, in which case you must provide credentials for access. To learn how to access secured content, see Security and authentication.

Steps

1. Create a QString and set it to the item ID for the item that stores the web map.

2. Create a QUrl that appends the item ID to the ArcGIS Online base URL.

3. Create a new map, passing the QUrl to the constructor.

4. Set the map to a MapView to render the map.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
  const QUrl portal_url("https://www.arcgis.com/home/item.html?id=41281c51f9de45edaf1c8ed44bb10e30");
  m_map = new Map(portal_url, this);

  m_mapView->setMap(m_map);

Display a mobile map

This example displays a map from a mobile map package. You can create your own mobile map (or scene) packages using ArcGIS Pro, or download existing packages from ArcGIS Online. The Mahou Riviera Trails mobile map package, for example, shows points of interest in Mahou Riviera.

Steps

1. Create a MobileMapPackage using the path to a local .mmpk file.

2. Use connect to signal when the package is done loading.

3. Load the mobile map package.

4. After the package loads, get the first map from the package using the MobileMapPackage::maps() property.

5. Display the map in a MapView .

   Expand

   Use dark colors for code blocksCopy

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
       MobileMapPackage* m_mobileMapPackage = new MobileMapPackage(QDir::homePath() + "/ArcGIS/Runtime/Data/mmpk/MahouRivieraTrails.mmpk", this);
       connect(m_mobileMapPackage, &MobileMapPackage::doneLoading, this, [this](Error)
       {
           m_mapView->setMap(m_mobileMapPackage->maps().at(0));
       });
   	m_mobileMapPackage->load();
   

   Expand