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
- Create a
Envelope(xMin, yMin, xMax, yMax, SpatialReference). - Create a
Viewpointpassing in the envelope. - Call
setInitialViewpoint(viewpoint)on theMapto set the initial map area.
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.
Tags
basemap, center, envelope, extent, initial, lat, latitude, level of detail, location, LOD, long, longitude, scale, zoom level
Sample code
// [WriteFile Name=SetInitialMapArea, 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 "SetInitialMapArea.h"
// ArcGIS Maps SDK headers#include "Basemap.h"#include "Envelope.h"#include "Map.h"#include "MapQuickView.h"#include "MapTypes.h"#include "SpatialReference.h"#include "Viewpoint.h"
using namespace Esri::ArcGISRuntime;
SetInitialMapArea::SetInitialMapArea(QQuickItem* parent) : QQuickItem(parent){}
SetInitialMapArea::~SetInitialMapArea() = default;
void SetInitialMapArea::init(){ qmlRegisterType<MapQuickView>("Esri.Samples", 1, 0, "MapView"); qmlRegisterType<SetInitialMapArea>("Esri.Samples", 1, 0, "SetInitialMapAreaSample");}
void SetInitialMapArea::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 m_map = new Map(basemap, this); // set the initial viewpoint Envelope envelope(-12211308.778729, 4645116.003309, -12208257.879667, 4650542.535773, SpatialReference(102100)); m_map->setInitialViewpoint(Viewpoint(envelope)); // set map on the map view m_mapView->setMap(m_map);}// [WriteFile Name=SetInitialMapArea, 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]
#ifndef SET_INITIAL_MAP_AREA_H#define SET_INITIAL_MAP_AREA_H
// Qt headers#include <QQuickItem>
namespace Esri::ArcGISRuntime{ class Map; class MapQuickView;}
class SetInitialMapArea : public QQuickItem{ Q_OBJECT
public: explicit SetInitialMapArea(QQuickItem* parent = nullptr); ~SetInitialMapArea() override;
void componentComplete() override; static void init();
private: Esri::ArcGISRuntime::Map* m_map = nullptr; Esri::ArcGISRuntime::MapQuickView* m_mapView = nullptr;};
#endif // SET_INITIAL_MAP_AREA_H// [WriteFile Name=SetInitialMapArea, 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]
import QtQuickimport QtQuick.Controlsimport Esri.Samples
SetInitialMapAreaSample { width: 800 height: 600
// add a mapView component MapView { anchors.fill: parent objectName: "mapView"
Component.onCompleted: { // Set the focus on MapView to initially enable keyboard navigation forceActiveFocus(); } }}