View inWPFWinUIMAUIUWPView on GitHub
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
Map
object and set it to the MapView
object.
- Change the map's
Viewpoint
using one of the available methods:
- Use
MapView.SetViewpointAsync()
to pan to a viewpoint.
- Use
MapView.SetViewpointCenterAsync()
to center the viewpoint on a Point
.
- Use
MyMapView.SetViewpointScaleAsync()
to set a distance from the ground using a scale.
- Use
MapView.SetViewpointGeometryAsync()
to set the viewpoint to a given Geometry
.
Relevant API
- Geometry
- Map
- MapView
- Point
- Viewpoint
Below are some other ways to set a viewpoint:
- SetViewpoint
- SetViewpointAsync
- SetViewpointCenterAsync
- SetViewpointGeometryAsync
- SetViewpointRotationAsync
- SetViewpointScaleAsync
animate, extent, pan, rotate, scale, view, zoom
Sample Code
ChangeViewpoint.xamlChangeViewpoint.xamlChangeViewpoint.xaml.cs
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
<UserControl
x:Class="ArcGIS.UWP.Samples.ChangeViewpoint.ChangeViewpoint"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:esriUI="using:Esri.ArcGISRuntime.UI.Controls">
<Grid>
<esriUI:MapView x:Name="MyMapView" />
<Border Background="White" BorderBrush="Black" BorderThickness="1"
HorizontalAlignment="Right" VerticalAlignment="Top"
Margin="30" Padding="20" Width="375">
<Grid>
<Grid.RowDefinitions>
<RowDefinition Height="Auto" />
<RowDefinition Height="Auto" />
</Grid.RowDefinitions>
<Grid.ColumnDefinitions>
<ColumnDefinition Width="*" />
<ColumnDefinition Width="Auto" />
<ColumnDefinition Width="*" />
</Grid.ColumnDefinitions>
<TextBlock Text="Use the buttons to compare the various ways of setting the viewpoint."
Grid.Row="0" Grid.Column="0" Grid.ColumnSpan="3"
Margin="0,0,0,5"
TextWrapping="Wrap" FontWeight="SemiBold" />
<Button Content="Geometry"
Grid.Row="1" Grid.Column="0"
Margin="0,10,0,0"
HorizontalAlignment="Stretch"
Click="OnButtonClick" />
<Button Content="Center and Scale"
Grid.Row="1" Grid.Column="1"
Margin="5,10,0,0"
HorizontalAlignment="Stretch"
Click="OnButtonClick"
RelativePanel.RightOf="GeomButton" />
<Button Content="Animate"
Grid.Row="1" Grid.Column="2"
Margin="5,10,0,0"
HorizontalAlignment="Stretch"
Click="OnButtonClick"
RelativePanel.RightOf="ScaleButton" />
</Grid>
</Border>
</Grid>
</UserControl>