Open map (URL)

View on GitHubSample viewer app

Display a web map.

screenshot

Use case

For displaying web maps stored on ArcGIS Online (e.g. terrestrial ecosystems, as demonstrated in this sample).

How to use the sample

A web map can be selected from the list. On selection the web map displays in the map view.

How it works

  1. Create a URL comprised of the Organization's Portal URL and the webmap of interest.
  2. Create a Map using the URL.
  3. Set the map to the MapView.

Relevant API

  • Map
  • MapView
  • Portal
  • PortalItem

About the data

The web maps accessed by this sample show Geology for United States, Terrestrial Ecosystems of the World and Recent Hurricanes, Cyclones and Typhoons.

Tags

portal item, web map

Sample Code

OpenMapUrl.cppOpenMapUrl.cppOpenMapUrl.hOpenMapUrl.qml
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
// [WriteFile Name=OpenMapUrl, Category=Maps]
// [Legal]
// Copyright 2016 Esri.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// [Legal]

#ifdef PCH_BUILD
#include "pch.hpp"
#endif // PCH_BUILD

// sample headers
#include "OpenMapUrl.h"

// ArcGIS Maps SDK headers
#include "Basemap.h"
#include "Map.h"
#include "MapQuickView.h"
#include "MapTypes.h"

using namespace Esri::ArcGISRuntime;

OpenMapUrl::OpenMapUrl(QQuickItem* parent) :
  QQuickItem(parent)
{
}

OpenMapUrl::~OpenMapUrl() = default;

void OpenMapUrl::init()
{
  qmlRegisterType<MapQuickView>("Esri.Samples", 1, 0, "MapView");
  qmlRegisterType<OpenMapUrl>("Esri.Samples", 1, 0, "OpenMapUrlSample");
}

void OpenMapUrl::componentComplete()
{
  QQuickItem::componentComplete();

  // find QML MapView component
  m_mapView = findChild<MapQuickView*>("mapView");

  // create a new basemap instance
  Basemap* basemap = new Basemap(BasemapStyle::ArcGISImageryStandard, this);
  // create a new map instance
  Map* map = new Map(basemap, this);
  // set map on the map view
  m_mapView->setMap(map);
}

void OpenMapUrl::openMap(const QString& itemId)
{
  //! [Construct map from a webmap Url]
  // create a QUrl using the item id QString
  QString organizationPortalUrl(QStringLiteral("https://arcgis.com"));
  const QUrl webmapUrl(QString(organizationPortalUrl + "/sharing/rest/content/items/" + itemId));
  // create a new map from the webmap Url
  Map* map = new Map(webmapUrl, this);
  //! [Construct map from a webmap Url]

  // set the map to the map view
  m_mapView->setMap(map);
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.