Learn how to find an address or place with a search bar and the Geocoding service .
Geocoding is the process of converting address or place text into a location . The Geocoding service can search for an address or a place and perform reverse geocoding .
In this tutorial, you use a search bar in the user interface to access the Geocoding service and search for addresses and places.
To learn how to use the Geocoding service to reverse geocode , visit the Reverse geocode tutorial.
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 the tutorial, complete the Display a map 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
}
Add a search bar to the UI To search an address using the application, add a UI element to prompt the user for text input. The text input will be used as the geocode search text in a later step.
In Xcode , in the Project Navigator , click ViewController.swift .
In the editor , extend View Controller
to conform to the UISearch B a r Delegate
protocol.
ViewController.swift
Expand
Use dark colors for code blocks 146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
145
144
143
142
142
142
142
142
142
142
142
142
142
142
142
142
142
142
142
142
142
141
140
139
138
137
136
135
134
133
132
132
132
132
131
130
129
128
127
126
125
124
123
122
121
120
119
118
117
116
115
114
113
112
111
110
109
108
107
106
106
106
105
104
103
102
101
100
99
98
97
96
95
94
93
92
91
90
89
88
87
86
86
86
85
84
83
82
81
80
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
50
50
51
52
52
52
52
52
52
52
52
52
52
52
52
52
52
53
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
151
152
153
154
155
156
157
158
159
160
161
162
extension ViewController : UISearchBarDelegate {
}
Define a private method named setup Search Bar()
. In setup Search Bar()
create an UISearch Bar
with these initial values and assign it to navigation Item.title View
.
ViewController.swift
Expand
Use dark colors for code blocks 45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
45
44
43
42
41
41
41
41
41
41
41
41
41
41
41
41
41
41
41
41
41
41
42
43
44
45
46
47
48
49
50
50
50
50
50
49
48
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
4
4
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
-31
-32
-32
-32
-32
-32
-33
-34
-35
-36
-37
-38
-39
-40
-41
-42
-43
-44
-45
-45
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
151
152
153
154
155
156
157
158
159
160
161
162
private func setupSearchBar () {
navigationItem.titleView = {
let searchBar = UISearchBar ()
searchBar.delegate = self
searchBar.showsCancelButton = true
searchBar.placeholder = "Search for an address"
return searchBar
}()
}
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 search bar.
In Xcode , in the Project Navigator , click ViewController.swift .
In the editor , in the view D i d Load()
method, call setup Search Bar()
.
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
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
1
1
0
-1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12
-13
-14
-15
-16
-17
-18
-19
-19
-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
-55
-55
-55
-55
-56
-57
-58
-59
-60
-61
-62
-63
-64
-65
-66
-67
-68
-68
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
151
152
153
154
155
156
157
158
159
160
161
162
override func viewDidLoad () {
super .viewDidLoad()
setupMap()
setupSearchBar()
}
Add graphics to the map view A graphics overlay is a container for graphics . Graphics are added as a visual means to display the search result on the map .
Create a private AGSGraphic
property named text Graphic
. This graphic will be used to display the result's text label.
More info An AGSText Symbol
is used to display text at a location on the map view.
ViewController.swift
Expand
Use dark colors for code blocks 64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
64
63
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
62
61
60
59
58
57
56
57
58
59
60
61
62
63
64
65
66
66
65
64
63
62
61
60
59
58
57
57
57
56
55
54
53
52
51
50
49
48
47
46
45
44
43
42
41
40
39
38
37
37
37
36
35
34
33
32
31
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
2
1
1
1
1
1
0
-1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12
-12
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
151
152
153
154
155
156
157
158
159
160
161
162
private let textGraphic: AGSGraphic = {
let textSymbol = AGSTextSymbol (
text: "" ,
color: .black,
size: 14 ,
horizontalAlignment: .center,
verticalAlignment: .bottom
)
return AGSGraphic (geometry: nil , symbol: textSymbol)
}()
Create a private AGSGraphic
property named marker Graphic
. This graphic will be used to display the result's location.
ViewController.swift
Expand
Use dark colors for code blocks 75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
75
74
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
73
72
71
70
69
68
67
67
67
67
67
67
67
67
67
67
67
67
68
69
70
71
72
73
74
75
75
75
75
74
73
72
71
70
69
68
67
66
65
64
63
62
61
60
59
58
57
56
55
55
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
28
27
26
25
24
23
22
21
20
19
19
19
19
19
18
17
16
15
14
13
12
11
10
9
8
7
6
6
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
151
152
153
154
155
156
157
158
159
160
161
162
private let markerGraphic: AGSGraphic = {
let markerSymbol = AGSSimpleMarkerSymbol (
style: .square,
color: .red,
size: 12
)
return AGSGraphic (geometry: nil , symbol: markerSymbol)
}()
Define a private method named setup Graphics()
. In setup Graphics()
create an AGSGraphics Overlay
. Append text Graphic
and marker Graphic
to the graphics overlay then add the graphics overlay to the map view.
ViewController.swift
Expand
Use dark colors for code blocks 58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
58
57
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
57
58
59
60
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
60
59
58
57
56
55
54
53
52
51
50
49
48
47
46
45
44
43
42
41
41
41
40
39
38
37
36
35
34
33
32
31
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
5
5
5
5
4
3
2
1
0
-1
-2
-3
-4
-5
-6
-7
-8
-8
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
151
152
153
154
155
156
157
158
159
160
161
162
private func setupGraphics () {
let graphicsOverlay = AGSGraphicsOverlay ()
graphicsOverlay.graphics.addObjects(from: [textGraphic, markerGraphic])
mapView.graphicsOverlays.add(graphicsOverlay)
}
More info Because text Graphic
and marker Graphic
haven't yet specified a geometry , they will not be visible.
In the view D i d Load()
method, call setup Graphics()
.
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
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
29
28
27
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
9
9
8
7
6
5
4
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
-27
-27
-27
-27
-28
-29
-30
-31
-32
-33
-34
-35
-36
-37
-38
-39
-40
-40
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
151
152
153
154
155
156
157
158
159
160
161
162
override func viewDidLoad () {
super .viewDidLoad()
setupMap()
setupSearchBar()
setupGraphics()
}
Define app geocode results status The app will leverage a state-machine design pattern to ensure the contents of the map reflect the state of the search result. This design pattern supports wrangling multiple asynchronous requests to the world geocoding service into a single state variable result, ensuring the reliability of search results.
Define an enum named Result Status
with two cases. The first case, none
, is used when there is no result or an error is returned. The second case, result
, is used when a result is found.
ViewController.swift
Expand
Use dark colors for code blocks 86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
87
88
89
90
90
89
88
87
86
85
84
83
82
81
80
79
78
77
76
75
75
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
45
44
43
42
41
40
39
39
39
39
39
38
37
36
35
34
33
32
31
30
29
28
27
26
26
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
151
152
153
154
155
156
157
158
159
160
161
162
enum ResultStatus {
case none
case result( String , AGSPoint )
}
Create a Result Status
property named status
. Setting this property will update text Graphic
and marker Graphic
with values from the result.
ViewController.swift
Expand
Use dark colors for code blocks 86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
105
105
105
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
76
75
74
73
72
71
70
69
69
69
69
69
68
67
66
65
64
63
62
61
60
59
58
57
56
56
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
151
152
153
154
155
156
157
158
159
160
161
162
enum ResultStatus {
case none
case result( String , AGSPoint )
}
var status: ResultStatus = .none {
didSet {
switch status {
case .none:
(textGraphic.symbol as! AGSTextSymbol ).text = ""
textGraphic.geometry = nil
markerGraphic.geometry = nil
case .result( let title, let location):
(textGraphic.symbol as! AGSTextSymbol ).text = title
textGraphic.geometry = location
markerGraphic.geometry = location
}
}
}
Create a locator task with geocode parameters Geocoding is implemented with a locator , typically created by referencing a service such as the Geocoding service or, for offline geocoding, by referencing locator data contained in a mobile package . Geocoding parameters can be used to fine-tune the results, such as setting the maximum number of results or requesting additional attributes in the results.
Create a private AGSLocator Task
property named locator
with the Geocoding service URL .
More info A locator task is used to convert an address to a point (geocode) or vice-versa (reverse geocode ). An address includes any type of information that distinguishes a place. A locator involves finding matching locations for a given address. Reverse-geocoding is the opposite and finds the closest address for a given point.
ViewController.swift
Expand
Use dark colors for code blocks 108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
109
110
111
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
86
85
84
83
82
81
80
79
79
79
79
79
78
77
76
75
74
73
72
71
70
69
68
67
66
66
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
151
152
153
154
155
156
157
158
159
160
161
162
private let locator = AGSLocatorTask (
url: URL (string: "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer" ) !
)
Create a private optional AGSCancelable
property named current Geocode Operation
that will maintain a reference to the geocode operation. If the user submits a second query before the current one completes, it can be used to cancel the operation.
ViewController.swift
Expand
Use dark colors for code blocks 108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
109
110
111
112
113
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
113
113
113
113
113
112
111
110
109
108
107
106
105
104
103
102
101
100
100
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
151
152
153
154
155
156
157
158
159
160
161
162
private let locator = AGSLocatorTask (
url: URL (string: "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer" ) !
)
private var currentGeocodeOperation: AGSCancelable ?
Define a private method named geocode(with search Text: String)
and cancel the current geocode operation, if one exists.
ViewController.swift
Expand
Use dark colors for code blocks 108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
109
110
111
112
113
114
115
116
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
117
118
118
118
118
118
118
117
116
115
114
113
112
111
110
109
108
107
106
105
105
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
151
152
153
154
155
156
157
158
159
160
161
162
private let locator = AGSLocatorTask (
url: URL (string: "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer" ) !
)
private var currentGeocodeOperation: AGSCancelable ?
private func geocode ( with searchText : String ) {
currentGeocodeOperation ? .cancel()
}
Create new AGSGeocode Parameters
, and assign it to the geocode Parameters
property. Specify the geocode's attributes as follows:
Specify which attributes to return with result Attribute Names
. *
is used to return all attributes.
Set the maximum number of results to be returned with max Results
. In this tutorial, only return the best match by passing in 1
. Results are ordered by score
, so just returning the first result will return the highest scoring result.
Set the spatial reference with output Spatial Reference
. By default the output spatial reference is determined by the geocode service. For optimal performance when displaying the geocode result, ensure the returned coordinates match those of the map view by providing map View.spatial Reference
as a parameter.
More info When geocoding an address, you can optionally provide AGSGeocode Parameters
to control certain aspects of the geocoding operation, and specify the kinds of results to return from the locator task.
ViewController.swift
Expand
Use dark colors for code blocks 114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
115
116
117
118
119
120
121
122
123
124
125
125
125
125
125
125
125
125
125
125
125
125
125
125
125
125
125
125
126
126
126
126
126
126
125
124
123
122
121
120
119
118
117
116
115
114
113
113
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
151
152
153
154
155
156
157
158
159
160
161
162
private func geocode ( with searchText : String ) {
currentGeocodeOperation ? .cancel()
let parameters: AGSGeocodeParameters = {
let parameters = AGSGeocodeParameters ()
parameters.resultAttributeNames = [ "*" ]
parameters.maxResults = 1
parameters.outputSpatialReference = mapView.spatialReference
return parameters
}()
}
Perform the geocode operation by calling geocode With Search Text: parameters: completion: ()
and supplying the search query and the geocode parameters. Handle the operation's completion and set the result status accordingly. The result obtained from the geocode operation will be displayed as a graphic in the map view's graphics overlay .
ViewController.swift
Expand
Use dark colors for code blocks 114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
114
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
143
143
143
143
143
142
141
140
139
138
137
136
135
134
133
132
131
130
130
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
151
152
153
154
155
156
157
158
159
160
161
162
private func geocode ( with searchText : String ) {
currentGeocodeOperation ? .cancel()
let parameters: AGSGeocodeParameters = {
let parameters = AGSGeocodeParameters ()
parameters.resultAttributeNames = [ "*" ]
parameters.maxResults = 1
parameters.outputSpatialReference = mapView.spatialReference
return parameters
}()
currentGeocodeOperation = self .locator.geocode(withSearchText: searchText, parameters: parameters) { [ weak self ] (results, error) in
guard let self = self else { return }
if let error = error {
self .status = .none
print (error.localizedDescription)
return
} else if let firstResult = results ? .first,
let extent = firstResult.extent,
let location = firstResult.displayLocation {
self .status = .result(firstResult.label, location)
self .mapView.setViewpointGeometry(extent)
} else {
self .status = .none
print ( "No results found for \(searchText) ." )
}
}
}
Hook up the search bar to the geocode operation Find the View Controller
extension of UISearch B a r Delegate
and introduce the search B a r Search Button Clicked(_ : )
search bar delegate method. Use this method to know when the user presses Search and to perform the geocode operation.
ViewController.swift
Expand
Use dark colors for code blocks 146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
147
148
149
150
151
152
153
154
155
156
157
157
157
157
157
158
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
151
152
153
154
155
156
157
158
159
160
161
162
extension ViewController : UISearchBarDelegate {
func searchBarSearchButtonClicked ( _ searchBar : UISearchBar ) {
searchBar.resignFirstResponder()
guard let searchText = searchBar.text, ! searchText.isEmpty else {
print ( "Nothing to search!" )
return
}
geocode(with: searchText)
}
}
Introduce the search B a r Cancel Button Clicked(_ : )
search bar delegate method. Use this method to know when the user presses Cancel and to dismiss the keyboard.
ViewController.swift
Expand
Use dark colors for code blocks 146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
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
151
152
153
154
155
156
157
158
159
160
161
162
extension ViewController : UISearchBarDelegate {
func searchBarSearchButtonClicked ( _ searchBar : UISearchBar ) {
searchBar.resignFirstResponder()
guard let searchText = searchBar.text, ! searchText.isEmpty else {
print ( "Nothing to search!" )
return
}
geocode(with: searchText)
}
func searchBarCancelButtonClicked ( _ searchBar : UISearchBar ) {
searchBar.resignFirstResponder()
}
}
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 search box on the top left of the map. Search for an address by entering an address and press Search on the keyboard. The result of the search should display on the map as a red square.
What's next? Learn how to use additional API features , ArcGIS location services , and ArcGIS tools in these tutorials: