Display an offline map (Custom)

Learn how to download and display an offline map for a user-defined geographical area of a web map.

Offline maps allow users to continue working when network connectivity is poor or lost. If a web map is enabled for offline use, a user can request that ArcGIS generates an offline map for a specified geographic area of interest.

In this tutorial, you will download an offline map for an area of interest from the web map of the stormwater network within Naperville, IL, USA. You can then use this offline map without a network connection.

Prerequisites

Steps

Open an Xcode project

1. To start the tutorial, complete the Display a web map tutorial or download and unzip the solution.

2. Open the .xcodeproj file in Xcode.

Set the API Key

An API Key enables access to services, web maps, and web scenes hosted in ArcGIS Online.

1. 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.

2. In Xcode, in the Project Navigator, click AppDelegate.swift.

3. In the editor, set the apiKey property on the AGSArcGISRuntimeEnvironment with your API key.

   
   
   AppDelegate.swift

   Show more lines

                                      

   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
   // Copyright 2021 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
   //
   //   https://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.
   
   
   import UIKit
   
   import ArcGIS
   
   
   @UIApplicationMain
   class AppDelegate: UIResponder, UIApplicationDelegate {
       var window: UIWindow?
   
       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
       }
   
   }
   

   Show more lines

Get the web map item ID

You can use ArcGIS tools to create and view web maps. Use the Map Viewer to identify the web map item ID. This item ID will be used later in the tutorial.

1. Go to the Naperville water network in the Map Viewer in ArcGIS Online. This web map displays a stormwater network within Naperville, Illinois, USA.

2. Make a note of the item ID at the end of the browser's URL.

   More info

   The item ID should be 5a030a31e42841a89914bd7c5ecf4d8f.

Display the web map

You can display a web map using the web map's item ID. Create an AGSMap from the web map's AGSPortalItem, and display it in your app's AGSMapView.

1. In Xcode, in the Project Navigator, click ViewController.swift.

2. In the editor, modify the setupMap() function. Provide the web map's item ID.

   More info

   The code creates an AGSPortalItem using the AGSPortal that references ArcGIS Online, and the web map's itemID. The portalItem is used to create an AGSMap that is displayed in the app's AGSMapView.

   ViewController.swift

   Show more lines

   33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 32 31 30 29 29 29 29 29 30 31 32 33 34 35 36 37 38 39 40 40 40 40 39 38 37 36 35 34 33 32 31 30 29 28 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 5 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 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19 -19

   Change lineChange lineChange lineChange lineChange lineChange lineChange 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
   // Copyright 2021 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
   //
   //   https://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.
   
   import UIKit
   import ArcGIS
   
   class ViewController: UIViewController {
       @IBOutlet weak var mapView: AGSMapView!
   
       override func viewDidLoad() {
           super.viewDidLoad()
   
           setupMap()
   
           setupUI()
   
           setupGraphicsOverlay()
   
       }
   
       // MARK: - Map
   
       private func setupMap() {
   
           let map = AGSMap(
               item: AGSPortalItem(
                   portal: AGSPortal.arcGISOnline(withLoginRequired: false),
                   itemID: "5a030a31e42841a89914bd7c5ecf4d8f"
               )
           )
           mapView.map = map
   
       }
   
       // MARK: - UI
   
       private func setupUI() {
           navigationItem.titleView = UIProgressView()
   
           navigationController?.isToolbarHidden = false
           let items = [
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil),
               UIBarButtonItem(title: "Download Map Area", style: .plain, target: self, action: #selector(userSelectedDownloadOfflineMap)),
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil)
           ]
           setToolbarItems(items, animated: true)
   
       }
   
       // MARK: - Graphics
   
       private let graphicsOverlay = AGSGraphicsOverlay()
   
       private func setupGraphicsOverlay() {
           graphicsOverlay.renderer = AGSSimpleRenderer(
               symbol: AGSSimpleFillSymbol(
                   style: .solid,
                   color: .clear,
                   outline: AGSSimpleLineSymbol(
                       style: .solid,
                       color: .red,
                       width: 3
                   )
               )
           )
           mapView.graphicsOverlays.add(graphicsOverlay)
       }
   
       private func addGraphic(for offlineArea: AGSGeometry) {
           let graphic = AGSGraphic(geometry: offlineArea, symbol: nil)
           graphicsOverlay.graphics.add(graphic)
       }
   
       // MARK: - Offline Map Job
   
       @objc
       func userSelectedDownloadOfflineMap(_ sender: UIBarButtonItem) {
   
           guard let offlineArea = mapView.visibleArea else { return }
   
           sender.isEnabled = false
   
           addGraphic(for: offlineArea)
   
           mapView.setViewpointGeometry(offlineArea, padding: 25)
   
           downloadOfflineMap(with: offlineArea, at: temporaryDirectoryURL)
   
       }
   
       private var temporaryDirectoryURL: URL {
           FileManager.default.temporaryDirectory
               .appendingPathComponent(ProcessInfo().globallyUniqueString)
       }
   
       private var offlineMapTask: AGSOfflineMapTask?
   
       private var offlineMapJob: AGSGenerateOfflineMapJob?
   
       private func downloadOfflineMap(with offlineArea: AGSGeometry, at downloadDirectory: URL) {
   
           guard let map = mapView.map else { return }
           offlineMapTask = AGSOfflineMapTask(onlineMap: map)
   
           offlineMapTask?.defaultGenerateOfflineMapParameters(withAreaOfInterest: offlineArea) { [weak self] parameters, error in
               guard let self = self else { return }
               guard let offlineMapTask = self.offlineMapTask else { return }
   
               if let parameters = parameters {
                   parameters.updateMode = .noUpdates
                   parameters.esriVectorTilesDownloadOption = .useReducedFontsService
                   let job = offlineMapTask.generateOfflineMapJob(with: parameters, downloadDirectory: downloadDirectory)
                   (self.navigationItem.titleView as! UIProgressView).observedProgress = job.progress
                   var n = 0
                   job.start(statusHandler: { _ in
                       while n < job.messages.count {
                           print("Job message \(n): \(job.messages[n].message)")
                           n += 1
                       }
                   }, completion: { [weak self] result, error in
                       guard let self = self else { return }
                       if let result = result {
                           self.mapView.map = result.offlineMap
                       } else if let error = error {
                           print("Error downloading the offline map: \(error)")
                           return
                       }
                   })
                   self.offlineMapJob = job
               } else if let error = error {
                   print("Error fetching default parameters for the area of interest: \(error.localizedDescription)")
               }
   
           }
   
       }
   
   }
   

   Show more lines

Setup the UI

Setup your UI with a button that allows your users to select an area to download using an AGSGenerateOfflineMapJob. Then, add a UIProgressView that reports the job's progress to your user.

1. Create a method named userSelectedDownloadOfflineMap:() and assign it the @objc keyword.

   The @objc method keyword exposes the method to Objective-C, a necessary step for using the UIBarButtonItem API.

   
   For now, leave the body of the method blank.
   ViewController.swift

   Show more lines

   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 85 84 83 82 82 82 82 82 82 82 82 82 82 82 82 82 82 82 82 82 82 82 81 80 79 77 75 73 71 69 67 65 63 62 61 61 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 40 41 42 42 42 42 42 42 42 42 42 42 42 43 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 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 -1 -2 -3 -4 -4

   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
   // Copyright 2021 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
   //
   //   https://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.
   
   import UIKit
   import ArcGIS
   
   class ViewController: UIViewController {
       @IBOutlet weak var mapView: AGSMapView!
   
       override func viewDidLoad() {
           super.viewDidLoad()
   
           setupMap()
   
           setupUI()
   
           setupGraphicsOverlay()
   
       }
   
       // MARK: - Map
   
       private func setupMap() {
   
           let map = AGSMap(
               item: AGSPortalItem(
                   portal: AGSPortal.arcGISOnline(withLoginRequired: false),
                   itemID: "5a030a31e42841a89914bd7c5ecf4d8f"
               )
           )
           mapView.map = map
   
       }
   
       // MARK: - UI
   
       private func setupUI() {
           navigationItem.titleView = UIProgressView()
   
           navigationController?.isToolbarHidden = false
           let items = [
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil),
               UIBarButtonItem(title: "Download Map Area", style: .plain, target: self, action: #selector(userSelectedDownloadOfflineMap)),
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil)
           ]
           setToolbarItems(items, animated: true)
   
       }
   
       // MARK: - Graphics
   
       private let graphicsOverlay = AGSGraphicsOverlay()
   
       private func setupGraphicsOverlay() {
           graphicsOverlay.renderer = AGSSimpleRenderer(
               symbol: AGSSimpleFillSymbol(
                   style: .solid,
                   color: .clear,
                   outline: AGSSimpleLineSymbol(
                       style: .solid,
                       color: .red,
                       width: 3
                   )
               )
           )
           mapView.graphicsOverlays.add(graphicsOverlay)
       }
   
       private func addGraphic(for offlineArea: AGSGeometry) {
           let graphic = AGSGraphic(geometry: offlineArea, symbol: nil)
           graphicsOverlay.graphics.add(graphic)
       }
   
       // MARK: - Offline Map Job
   
       @objc
       func userSelectedDownloadOfflineMap(_ sender: UIBarButtonItem) {
   
           guard let offlineArea = mapView.visibleArea else { return }
   
           sender.isEnabled = false
   
           addGraphic(for: offlineArea)
   
           mapView.setViewpointGeometry(offlineArea, padding: 25)
   
           downloadOfflineMap(with: offlineArea, at: temporaryDirectoryURL)
   
       }
   
       private var temporaryDirectoryURL: URL {
           FileManager.default.temporaryDirectory
               .appendingPathComponent(ProcessInfo().globallyUniqueString)
       }
   
       private var offlineMapTask: AGSOfflineMapTask?
   
       private var offlineMapJob: AGSGenerateOfflineMapJob?
   
       private func downloadOfflineMap(with offlineArea: AGSGeometry, at downloadDirectory: URL) {
   
           guard let map = mapView.map else { return }
           offlineMapTask = AGSOfflineMapTask(onlineMap: map)
   
           offlineMapTask?.defaultGenerateOfflineMapParameters(withAreaOfInterest: offlineArea) { [weak self] parameters, error in
               guard let self = self else { return }
               guard let offlineMapTask = self.offlineMapTask else { return }
   
               if let parameters = parameters {
                   parameters.updateMode = .noUpdates
                   parameters.esriVectorTilesDownloadOption = .useReducedFontsService
                   let job = offlineMapTask.generateOfflineMapJob(with: parameters, downloadDirectory: downloadDirectory)
                   (self.navigationItem.titleView as! UIProgressView).observedProgress = job.progress
                   var n = 0
                   job.start(statusHandler: { _ in
                       while n < job.messages.count {
                           print("Job message \(n): \(job.messages[n].message)")
                           n += 1
                       }
                   }, completion: { [weak self] result, error in
                       guard let self = self else { return }
                       if let result = result {
                           self.mapView.map = result.offlineMap
                       } else if let error = error {
                           print("Error downloading the offline map: \(error)")
                           return
                       }
                   })
                   self.offlineMapJob = job
               } else if let error = error {
                   print("Error fetching default parameters for the area of interest: \(error.localizedDescription)")
               }
   
           }
   
       }
   
   }
   

   Show more lines

2. Create a private method to setup the app's UI. Within it, create a UIProgressView and assign it to navigationItem.titleView.

   ViewController.swift

   Show more lines

   47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 46 45 44 43 43 43 43 43 43 43 43 43 43 43 43 43 43 43 43 43 43 43 44 45 46 46 46 46 46 46 46 46 46 47 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 25 25 25 25 25 24 23 22 21 20 19 18 17 16 15 15 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 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -32

   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
   // Copyright 2021 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
   //
   //   https://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.
   
   import UIKit
   import ArcGIS
   
   class ViewController: UIViewController {
       @IBOutlet weak var mapView: AGSMapView!
   
       override func viewDidLoad() {
           super.viewDidLoad()
   
           setupMap()
   
           setupUI()
   
           setupGraphicsOverlay()
   
       }
   
       // MARK: - Map
   
       private func setupMap() {
   
           let map = AGSMap(
               item: AGSPortalItem(
                   portal: AGSPortal.arcGISOnline(withLoginRequired: false),
                   itemID: "5a030a31e42841a89914bd7c5ecf4d8f"
               )
           )
           mapView.map = map
   
       }
   
       // MARK: - UI
   
       private func setupUI() {
           navigationItem.titleView = UIProgressView()
   
           navigationController?.isToolbarHidden = false
           let items = [
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil),
               UIBarButtonItem(title: "Download Map Area", style: .plain, target: self, action: #selector(userSelectedDownloadOfflineMap)),
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil)
           ]
           setToolbarItems(items, animated: true)
   
       }
   
       // MARK: - Graphics
   
       private let graphicsOverlay = AGSGraphicsOverlay()
   
       private func setupGraphicsOverlay() {
           graphicsOverlay.renderer = AGSSimpleRenderer(
               symbol: AGSSimpleFillSymbol(
                   style: .solid,
                   color: .clear,
                   outline: AGSSimpleLineSymbol(
                       style: .solid,
                       color: .red,
                       width: 3
                   )
               )
           )
           mapView.graphicsOverlays.add(graphicsOverlay)
       }
   
       private func addGraphic(for offlineArea: AGSGeometry) {
           let graphic = AGSGraphic(geometry: offlineArea, symbol: nil)
           graphicsOverlay.graphics.add(graphic)
       }
   
       // MARK: - Offline Map Job
   
       @objc
       func userSelectedDownloadOfflineMap(_ sender: UIBarButtonItem) {
   
           guard let offlineArea = mapView.visibleArea else { return }
   
           sender.isEnabled = false
   
           addGraphic(for: offlineArea)
   
           mapView.setViewpointGeometry(offlineArea, padding: 25)
   
           downloadOfflineMap(with: offlineArea, at: temporaryDirectoryURL)
   
       }
   
       private var temporaryDirectoryURL: URL {
           FileManager.default.temporaryDirectory
               .appendingPathComponent(ProcessInfo().globallyUniqueString)
       }
   
       private var offlineMapTask: AGSOfflineMapTask?
   
       private var offlineMapJob: AGSGenerateOfflineMapJob?
   
       private func downloadOfflineMap(with offlineArea: AGSGeometry, at downloadDirectory: URL) {
   
           guard let map = mapView.map else { return }
           offlineMapTask = AGSOfflineMapTask(onlineMap: map)
   
           offlineMapTask?.defaultGenerateOfflineMapParameters(withAreaOfInterest: offlineArea) { [weak self] parameters, error in
               guard let self = self else { return }
               guard let offlineMapTask = self.offlineMapTask else { return }
   
               if let parameters = parameters {
                   parameters.updateMode = .noUpdates
                   parameters.esriVectorTilesDownloadOption = .useReducedFontsService
                   let job = offlineMapTask.generateOfflineMapJob(with: parameters, downloadDirectory: downloadDirectory)
                   (self.navigationItem.titleView as! UIProgressView).observedProgress = job.progress
                   var n = 0
                   job.start(statusHandler: { _ in
                       while n < job.messages.count {
                           print("Job message \(n): \(job.messages[n].message)")
                           n += 1
                       }
                   }, completion: { [weak self] result, error in
                       guard let self = self else { return }
                       if let result = result {
                           self.mapView.map = result.offlineMap
                       } else if let error = error {
                           print("Error downloading the offline map: \(error)")
                           return
                       }
                   })
                   self.offlineMapJob = job
               } else if let error = error {
                   print("Error fetching default parameters for the area of interest: \(error.localizedDescription)")
               }
   
           }
   
       }
   
   }
   

   Show more lines

3. Reveal the navigation controller's toolbar and create a UIBarButtonItem that allows your user to select an area of the map to take offline.

   More info

   The code creates an array of three UIBarButtonItem objects. The first and last objects reserve flexible space within the toolbar and the middle object is the download button. The button's title reads, "Download Map Area", and tapping it performs the method userSelectedDownloadOfflineMap:().

   ViewController.swift

   Show more lines

   47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 47 46 45 44 43 43 43 43 43 43 43 43 43 43 43 43 43 43 43 43 43 43 43 44 45 46 47 48 49 50 51 52 53 54 55 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 33 33 33 33 33 32 31 30 29 28 27 26 25 24 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 -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -24

   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
   // Copyright 2021 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
   //
   //   https://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.
   
   import UIKit
   import ArcGIS
   
   class ViewController: UIViewController {
       @IBOutlet weak var mapView: AGSMapView!
   
       override func viewDidLoad() {
           super.viewDidLoad()
   
           setupMap()
   
           setupUI()
   
           setupGraphicsOverlay()
   
       }
   
       // MARK: - Map
   
       private func setupMap() {
   
           let map = AGSMap(
               item: AGSPortalItem(
                   portal: AGSPortal.arcGISOnline(withLoginRequired: false),
                   itemID: "5a030a31e42841a89914bd7c5ecf4d8f"
               )
           )
           mapView.map = map
   
       }
   
       // MARK: - UI
   
       private func setupUI() {
           navigationItem.titleView = UIProgressView()
   
           navigationController?.isToolbarHidden = false
           let items = [
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil),
               UIBarButtonItem(title: "Download Map Area", style: .plain, target: self, action: #selector(userSelectedDownloadOfflineMap)),
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil)
           ]
           setToolbarItems(items, animated: true)
   
       }
   
       // MARK: - Graphics
   
       private let graphicsOverlay = AGSGraphicsOverlay()
   
       private func setupGraphicsOverlay() {
           graphicsOverlay.renderer = AGSSimpleRenderer(
               symbol: AGSSimpleFillSymbol(
                   style: .solid,
                   color: .clear,
                   outline: AGSSimpleLineSymbol(
                       style: .solid,
                       color: .red,
                       width: 3
                   )
               )
           )
           mapView.graphicsOverlays.add(graphicsOverlay)
       }
   
       private func addGraphic(for offlineArea: AGSGeometry) {
           let graphic = AGSGraphic(geometry: offlineArea, symbol: nil)
           graphicsOverlay.graphics.add(graphic)
       }
   
       // MARK: - Offline Map Job
   
       @objc
       func userSelectedDownloadOfflineMap(_ sender: UIBarButtonItem) {
   
           guard let offlineArea = mapView.visibleArea else { return }
   
           sender.isEnabled = false
   
           addGraphic(for: offlineArea)
   
           mapView.setViewpointGeometry(offlineArea, padding: 25)
   
           downloadOfflineMap(with: offlineArea, at: temporaryDirectoryURL)
   
       }
   
       private var temporaryDirectoryURL: URL {
           FileManager.default.temporaryDirectory
               .appendingPathComponent(ProcessInfo().globallyUniqueString)
       }
   
       private var offlineMapTask: AGSOfflineMapTask?
   
       private var offlineMapJob: AGSGenerateOfflineMapJob?
   
       private func downloadOfflineMap(with offlineArea: AGSGeometry, at downloadDirectory: URL) {
   
           guard let map = mapView.map else { return }
           offlineMapTask = AGSOfflineMapTask(onlineMap: map)
   
           offlineMapTask?.defaultGenerateOfflineMapParameters(withAreaOfInterest: offlineArea) { [weak self] parameters, error in
               guard let self = self else { return }
               guard let offlineMapTask = self.offlineMapTask else { return }
   
               if let parameters = parameters {
                   parameters.updateMode = .noUpdates
                   parameters.esriVectorTilesDownloadOption = .useReducedFontsService
                   let job = offlineMapTask.generateOfflineMapJob(with: parameters, downloadDirectory: downloadDirectory)
                   (self.navigationItem.titleView as! UIProgressView).observedProgress = job.progress
                   var n = 0
                   job.start(statusHandler: { _ in
                       while n < job.messages.count {
                           print("Job message \(n): \(job.messages[n].message)")
                           n += 1
                       }
                   }, completion: { [weak self] result, error in
                       guard let self = self else { return }
                       if let result = result {
                           self.mapView.map = result.offlineMap
                       } else if let error = error {
                           print("Error downloading the offline map: \(error)")
                           return
                       }
                   })
                   self.offlineMapJob = job
               } else if let error = error {
                   print("Error fetching default parameters for the area of interest: \(error.localizedDescription)")
               }
   
           }
   
       }
   
   }
   

   Show more lines

4. In the viewDidLoad() method, call setupUI().

   ViewController.swift

   Show more lines

   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 27 27 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 6 6 6 6 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 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 -48 -49 -50 -51 -51

   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
   // Copyright 2021 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
   //
   //   https://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.
   
   import UIKit
   import ArcGIS
   
   class ViewController: UIViewController {
       @IBOutlet weak var mapView: AGSMapView!
   
       override func viewDidLoad() {
           super.viewDidLoad()
   
           setupMap()
   
           setupUI()
   
           setupGraphicsOverlay()
   
       }
   
       // MARK: - Map
   
       private func setupMap() {
   
           let map = AGSMap(
               item: AGSPortalItem(
                   portal: AGSPortal.arcGISOnline(withLoginRequired: false),
                   itemID: "5a030a31e42841a89914bd7c5ecf4d8f"
               )
           )
           mapView.map = map
   
       }
   
       // MARK: - UI
   
       private func setupUI() {
           navigationItem.titleView = UIProgressView()
   
           navigationController?.isToolbarHidden = false
           let items = [
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil),
               UIBarButtonItem(title: "Download Map Area", style: .plain, target: self, action: #selector(userSelectedDownloadOfflineMap)),
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil)
           ]
           setToolbarItems(items, animated: true)
   
       }
   
       // MARK: - Graphics
   
       private let graphicsOverlay = AGSGraphicsOverlay()
   
       private func setupGraphicsOverlay() {
           graphicsOverlay.renderer = AGSSimpleRenderer(
               symbol: AGSSimpleFillSymbol(
                   style: .solid,
                   color: .clear,
                   outline: AGSSimpleLineSymbol(
                       style: .solid,
                       color: .red,
                       width: 3
                   )
               )
           )
           mapView.graphicsOverlays.add(graphicsOverlay)
       }
   
       private func addGraphic(for offlineArea: AGSGeometry) {
           let graphic = AGSGraphic(geometry: offlineArea, symbol: nil)
           graphicsOverlay.graphics.add(graphic)
       }
   
       // MARK: - Offline Map Job
   
       @objc
       func userSelectedDownloadOfflineMap(_ sender: UIBarButtonItem) {
   
           guard let offlineArea = mapView.visibleArea else { return }
   
           sender.isEnabled = false
   
           addGraphic(for: offlineArea)
   
           mapView.setViewpointGeometry(offlineArea, padding: 25)
   
           downloadOfflineMap(with: offlineArea, at: temporaryDirectoryURL)
   
       }
   
       private var temporaryDirectoryURL: URL {
           FileManager.default.temporaryDirectory
               .appendingPathComponent(ProcessInfo().globallyUniqueString)
       }
   
       private var offlineMapTask: AGSOfflineMapTask?
   
       private var offlineMapJob: AGSGenerateOfflineMapJob?
   
       private func downloadOfflineMap(with offlineArea: AGSGeometry, at downloadDirectory: URL) {
   
           guard let map = mapView.map else { return }
           offlineMapTask = AGSOfflineMapTask(onlineMap: map)
   
           offlineMapTask?.defaultGenerateOfflineMapParameters(withAreaOfInterest: offlineArea) { [weak self] parameters, error in
               guard let self = self else { return }
               guard let offlineMapTask = self.offlineMapTask else { return }
   
               if let parameters = parameters {
                   parameters.updateMode = .noUpdates
                   parameters.esriVectorTilesDownloadOption = .useReducedFontsService
                   let job = offlineMapTask.generateOfflineMapJob(with: parameters, downloadDirectory: downloadDirectory)
                   (self.navigationItem.titleView as! UIProgressView).observedProgress = job.progress
                   var n = 0
                   job.start(statusHandler: { _ in
                       while n < job.messages.count {
                           print("Job message \(n): \(job.messages[n].message)")
                           n += 1
                       }
                   }, completion: { [weak self] result, error in
                       guard let self = self else { return }
                       if let result = result {
                           self.mapView.map = result.offlineMap
                       } else if let error = error {
                           print("Error downloading the offline map: \(error)")
                           return
                       }
                   })
                   self.offlineMapJob = job
               } else if let error = error {
                   print("Error fetching default parameters for the area of interest: \(error.localizedDescription)")
               }
   
           }
   
       }
   
   }
   

   Show more lines

5. In Xcode, in the Project Navigator, click Main.storyboard.

6. In the editor, select ViewController, and in the menu bar, click Editor > Embed In > Navigation Controller.

   More info

   Embedding ViewController within a Navigation Controller will place a navigation bar at the top of ViewController. Inside the navigation bar you will find the progress view.

Setup the offline area graphics

A graphics overlay is a container for graphics. A graphic is added to display the selected offline area on the map.

1. In Xcode, in the Project Navigator, click ViewController.swift.

2. In the editor, create a private AGSGraphicsOverlay property to contain an offline area graphic.

   ViewController.swift

   Show more lines

   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 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 61 62 62 62 62 62 62 62 62 62 62 62 62 62 62 62 62 62 62 62 62 61 61 61 61 61 61 60 59 58 57 56 55 54 53 52 51 51 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 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 4

   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
   // Copyright 2021 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
   //
   //   https://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.
   
   import UIKit
   import ArcGIS
   
   class ViewController: UIViewController {
       @IBOutlet weak var mapView: AGSMapView!
   
       override func viewDidLoad() {
           super.viewDidLoad()
   
           setupMap()
   
           setupUI()
   
           setupGraphicsOverlay()
   
       }
   
       // MARK: - Map
   
       private func setupMap() {
   
           let map = AGSMap(
               item: AGSPortalItem(
                   portal: AGSPortal.arcGISOnline(withLoginRequired: false),
                   itemID: "5a030a31e42841a89914bd7c5ecf4d8f"
               )
           )
           mapView.map = map
   
       }
   
       // MARK: - UI
   
       private func setupUI() {
           navigationItem.titleView = UIProgressView()
   
           navigationController?.isToolbarHidden = false
           let items = [
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil),
               UIBarButtonItem(title: "Download Map Area", style: .plain, target: self, action: #selector(userSelectedDownloadOfflineMap)),
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil)
           ]
           setToolbarItems(items, animated: true)
   
       }
   
       // MARK: - Graphics
   
       private let graphicsOverlay = AGSGraphicsOverlay()
   
       private func setupGraphicsOverlay() {
           graphicsOverlay.renderer = AGSSimpleRenderer(
               symbol: AGSSimpleFillSymbol(
                   style: .solid,
                   color: .clear,
                   outline: AGSSimpleLineSymbol(
                       style: .solid,
                       color: .red,
                       width: 3
                   )
               )
           )
           mapView.graphicsOverlays.add(graphicsOverlay)
       }
   
       private func addGraphic(for offlineArea: AGSGeometry) {
           let graphic = AGSGraphic(geometry: offlineArea, symbol: nil)
           graphicsOverlay.graphics.add(graphic)
       }
   
       // MARK: - Offline Map Job
   
       @objc
       func userSelectedDownloadOfflineMap(_ sender: UIBarButtonItem) {
   
           guard let offlineArea = mapView.visibleArea else { return }
   
           sender.isEnabled = false
   
           addGraphic(for: offlineArea)
   
           mapView.setViewpointGeometry(offlineArea, padding: 25)
   
           downloadOfflineMap(with: offlineArea, at: temporaryDirectoryURL)
   
       }
   
       private var temporaryDirectoryURL: URL {
           FileManager.default.temporaryDirectory
               .appendingPathComponent(ProcessInfo().globallyUniqueString)
       }
   
       private var offlineMapTask: AGSOfflineMapTask?
   
       private var offlineMapJob: AGSGenerateOfflineMapJob?
   
       private func downloadOfflineMap(with offlineArea: AGSGeometry, at downloadDirectory: URL) {
   
           guard let map = mapView.map else { return }
           offlineMapTask = AGSOfflineMapTask(onlineMap: map)
   
           offlineMapTask?.defaultGenerateOfflineMapParameters(withAreaOfInterest: offlineArea) { [weak self] parameters, error in
               guard let self = self else { return }
               guard let offlineMapTask = self.offlineMapTask else { return }
   
               if let parameters = parameters {
                   parameters.updateMode = .noUpdates
                   parameters.esriVectorTilesDownloadOption = .useReducedFontsService
                   let job = offlineMapTask.generateOfflineMapJob(with: parameters, downloadDirectory: downloadDirectory)
                   (self.navigationItem.titleView as! UIProgressView).observedProgress = job.progress
                   var n = 0
                   job.start(statusHandler: { _ in
                       while n < job.messages.count {
                           print("Job message \(n): \(job.messages[n].message)")
                           n += 1
                       }
                   }, completion: { [weak self] result, error in
                       guard let self = self else { return }
                       if let result = result {
                           self.mapView.map = result.offlineMap
                       } else if let error = error {
                           print("Error downloading the offline map: \(error)")
                           return
                       }
                   })
                   self.offlineMapJob = job
               } else if let error = error {
                   print("Error fetching default parameters for the area of interest: \(error.localizedDescription)")
               }
   
           }
   
       }
   
   }
   

   Show more lines

3. Define a private method to setup the graphics overlay. In the method, create an AGSSimpleRenderer to render graphics. Define a symbol for the renderer using an AGSSimpleFillSymbol and an AGSSimpleLineSymbol.

   ViewController.swift

   Show more lines

   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 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 77 77 77 77 76 76 76 76 76 76 75 74 73 72 71 70 69 68 67 66 66 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 38 37 36 35 34 33 32 31 30 29 28 27 26 25 24 23 22 21 20 19 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.

   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
   // Copyright 2021 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
   //
   //   https://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.
   
   import UIKit
   import ArcGIS
   
   class ViewController: UIViewController {
       @IBOutlet weak var mapView: AGSMapView!
   
       override func viewDidLoad() {
           super.viewDidLoad()
   
           setupMap()
   
           setupUI()
   
           setupGraphicsOverlay()
   
       }
   
       // MARK: - Map
   
       private func setupMap() {
   
           let map = AGSMap(
               item: AGSPortalItem(
                   portal: AGSPortal.arcGISOnline(withLoginRequired: false),
                   itemID: "5a030a31e42841a89914bd7c5ecf4d8f"
               )
           )
           mapView.map = map
   
       }
   
       // MARK: - UI
   
       private func setupUI() {
           navigationItem.titleView = UIProgressView()
   
           navigationController?.isToolbarHidden = false
           let items = [
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil),
               UIBarButtonItem(title: "Download Map Area", style: .plain, target: self, action: #selector(userSelectedDownloadOfflineMap)),
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil)
           ]
           setToolbarItems(items, animated: true)
   
       }
   
       // MARK: - Graphics
   
       private let graphicsOverlay = AGSGraphicsOverlay()
   
       private func setupGraphicsOverlay() {
           graphicsOverlay.renderer = AGSSimpleRenderer(
               symbol: AGSSimpleFillSymbol(
                   style: .solid,
                   color: .clear,
                   outline: AGSSimpleLineSymbol(
                       style: .solid,
                       color: .red,
                       width: 3
                   )
               )
           )
           mapView.graphicsOverlays.add(graphicsOverlay)
       }
   
       private func addGraphic(for offlineArea: AGSGeometry) {
           let graphic = AGSGraphic(geometry: offlineArea, symbol: nil)
           graphicsOverlay.graphics.add(graphic)
       }
   
       // MARK: - Offline Map Job
   
       @objc
       func userSelectedDownloadOfflineMap(_ sender: UIBarButtonItem) {
   
           guard let offlineArea = mapView.visibleArea else { return }
   
           sender.isEnabled = false
   
           addGraphic(for: offlineArea)
   
           mapView.setViewpointGeometry(offlineArea, padding: 25)
   
           downloadOfflineMap(with: offlineArea, at: temporaryDirectoryURL)
   
       }
   
       private var temporaryDirectoryURL: URL {
           FileManager.default.temporaryDirectory
               .appendingPathComponent(ProcessInfo().globallyUniqueString)
       }
   
       private var offlineMapTask: AGSOfflineMapTask?
   
       private var offlineMapJob: AGSGenerateOfflineMapJob?
   
       private func downloadOfflineMap(with offlineArea: AGSGeometry, at downloadDirectory: URL) {
   
           guard let map = mapView.map else { return }
           offlineMapTask = AGSOfflineMapTask(onlineMap: map)
   
           offlineMapTask?.defaultGenerateOfflineMapParameters(withAreaOfInterest: offlineArea) { [weak self] parameters, error in
               guard let self = self else { return }
               guard let offlineMapTask = self.offlineMapTask else { return }
   
               if let parameters = parameters {
                   parameters.updateMode = .noUpdates
                   parameters.esriVectorTilesDownloadOption = .useReducedFontsService
                   let job = offlineMapTask.generateOfflineMapJob(with: parameters, downloadDirectory: downloadDirectory)
                   (self.navigationItem.titleView as! UIProgressView).observedProgress = job.progress
                   var n = 0
                   job.start(statusHandler: { _ in
                       while n < job.messages.count {
                           print("Job message \(n): \(job.messages[n].message)")
                           n += 1
                       }
                   }, completion: { [weak self] result, error in
                       guard let self = self else { return }
                       if let result = result {
                           self.mapView.map = result.offlineMap
                       } else if let error = error {
                           print("Error downloading the offline map: \(error)")
                           return
                       }
                   })
                   self.offlineMapJob = job
               } else if let error = error {
                   print("Error fetching default parameters for the area of interest: \(error.localizedDescription)")
               }
   
           }
   
       }
   
   }
   

   Show more lines

4. Define a private method named that adds a graphic to the graphics overlay for the supplied offlineArea geometry.

   ViewController.swift

   Show more lines

   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 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 81 81 81 81 81 81 80 79 78 77 76 75 74 73 72 71 71 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 38 37 36 35 34 33 32 31 30 29 28 27 26 25 24 24

   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
   // Copyright 2021 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
   //
   //   https://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.
   
   import UIKit
   import ArcGIS
   
   class ViewController: UIViewController {
       @IBOutlet weak var mapView: AGSMapView!
   
       override func viewDidLoad() {
           super.viewDidLoad()
   
           setupMap()
   
           setupUI()
   
           setupGraphicsOverlay()
   
       }
   
       // MARK: - Map
   
       private func setupMap() {
   
           let map = AGSMap(
               item: AGSPortalItem(
                   portal: AGSPortal.arcGISOnline(withLoginRequired: false),
                   itemID: "5a030a31e42841a89914bd7c5ecf4d8f"
               )
           )
           mapView.map = map
   
       }
   
       // MARK: - UI
   
       private func setupUI() {
           navigationItem.titleView = UIProgressView()
   
           navigationController?.isToolbarHidden = false
           let items = [
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil),
               UIBarButtonItem(title: "Download Map Area", style: .plain, target: self, action: #selector(userSelectedDownloadOfflineMap)),
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil)
           ]
           setToolbarItems(items, animated: true)
   
       }
   
       // MARK: - Graphics
   
       private let graphicsOverlay = AGSGraphicsOverlay()
   
       private func setupGraphicsOverlay() {
           graphicsOverlay.renderer = AGSSimpleRenderer(
               symbol: AGSSimpleFillSymbol(
                   style: .solid,
                   color: .clear,
                   outline: AGSSimpleLineSymbol(
                       style: .solid,
                       color: .red,
                       width: 3
                   )
               )
           )
           mapView.graphicsOverlays.add(graphicsOverlay)
       }
   
       private func addGraphic(for offlineArea: AGSGeometry) {
           let graphic = AGSGraphic(geometry: offlineArea, symbol: nil)
           graphicsOverlay.graphics.add(graphic)
       }
   
       // MARK: - Offline Map Job
   
       @objc
       func userSelectedDownloadOfflineMap(_ sender: UIBarButtonItem) {
   
           guard let offlineArea = mapView.visibleArea else { return }
   
           sender.isEnabled = false
   
           addGraphic(for: offlineArea)
   
           mapView.setViewpointGeometry(offlineArea, padding: 25)
   
           downloadOfflineMap(with: offlineArea, at: temporaryDirectoryURL)
   
       }
   
       private var temporaryDirectoryURL: URL {
           FileManager.default.temporaryDirectory
               .appendingPathComponent(ProcessInfo().globallyUniqueString)
       }
   
       private var offlineMapTask: AGSOfflineMapTask?
   
       private var offlineMapJob: AGSGenerateOfflineMapJob?
   
       private func downloadOfflineMap(with offlineArea: AGSGeometry, at downloadDirectory: URL) {
   
           guard let map = mapView.map else { return }
           offlineMapTask = AGSOfflineMapTask(onlineMap: map)
   
           offlineMapTask?.defaultGenerateOfflineMapParameters(withAreaOfInterest: offlineArea) { [weak self] parameters, error in
               guard let self = self else { return }
               guard let offlineMapTask = self.offlineMapTask else { return }
   
               if let parameters = parameters {
                   parameters.updateMode = .noUpdates
                   parameters.esriVectorTilesDownloadOption = .useReducedFontsService
                   let job = offlineMapTask.generateOfflineMapJob(with: parameters, downloadDirectory: downloadDirectory)
                   (self.navigationItem.titleView as! UIProgressView).observedProgress = job.progress
                   var n = 0
                   job.start(statusHandler: { _ in
                       while n < job.messages.count {
                           print("Job message \(n): \(job.messages[n].message)")
                           n += 1
                       }
                   }, completion: { [weak self] result, error in
                       guard let self = self else { return }
                       if let result = result {
                           self.mapView.map = result.offlineMap
                       } else if let error = error {
                           print("Error downloading the offline map: \(error)")
                           return
                       }
                   })
                   self.offlineMapJob = job
               } else if let error = error {
                   print("Error fetching default parameters for the area of interest: \(error.localizedDescription)")
               }
   
           }
   
       }
   
   }
   

   Show more lines

5. In the viewDidLoad() method, call setupGraphicsOverlay().

   ViewController.swift

   Show more lines

   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 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 29 28 27 26 25 24 23 22 21 20 20 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 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -27

   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
   // Copyright 2021 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
   //
   //   https://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.
   
   import UIKit
   import ArcGIS
   
   class ViewController: UIViewController {
       @IBOutlet weak var mapView: AGSMapView!
   
       override func viewDidLoad() {
           super.viewDidLoad()
   
           setupMap()
   
           setupUI()
   
           setupGraphicsOverlay()
   
       }
   
       // MARK: - Map
   
       private func setupMap() {
   
           let map = AGSMap(
               item: AGSPortalItem(
                   portal: AGSPortal.arcGISOnline(withLoginRequired: false),
                   itemID: "5a030a31e42841a89914bd7c5ecf4d8f"
               )
           )
           mapView.map = map
   
       }
   
       // MARK: - UI
   
       private func setupUI() {
           navigationItem.titleView = UIProgressView()
   
           navigationController?.isToolbarHidden = false
           let items = [
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil),
               UIBarButtonItem(title: "Download Map Area", style: .plain, target: self, action: #selector(userSelectedDownloadOfflineMap)),
               UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil)
           ]
           setToolbarItems(items, animated: true)
   
       }
   
       // MARK: - Graphics
   
       private let graphicsOverlay = AGSGraphicsOverlay()
   
       private func setupGraphicsOverlay() {
           graphicsOverlay.renderer = AGSSimpleRenderer(
               symbol: AGSSimpleFillSymbol(
                   style: .solid,
                   color: .clear,
                   outline: AGSSimpleLineSymbol(
                       style: .solid,
                       color: .red,
                       width: 3
                   )
               )
           )
           mapView.graphicsOverlays.add(graphicsOverlay)
       }
   
       private func addGraphic(for offlineArea: AGSGeometry) {
           let graphic = AGSGraphic(geometry: offlineArea, symbol: nil)
           graphicsOverlay.graphics.add(graphic)
       }
   
       // MARK: - Offline Map Job
   
       @objc
       func userSelectedDownloadOfflineMap(_ sender: UIBarButtonItem) {
   
           guard let offlineArea = mapView.visibleArea else { return }
   
           sender.isEnabled = false
   
           addGraphic(for: offlineArea)
   
           mapView.setViewpointGeometry(offlineArea, padding: 25)
   
           downloadOfflineMap(with: offlineArea, at: temporaryDirectoryURL)
   
       }
   
       private var temporaryDirectoryURL: URL {
           FileManager.default.temporaryDirectory
               .appendingPathComponent(ProcessInfo().globallyUniqueString)
       }
   
       private var offlineMapTask: AGSOfflineMapTask?
   
       private var offlineMapJob: AGSGenerateOfflineMapJob?
   
       private func downloadOfflineMap(with offlineArea: AGSGeometry, at downloadDirectory: URL) {
   
           guard let map = mapView.map else { return }
           offlineMapTask = AGSOfflineMapTask(onlineMap: map)
   
           offlineMapTask?.defaultGenerateOfflineMapParameters(withAreaOfInterest: offlineArea) { [weak self] parameters, error in
               guard let self = self else { return }
               guard let offlineMapTask = self.offlineMapTask else { return }
   
               if let parameters = parameters {
                   parameters.updateMode = .noUpdates
                   parameters.esriVectorTilesDownloadOption = .useReducedFontsService
                   let job = offlineMapTask.generateOfflineMapJob(with: parameters, downloadDirectory: downloadDirectory)
                   (self.navigationItem.titleView as! UIProgressView).observedProgress = job.progress
                   var n = 0
                   job.start(statusHandler: { _ in
                       while n < job.messages.count {
                           print("Job message \(n): \(job.messages[n].message)")
                           n += 1
                       }
                   }, completion: { [weak self] result, error in
                       guard let self = self else { return }
                       if let result = result {
                           self.mapView.map = result.offlineMap
                       } else if let error = error {
                           print("Error downloading the offline map: \(error)")
                           return
                       }
                   })
                   self.offlineMapJob = job
               } else if let error = error {
                   print("Error fetching default parameters for the area of interest: \(error.localizedDescription)")
               }
   
           }
   
       }
   
   }
   

   Show more lines