Learn how to evaluate the horizontal, vertical, and direct distances between two points in a 3D Scene.
A distance measurement analysis is a type of measurement analysis that calculates and displays the distance between start point and end point locations. The analysis evaluates the vertical, horizontal, and direct distances between the two 3D points and renders a measurement visualization on-screen.
In this tutorial you will perform and display a distance measurement analysis in a web scene . Using the distance measurement analysis you will measure distances between hotspots in the Yosemite Valley.
Prerequisites The following are required for this tutorial:
An ArcGIS account to access your API keys . If you don't have an account, sign up for free . Your system meets the system requirements . Steps Open the Xcode project To start this tutorial, first complete the Display a web scene tutorial or download and unzip the solution.
Open the .xcodeproj
file in Xcode .
If you downloaded the solution project, set your API key.
More info An API Key enables access to services , web maps , and web scenes hosted in ArcGIS Online .
Go to your developer dashboard to get your API key .
For these tutorials, use your default API key. It is scoped to include all of the services demonstrated in the tutorials.
In Xcode , in the Project Navigator , click AppDelegate.swift .
In the editor , set the APIKey
property on the AGSArcGISRuntime Environment
with your API key .
AppDelegate.swift
Expand
Use dark colors for code blocks Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā
Change line
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
func application ( _ application : UIApplication ,
didFinishLaunchingWithOptions launchOptions : [ UIApplication . LaunchOptionsKey : Any ] ? ) -> Bool {
// Note: it is not best practice to store API keys in source code.
// The API key is referenced here for the convenience of this tutorial.
AGSArcGISRuntimeEnvironment .apiKey = "YOUR_API_KEY"
return true
}
Get the web scene item ID You can use ArcGIS tools to create and view web scenes . Use the Scene Viewer to identify the web scene item ID . This item ID will be used later in the tutorial.
Go to the Yosemite Valley Hotspots web scene in the Scene Viewer in ArcGIS Online . This web scene displays terrain and hotspots in the Yosemite Valley. Make a note of the item ID at the end of the browser's URL. The item ID should be 7558ee942b2547019f66885c44d4f0b1 Update the scene In Xcode , in the Project Navigator , click ViewController.swift .
In the editor , modify the setup Scene()
method to create an AGSScene
for the web scene. To do this, create a portal item providing the web scene's item ID and an AGSPortal
referencing ArcGIS Online.
ViewController.swift
Expand
Use dark colors for code blocks 32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
31
30
29
28
28
28
28
28
29
30
31
32
33
34
35
36
37
38
38
38
39
39
39
39
38
37
36
35
34
33
32
31
30
29
28
27
26
26
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
3
3
2
1
0
-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
-30
-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
Change line
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
private func setupScene () {
let scene: AGSScene = {
let portal = AGSPortal .arcGISOnline(withLoginRequired: false )
let item = AGSPortalItem (portal: portal, itemID: "7558ee942b2547019f66885c44d4f0b1" )
return AGSScene (item: item)
}()
sceneView.scene = scene
}
Add a UI to control the distance measurement analysis To control the distance measurement analysis, some UI is required.
Define a private method named setup UI()
. Create a "Clear"
button and assign it to the navigation bar. The clear button removes the distance measurement analysis from the scene. You set an action on the clear button using a selector for a method that will be added in a later step.
ViewController.swift
Expand
Use dark colors for code blocks 48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
47
46
45
44
44
44
44
44
44
44
44
44
44
44
44
44
44
44
43
42
42
42
42
42
43
44
45
46
47
48
48
48
48
48
48
48
47
47
47
46
45
44
43
42
41
40
39
38
37
36
35
34
33
32
31
30
29
28
27
26
25
24
24
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
-1
-2
-3
-4
-5
-6
-7
-8
-9
-9
-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
Add line. Add line. Add line. Add line. Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
private func setupUI () {
navigationItem.title = "Long press and drag."
let clear = UIBarButtonItem (title: "Clear" , style: .plain, target: self , action: #selector(clearScene))
navigationItem.rightBarButtonItem = clear
}
Define a method named clear Scene(_ : )
and assign it the @objc
keyword. This method is performed when the user taps the clear button. The @objc
method keyword exposes the method to Objective-C, a necessary step for using the UIBar Button Item
API.
ViewController.swift
Expand
Use dark colors for code blocks 48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
48
47
46
45
44
44
44
44
44
44
44
44
44
44
44
44
44
44
44
43
42
42
42
42
42
43
44
45
46
47
48
49
50
51
51
51
52
52
52
52
51
50
49
48
47
46
45
44
43
42
41
40
39
38
37
36
35
34
33
32
31
30
29
29
29
28
27
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
-1
-2
-3
-4
-4
-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
Add line. Add line. Add line. Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
private func setupUI () {
navigationItem.title = "Long press and drag."
let clear = UIBarButtonItem (title: "Clear" , style: .plain, target: self , action: #selector(clearScene))
navigationItem.rightBarButtonItem = clear
}
@objc
func clearScene ( _ sender : UIBarButtonItem ) {
}
In view D i d Load()
, call the method setup UI()
.
ViewController.swift
Expand
Use dark colors for code blocks 20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
21
22
23
24
25
26
26
26
27
27
27
27
27
27
27
27
27
27
27
27
27
27
26
25
25
25
25
25
25
25
25
25
25
25
25
25
25
24
23
23
23
23
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
0
0
-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
-33
-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
Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
override func viewDidLoad () {
super .viewDidLoad()
setupScene()
setupUI()
}
In Xcode , in the Project Navigator , click Main.storyboard .
In the editor , select View Controller
. In the menu bar , click Editor > Embed In > Navigation Controller .
More info Embedding View Controller
within a Navigation Controller will place a navigation bar at the top of View Controller
. Inside the navigation bar you will find the UI elements.
Check that your UI is set up properly. Press <Command+R> to run the app. You should see a "Clear" button contained by the navigation bar, the default title should be displayed, and the app should load the Yosemite Valley Hotspots web scene .
In Xcode , in the Project Navigator , click ViewController.swift .
In the editor , create a private static Measurement Formatter
named measurement Formatter
. The measurement formatter is used to convert measurement values into strings that are in a format localized to the user's device.
ViewController.swift
Expand
Use dark colors for code blocks 63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
62
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
60
59
59
59
59
59
59
59
59
59
59
59
59
59
59
58
57
57
57
57
57
58
59
60
61
62
63
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
63
63
63
62
61
60
59
58
57
56
55
54
53
52
51
50
49
48
47
46
45
44
43
42
41
40
39
38
37
36
35
34
33
32
31
30
30
30
29
28
27
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
Add line. Add line. Add line. Add line. Add line. Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
private static let measurementFormatter: MeasurementFormatter = {
let measurementFormatter = MeasurementFormatter ()
measurementFormatter.numberFormatter.minimumFractionDigits = 2
measurementFormatter.numberFormatter.maximumFractionDigits = 2
return measurementFormatter
}()
Define a private method named set Title F o r Distance Measurements(direct: horizontal: vertical: )
. This method is used to format a string to communicate the direct, horizontal, and vertical measurements to the user, placing the results in the navigation bar's title.
More info Because set Title F o r Distance Measurements
performs a UI operation and you cannot guarantee that it will be called from the main thread, you must ensure that the operation is performed asynchronously on the main thread.
ViewController.swift
Expand
Use dark colors for code blocks 63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
62
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
60
59
59
59
59
59
59
59
59
59
59
59
59
59
59
58
57
57
57
57
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
79
79
79
78
77
76
75
74
73
72
71
70
69
68
67
66
65
64
63
62
61
60
59
58
57
56
55
54
53
52
51
50
49
48
47
46
46
46
45
44
43
42
41
40
39
38
37
36
35
34
33
32
31
30
29
28
27
26
25
24
23
22
21
20
19
Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
private static let measurementFormatter: MeasurementFormatter = {
let measurementFormatter = MeasurementFormatter ()
measurementFormatter.numberFormatter.minimumFractionDigits = 2
measurementFormatter.numberFormatter.maximumFractionDigits = 2
return measurementFormatter
}()
private func setTitleForDistanceMeasurements ( direct : AGSDistance , horizontal : AGSDistance , vertical : AGSDistance ) {
DispatchQueue .main.async { [ weak self ] in
guard let self = self else { return }
if self .measurement.isVisible {
self .navigationItem.title = String (
format: "Direct: %@ | Horizontal: %@ | Vertical: %@" ,
Self .measurementFormatter.string(from: Measurement (value: direct.value, unit: Unit (symbol: direct.unit.abbreviation))),
Self .measurementFormatter.string(from: Measurement (value: horizontal.value, unit: Unit (symbol: horizontal.unit.abbreviation))),
Self .measurementFormatter.string(from: Measurement (value: vertical.value, unit: Unit (symbol: vertical.unit.abbreviation)))
)
} else {
self .navigationItem.title = "Long press and drag."
}
}
}
Create a distance measurement analysis Use a AGSLocation Distance Measurement
to perform and display a distance measurement analysis using 3D points to define the start and end locations.
Create a private lazy AGSLocation Distance Measurement
named measurement
. Upon launch, the distance measurement visualization should not be visible.
ViewController.swift
Expand
Use dark colors for code blocks 88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
87
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
85
84
84
84
84
84
84
84
84
84
84
84
84
84
84
83
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
83
84
85
86
87
88
89
90
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
90
90
90
89
88
87
86
85
84
83
82
81
80
79
78
77
76
75
74
73
72
71
70
69
68
67
66
65
64
63
Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
private lazy var measurement: AGSLocationDistanceMeasurement = {
let point = AGSPointMake3D ( 0 , 0 , 0 , 0 , .wgs84())
let measurement = AGSLocationDistanceMeasurement (startLocation: point, endLocation: point)
measurement.measurementChangedHandler = setTitleForDistanceMeasurements
measurement.isVisible = false
measurement.unitSystem = .metric // .imperial
return measurement
}()
Define a private method named setup Analysis Overlay()
to add the distance measurement analysis to the scene.
More info The distance measurement analysis is added to a scene view using an analysis overlay. An analysis overlay is a container for analyses. It can be used to display visual analyses in a scene view. You can add more than one analysis overlay and they are displayed on top of all other layers .
ViewController.swift
Expand
Use dark colors for code blocks 88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
88
87
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
85
84
84
84
84
84
84
84
84
84
84
84
84
84
84
83
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
96
95
94
93
92
91
90
89
88
87
86
85
84
83
82
81
80
79
78
78
78
77
76
75
74
73
72
71
70
69
68
67
66
65
64
63
62
61
60
59
58
57
56
55
54
53
52
51
Add line. Add line. Add line. Add line. Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
private lazy var measurement: AGSLocationDistanceMeasurement = {
let point = AGSPointMake3D ( 0 , 0 , 0 , 0 , .wgs84())
let measurement = AGSLocationDistanceMeasurement (startLocation: point, endLocation: point)
measurement.measurementChangedHandler = setTitleForDistanceMeasurements
measurement.isVisible = false
measurement.unitSystem = .metric // .imperial
return measurement
}()
private func setupAnalysisOverlay () {
let analysisOverlay = AGSAnalysisOverlay ()
analysisOverlay.analyses.add(measurement)
sceneView.analysisOverlays.add(analysisOverlay)
}
Define a private method named start Distance Measurement(point: )
that receives a point as a parameter. This method is used to set the distance measurement analysis start Location
.
ViewController.swift
Expand
Use dark colors for code blocks 97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
96
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
94
93
93
93
93
93
93
93
93
93
93
93
93
93
93
92
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
92
93
94
95
96
97
98
99
100
101
102
102
101
100
99
98
97
96
95
94
93
92
91
90
90
90
89
88
87
86
85
84
83
82
81
80
79
78
77
76
75
74
73
72
71
70
69
68
67
66
65
64
63
Add line. Add line. Add line. Add line. Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
private func setupAnalysisOverlay () {
let analysisOverlay = AGSAnalysisOverlay ()
analysisOverlay.analyses.add(measurement)
sceneView.analysisOverlays.add(analysisOverlay)
}
private func startDistanceMeasurement ( point : AGSPoint ) {
measurement.isVisible = false
measurement.startLocation = point
measurement.endLocation = point
}
Define a private method named move Distance Measurement(point: )
that receives a point as a parameter. This method is used to set the distance measurement analysis end Location
and make it visible, if it's not visible already.
ViewController.swift
Expand
Use dark colors for code blocks 103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
102
101
101
101
101
101
101
101
101
101
101
101
101
101
101
101
100
99
99
99
99
99
99
99
99
99
99
99
99
99
99
98
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
98
99
100
101
102
103
104
105
106
107
108
109
109
108
107
106
105
104
104
104
103
102
101
100
99
98
97
96
95
94
93
92
91
90
89
88
87
86
85
84
83
82
81
80
79
78
77
Add line. Add line. Add line. Add line. Add line. Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
private func startDistanceMeasurement ( point : AGSPoint ) {
measurement.isVisible = false
measurement.startLocation = point
measurement.endLocation = point
}
private func moveDistanceMeasurement ( point : AGSPoint ) {
measurement.endLocation = point
if ! measurement.isVisible {
measurement.isVisible = true
}
}
Define a private method named clear Measurement()
. This method is used to hide the distance measurement analysis.
ViewController.swift
Expand
Use dark colors for code blocks 109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
109
108
107
107
107
107
107
107
107
107
107
107
107
107
107
107
107
106
105
105
105
105
105
105
105
105
105
105
105
105
105
105
104
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
103
104
105
106
107
108
109
110
111
112
113
114
114
114
114
113
112
111
110
109
108
107
106
105
104
103
102
101
100
99
98
97
96
95
94
93
92
91
90
89
88
87
Add line. Add line. Add line. Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
private func moveDistanceMeasurement ( point : AGSPoint ) {
measurement.endLocation = point
if ! measurement.isVisible {
measurement.isVisible = true
}
}
private func clearMeasurement () {
measurement.isVisible = false
navigationItem.title = "Long press and drag."
}
Call clear Measurement()
when the user taps the "Clear" button.
ViewController.swift
Expand
Use dark colors for code blocks 54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
54
53
52
52
52
52
52
52
52
52
52
52
52
52
52
52
52
51
50
50
50
50
50
50
50
50
50
50
50
51
52
53
54
55
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
56
55
54
53
52
51
50
49
48
47
46
45
44
43
42
41
40
39
38
37
36
35
34
33
32
31
30
29
Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
@objc
func clearScene ( _ sender : UIBarButtonItem ) {
clearMeasurement()
}
In view D i d Load()
, call the method setup Analysis Overlay()
.
ViewController.swift
Expand
Use dark colors for code blocks 20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
20
21
22
23
24
25
26
27
28
29
29
29
29
29
29
29
29
29
29
29
29
29
29
28
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
27
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
override func viewDidLoad () {
super .viewDidLoad()
setupScene()
setupUI()
setupAnalysisOverlay()
}
Display the distance measurement analysis with touch events Touch events determine where to perform and display the distance measurement analysis. A user can long-press and drag to reveal and move the distance measurement analysis' location around the screen.
Extend View Controller
to conform to the AGSGeo View Touch Delegate
protocol and include the four long-press geoview touch delegate methods.
ViewController.swift
Expand
Use dark colors for code blocks 123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
122
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
122
123
124
125
125
125
126
127
128
129
129
129
130
131
132
133
133
133
134
135
136
137
137
137
138
139
140
Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
extension ViewController : AGSGeoViewTouchDelegate {
func geoView ( _ geoView : AGSGeoView , didLongPressAtScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
}
func geoView ( _ geoView : AGSGeoView , didMoveLongPressToScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
}
func geoView ( _ geoView : AGSGeoView , didEndLongPressAtScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
}
func geoViewDidCancelLongPress ( _ geoView : AGSGeoView ) {
}
}
When the user begins a long-press touch event, call start Distance Measurement(point: )
.
ViewController.swift
Expand
Use dark colors for code blocks 123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
122
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
122
123
124
125
126
127
128
129
130
131
131
131
132
133
134
135
135
135
136
137
138
139
139
139
140
141
142
Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
extension ViewController : AGSGeoViewTouchDelegate {
func geoView ( _ geoView : AGSGeoView , didLongPressAtScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
startDistanceMeasurement(point: mapPoint)
}
func geoView ( _ geoView : AGSGeoView , didMoveLongPressToScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
}
func geoView ( _ geoView : AGSGeoView , didEndLongPressAtScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
}
func geoViewDidCancelLongPress ( _ geoView : AGSGeoView ) {
}
}
When the user moves and ends a long-press touch event, call move Distance Measurement(point: )
.
ViewController.swift
Expand
Use dark colors for code blocks 123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
122
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
143
143
144
145
146
Add line. Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
extension ViewController : AGSGeoViewTouchDelegate {
func geoView ( _ geoView : AGSGeoView , didLongPressAtScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
startDistanceMeasurement(point: mapPoint)
}
func geoView ( _ geoView : AGSGeoView , didMoveLongPressToScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
moveDistanceMeasurement(point: mapPoint)
}
func geoView ( _ geoView : AGSGeoView , didEndLongPressAtScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
moveDistanceMeasurement(point: mapPoint)
}
func geoViewDidCancelLongPress ( _ geoView : AGSGeoView ) {
}
}
When the user cancels the long-press touch event, call clear Measurement()
.
More info This may happen, for instance, when you have the magnifier visible and attempt to take a screenshot using the home/lock button combination.
ViewController.swift
Expand
Use dark colors for code blocks 123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
123
122
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
extension ViewController : AGSGeoViewTouchDelegate {
func geoView ( _ geoView : AGSGeoView , didLongPressAtScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
startDistanceMeasurement(point: mapPoint)
}
func geoView ( _ geoView : AGSGeoView , didMoveLongPressToScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
moveDistanceMeasurement(point: mapPoint)
}
func geoView ( _ geoView : AGSGeoView , didEndLongPressAtScreenPoint screenPoint : CGPoint , mapPoint : AGSPoint ) {
moveDistanceMeasurement(point: mapPoint)
}
func geoViewDidCancelLongPress ( _ geoView : AGSGeoView ) {
clearMeasurement()
}
}
In the setup Scene()
method, assign View Controller
to scene View.touch Delegate
.
More info This step connects the scene View
user touch interactions with View Controller
via the AGSGeo View Touch Delegate
protocol.
ViewController.swift
Expand
Use dark colors for code blocks 32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
32
33
34
35
36
37
38
39
40
41
42
43
44
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
Add line.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
private func setupScene () {
let scene: AGSScene = {
let portal = AGSPortal .arcGISOnline(withLoginRequired: false )
let item = AGSPortalItem (portal: portal, itemID: "7558ee942b2547019f66885c44d4f0b1" )
return AGSScene (item: item)
}()
sceneView.scene = scene
sceneView.touchDelegate = self
}
Run the app Press <Command+R> to run the app.
More info If you are using the Xcode simulator your system must meet these minimum requirements: macOS Big Sur 11.3, Xcode 13, iOS 13. If you are using a physical device, then refer to the system requirements .
You should see a scene of hotspots in the Yosemite Valley. Long-press and drag to display and move a distance measurement analysis to evaluate the horizontal, vertical, and direct distances between two park locations.
What's next? Learn how to use additional API features , ArcGIS location services , and ArcGIS tools in these tutorials: