Set the map view to a new viewpoint.

Use case
Programatically navigate to a specified location in the map or scene. Use this to focus on a particular point or area of interest.
How to use the sample
The map view has several methods for setting its current viewpoint. Select a viewpoint from the UI to see the viewpoint changed using that method.
How it works
- Create a new
Mapobject and set it to theMapViewobject. - Change the map’s
Viewpointusing one of the available methods:
- Use
MapView.SetViewpointAsync()to pan to a viewpoint. - Use
MapView.SetViewpointCenterAsync()to center the viewpoint on aPoint. - Use
MyMapView.SetViewpointScaleAsync()to set a distance from the ground using a scale. - Use
MapView.SetViewpointGeometryAsync()to set the viewpoint to a givenGeometry.
Relevant API
- Geometry
- Map
- MapView
- Point
- Viewpoint
Additional information
Below are some other ways to set a viewpoint:
- SetViewpoint
- SetViewpointAsync
- SetViewpointCenterAsync
- SetViewpointGeometryAsync
- SetViewpointRotationAsync
- SetViewpointScaleAsync
Tags
animate, extent, pan, rotate, scale, view, zoom
Sample Code
<UserControl x:Class="ArcGIS.WPF.Samples.ChangeViewpoint.ChangeViewpoint" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013" xmlns:mapping="clr-namespace:Esri.ArcGISRuntime.Mapping;assembly=Esri.ArcGISRuntime"> <UserControl.Resources> <Style TargetType="Button" BasedOn="{StaticResource CalciteButtonBaseStyle}"> <Setter Property="Padding" Value="5" /> <Setter Property="Margin" Value="5,5,0,0" /> </Style> </UserControl.Resources> <Grid> <esri:MapView x:Name="MyMapView"> <mapping:Map> <mapping:Map.OperationalLayers> <mapping:ArcGISTiledLayer x:Name="Basemap" Source="https://services.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer" /> </mapping:Map.OperationalLayers> </mapping:Map> </esri:MapView> <Border Style="{StaticResource BorderStyle}"> <Grid> <Grid.RowDefinitions> <RowDefinition Height="Auto" /> <RowDefinition Height="Auto" /> </Grid.RowDefinitions> <Grid.ColumnDefinitions> <ColumnDefinition Width="*" /> <ColumnDefinition Width="*" /> <ColumnDefinition Width="*" /> </Grid.ColumnDefinitions> <TextBlock Grid.Row="0" Grid.Column="0" Grid.ColumnSpan="3" HorizontalAlignment="Center" FontWeight="SemiBold" Text="Use the buttons to set the viewpoint." TextWrapping="Wrap" /> <Button Grid.Row="1" Grid.Column="0" Margin="0,5,0,0" Click="OnButtonClick" Content="Geometry" ToolTip="Sets Viewpoint to a predefined Polygon's extent" /> <Button Grid.Row="1" Grid.Column="1" Click="OnButtonClick" Content="Center and scale" ToolTip="Sets Viewpoint a predefined point and scale" /> <Button Grid.Row="1" Grid.Column="2" Click="OnButtonClick" Content="Animate" ToolTip="Sets Viewpoint and animate repositioning of view" /> </Grid> </Border> </Grid></UserControl>// 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.
using Esri.ArcGISRuntime.Geometry;using Esri.ArcGISRuntime.Mapping;using System;using System.Collections.Generic;using System.Windows;using System.Windows.Controls;
namespace ArcGIS.WPF.Samples.ChangeViewpoint{ [ArcGIS.Samples.Shared.Attributes.Sample( name: "Change viewpoint", category: "MapView", description: "Set the map view to a new viewpoint.", instructions: "The map view has several methods for setting its current viewpoint. Select a viewpoint from the UI to see the viewpoint changed using that method.", tags: new[] { "animate", "extent", "pan", "rotate", "scale", "view", "zoom" })] public partial class ChangeViewpoint { // Coordinates for London private MapPoint _londonCoords = new MapPoint( -13881.7678417696, 6710726.57374296, SpatialReferences.WebMercator);
private double _londonScale = 8762.7156655228955;
// Coordinates for Redlands private Polygon _redlandsEnvelope = new Polygon(new List<MapPoint> { new MapPoint(-13049785.1566222, 4032064.6003424), new MapPoint(-13049785.1566222, 4040202.42595729), new MapPoint(-13037033.5780234, 4032064.6003424), new MapPoint(-13037033.5780234, 4040202.42595729) }, SpatialReferences.WebMercator);
// Coordinates for Edinburgh private Polygon _edinburghEnvelope = new Polygon(new List<MapPoint> { new MapPoint(-354262.156621384, 7548092.94093301), new MapPoint(-354262.156621384, 7548901.50684376), new MapPoint(-353039.164455303, 7548092.94093301), new MapPoint(-353039.164455303, 7548901.50684376) }, SpatialReferences.WebMercator);
public ChangeViewpoint() { InitializeComponent(); }
private async void OnButtonClick(object sender, RoutedEventArgs e) { try { // Get content from the selected item Button myButton = (Button)sender;
switch (myButton.Content.ToString()) { case "Geometry":
// Set Viewpoint using Redlands envelope defined above and a padding of 20 await MyMapView.SetViewpointGeometryAsync(_redlandsEnvelope, 20); break;
case "Center and scale":
// Set Viewpoint so that it is centered on the London coordinates defined above await MyMapView.SetViewpointCenterAsync(_londonCoords);
// Set the Viewpoint scale to match the specified scale await MyMapView.SetViewpointScaleAsync(_londonScale); break;
case "Animate":
// Navigate to full extent of the first baselayer before animating to specified geometry await MyMapView.SetViewpointAsync( new Viewpoint(Basemap.FullExtent));
// Create a new Viewpoint using the specified geometry Viewpoint viewpoint = new Viewpoint(_edinburghEnvelope);
// Set Viewpoint of MapView to the Viewpoint created above and animate to it using a timespan of 5 seconds await MyMapView.SetViewpointAsync(viewpoint, TimeSpan.FromSeconds(5)); break;
default: break; } } catch (Exception ex) { MessageBox.Show(ex.ToString(), "Error"); } } }}