View in WPF WinUI UWP Forms iOS Android View on GitHub
Display coordinate system grids including Latitude/Longitude, MGRS, UTM and USNG on a map view. Also, toggle label visibility and change the color of grid lines and grid labels.
Use case
Grids are often used on printed maps, but can also be helpful on digital maps, to identify locations on a map.
How to use the sample
Select type of grid from the types (LatLong, MGRS, UTM and USNG) and modify its properties like label visibility, grid line color, and grid label color. Press the button to apply these settings.
How it works
Create an instance of one of the Grid
types.
Grid lines and labels can be styled per grid level with setLineSymbol(gridLevel, lineSymbol)
and setTextSymbol(gridLevel, textSymbol)
methods on the grid.
The label position can be set with setLabelPosition(labelPosition)
method on the grid.
For the LatitudeLongitudeGrid
type, you can specify a label format of DecimalDegrees
or DegreesMinutesSeconds
.
To set the grid, use the setGrid(grid)
method on the map view.
Relevant API
Grid
LatitudeLongitudeGrid
MapView
MGRSGrid
SimpleLineSymbol
TextSymbol
USNGGrid
UTMGrid
coordinates, degrees, graticule, grid, latitude, longitude, MGRS, minutes, seconds, USNG, UTM
Sample CodeDisplayGrid.xaml DisplayGrid.xaml DisplayGrid.xaml.cs CopyUse dark colors for code blocks
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
<?xml version="1.0" encoding="utf-8" ?>
< ContentPage
x:Class = "ArcGISRuntime.Samples.DisplayGrid.DisplayGrid"
xmlns = "http://xamarin.com/schemas/2014/forms"
xmlns:x = "http://schemas.microsoft.com/winfx/2009/xaml"
xmlns:esriUI = "clr-namespace:Esri.ArcGISRuntime.Xamarin.Forms;assembly=Esri.ArcGISRuntime.Xamarin.Forms" >
< ContentPage.Resources >
< ResourceDictionary >
< Style TargetType = "Picker" >
< Setter Property = "VerticalOptions" Value = "Center" />
</ Style >
</ ResourceDictionary >
</ ContentPage.Resources >
< Grid >
< Grid.RowDefinitions >
< RowDefinition Height = "*" />
< RowDefinition Height = "Auto" />
< RowDefinition Height = "2*" />
</ Grid.RowDefinitions >
< ScrollView Grid.Row = "0" >
< Grid >
< Grid.RowDefinitions >
< RowDefinition Height = "Auto" />
< RowDefinition Height = "Auto" />
< RowDefinition Height = "Auto" />
< RowDefinition Height = "Auto" />
< RowDefinition Height = "Auto" />
< RowDefinition Height = "Auto" />
< RowDefinition Height = "Auto" />
< RowDefinition Height = "Auto" />
</ Grid.RowDefinitions >
< Grid.ColumnDefinitions >
< ColumnDefinition Width = "*" />
< ColumnDefinition Width = "2*" />
</ Grid.ColumnDefinitions >
<!-- Labels -->
< Label
Grid.Row = "0"
Text = "Grid type"
VerticalOptions = "Center"
VerticalTextAlignment = "Center" />
< Label
Grid.Row = "1"
Text = "Show labels"
VerticalOptions = "Center"
VerticalTextAlignment = "Center" />
< Label
Grid.Row = "2"
Text = "Show grid"
VerticalOptions = "Center"
VerticalTextAlignment = "Center" />
< Label
Grid.Row = "3"
Text = "Grid color"
VerticalOptions = "Center"
VerticalTextAlignment = "Center" />
< Label
Grid.Row = "4"
Text = "Label color"
VerticalOptions = "Center"
VerticalTextAlignment = "Center" />
< Label
Grid.Row = "5"
Text = "Halo color"
VerticalOptions = "Center"
VerticalTextAlignment = "Center" />
< Label
Grid.Row = "6"
Text = "Label position"
VerticalOptions = "Center"
VerticalTextAlignment = "Center" />
< Label
Grid.Row = "7"
Text = "Label format"
VerticalOptions = "Center"
VerticalTextAlignment = "Center" />
<!-- Inputs -->
< Picker
x:Name = "gridTypePicker"
Grid.Row = "0"
Grid.Column = "1"
VerticalOptions = "CenterAndExpand" />
< Switch
x:Name = "labelVisibilitySwitch"
Grid.Row = "1"
Grid.Column = "1"
IsToggled = "True" />
< Switch
x:Name = "gridVisibilitySwitch"
Grid.Row = "2"
Grid.Column = "1"
IsToggled = "True" />
< Picker
x:Name = "gridColorPicker"
Grid.Row = "3"
Grid.Column = "1"
VerticalOptions = "CenterAndExpand" />
< Picker
x:Name = "labelColorPicker"
Grid.Row = "4"
Grid.Column = "1"
VerticalOptions = "CenterAndExpand" />
< Picker
x:Name = "haloColorPicker"
Grid.Row = "5"
Grid.Column = "1"
VerticalOptions = "CenterAndExpand" />
< Picker
x:Name = "labelPositionPicker"
Grid.Row = "6"
Grid.Column = "1"
VerticalOptions = "CenterAndExpand" />
< Picker
x:Name = "labelFormatPicker"
Grid.Row = "7"
Grid.Column = "1"
VerticalOptions = "CenterAndExpand" />
</ Grid >
</ ScrollView >
< Button
x:Name = "applySettingsButton"
Grid.Row = "1"
IsEnabled = "False"
Text = "Apply settings" />
< esriUI:MapView x:Name = "MyMapView" Grid.Row = "2" />
</ Grid >
</ ContentPage >