Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://developers.arcgis.com/swift/maps-2d/tutorials/display-a-map/ below:

Display a map | ArcGIS Maps SDK for Swift

Learn how to create and display a map with a basemap layer.

A map contains layers of geographic data. A map contains a basemap layer and, optionally, one or more data layers. You can display a specific area of a map by using a map view and setting the location and zoom level.

In this tutorial, you create and display a map of the Santa Monica Mountains in California using the topographic basemap layer.

The map and code will be used as the starting point for other 2D tutorials.

For more background information about the topics in this tutorial, visit Maps (2D) and Basemaps.

Before starting this tutorial:

1. You need an ArcGIS Location Platform or ArcGIS Online account.

2. Your system meets the system requirements.

To access the secure ArcGIS location services used in this tutorial, you must implement API key authentication or user authentication using an ArcGIS Location Platform or an ArcGIS Online account.

You can implement API key authentication or user authentication in this tutorial. Compare the differences below:

API key authentication

• Users are not required to sign in.
• Requires creating an API key credential with the correct privileges.
• API keys are long-lived access tokens.
• Service usage is billed to the API key owner/developer.
• Simplest authentication method to implement.
• Recommended approach for new ArcGIS developers.

Learn more in API key authentication.

User authentication

• Users are required to sign in with an ArcGIS account.
• User accounts must have privilege to access the ArcGIS services used in application.
• Requires creating OAuth credentials.
• Application uses a redirect URL and client ID.
• Service usage is billed to the organization of the user signed into the application.

Learn more in User authentication.

To learn more about the different types of authentication, visit Types of authentication.

Create a new API key access token with privileges to access the secure resources used in this tutorial.

1. Complete the Create an API key tutorial and create an API key with the following privilege(s):

   • Privileges
     • Location services > Basemaps

2. Copy and paste the API key access token into a safe location. It will be used in a later step.

Create new OAuth credentials to access the secure resources used in this tutorial.

1. Complete the Create OAuth credentials for user authentication tutorial to obtain a Client ID and Redirect URL.

   A Client ID uniquely identifies your app on the authenticating server. If the server cannot find an app with the provided Client ID, it will not proceed with authentication.

   The Redirect URL (also referred to as a callback url) is used to identify a response from the authenticating server when the system returns control back to your app after an OAuth login. Since it does not necessarily represent a valid endpoint that a user could navigate to, the redirect URL can use a custom scheme, such as my-app://auth. It is important to make sure the redirect URL used in your app's code matches a redirect URL configured on the authenticating server.

2. Copy and paste the Client ID and Redirect URL into a safe location. They will be used in a later step.

All users that access this application need account privileges to access the ArcGIS Basemap Styles service.

You have two options for completing this tutorial:

1. Option 1: Develop the code or
2. Option 2: Download the completed solution

To get started, use Xcode to create an iOS app and configure it to reference the API.

1. Open Xcode. In the menu bar, click File > New > Project.

   • In the Choose a template for your new project: window, set the following properties:
     • Multiplatform iOS
     • Application App
   • Click Next.
   • In the Choose options for your new project: window, set the following properties:
     • Product Name: <your app name>
     • Organization Identifier: <your organization>
     • Interface: SwiftUI
     • Language: Swift
   • Uncheck all other options.
   • Click Next.
   • Choose a location to store your project. Click Create.

2. In the Project Navigator, click <your app name>App. In the Editor, right click on the struct name, <your app name>App. Select Refactor > Rename... to rename the struct to MainApp. Click the Rename button in the top right to confirm the new name. This will rename the struct and file in all affected areas. This file and struct will be named MainApp for all the subsequent tutorials.

3. Add a reference to the API using Swift Package Manager.

4. In the MainApp.swift file, some errors may appear after importing ArcGIS. Resolve the errors by distinguishing the Scene protocol from Scene. To do so, add the SwiftUI prefix to Scene.

   MainApp.swift

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
       var body: some SwiftUI.Scene {
   
           WindowGroup {
               ContentView()
   
           }
       }
   

To allow your app users to access ArcGIS location services, use the developer credentials that you created in the Set up authentication step to authenticate requests for resources.

Pass your API Key access token to the ArcGISEnvironment.

1. In the Project Navigator, click MainApp.swift.

2. Implement an initializer in the MainApp struct and set the ArcGISEnvironment.apiKey property with your API key access token.

   MainApp.swift

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   
   import SwiftUI
   
   import ArcGIS
   
   @main
   struct MainApp: App {
   
       init() {
   
           ArcGISEnvironment.apiKey = APIKey("<#YOUR-ACCESS-TOKEN#>")
   
       }
   

Best Practice: The access token is stored directly in the code as a convenience for this tutorial. Do not store credentials directly in source code in a production environment.

Use the Authenticator toolkit component to manage your OAuth credentials and pass it to the ArcGISEnvironment.

1. Add the ArcGIS Maps SDK for Swift Toolkit package to your application by following these instructions.

2. In the Project Navigator, click MainApp.swift.

   • Add import ArcGISToolkit into the code.
   • Declare and initialize an Authenticator toolkit component in the MainApp struct.
   • Implement an initializer in the MainApp struct.
   • Create a new instance of the Authenticator using an OAuthUserConfiguration
   • Add your PortalURL, clientID and redirectURL values.
   • Pass the authenticator to the ArcGISEnvironment.authenticationManager to handle any challenges.

   MainApp.swift

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   
   import SwiftUI
   
   import ArcGIS
   
   import ArcGISToolkit
   
   @main
   struct MainApp: App {
   
       @ObservedObject var authenticator: Authenticator
   
       init() {
   
           authenticator = Authenticator(oAuthUserConfigurations: [
               OAuthUserConfiguration(
   
                   portalURL: URL(string: "<#YOUR-PORTAL-URL#>")!,
                   clientID: ""<#YOUR-CLIENT-ID#>"",
                   redirectURL: URL(string: "<#YOUR-REDIRECT-URL#>")!
   
               )
           ])
           ArcGISEnvironment.authenticationManager.handleChallenges(using: authenticator)
   
       }
   

   • In the body, add an .authenticator(authenticator) modifier to the ContentView.

   MainApp.swift

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
       var body: some SwiftUI.Scene {
   
           WindowGroup {
               ContentView()
   
                   .authenticator(authenticator)
   
           }
       }
   

Best Practice: The OAuth credentials are stored directly in the code as a convenience for this tutorial. Do not store credentials directly in source code in a production environment.

Create a map that contains a topographic basemap layer. The map will be centered on the Santa Monica Mountains in California.

1. In the Project Navigator, click ContentView.swift.

2. In the Editor, add an import statement to reference the API.

   ContentView.swift

   Use dark colors for code blocks

   15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 16 17 18 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19

   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
   import SwiftUI
   
   import ArcGIS
   
   

3. Add a @State property wrapper named map of type Map with a default value. Create a Map with an arcGISTopographic basemap style and return it.

   ContentView.swift

   Use dark colors for code blocks

   19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 19 20 21 22 23 24 24 24 25 26 27 27 27 27 27 27 27 27 28

   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
   struct ContentView: View {
   
       @State private var map = {
           let map = Map(basemapStyle: .arcGISTopographic)
   
           return map
       }()
   
   }

   Attention

   ArcGIS Enterprise users do not have access to the ArcGIS Location basemap styles service. If you are building an app for ArcGIS Enterprise users, you need to create a Map with a basemap that is accessible to them.

4. Set the map's initialViewpoint property with a Viewpoint using the Santa Monica Mountains coordinates.

   ContentView.swift

   Use dark colors for code blocks

   21 21 21 21 21 21 21 21 21 21 21 21 21 21 21 21 21 21 21 21 21 22 23 24 25 26 27 28 28 27 26 25 24 23 22 21 21

   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
       @State private var map = {
           let map = Map(basemapStyle: .arcGISTopographic)
   
           map.initialViewpoint = Viewpoint(latitude: 34.02700, longitude: -118.80500, scale: 72_000)
   
           return map
       }()
   

A map view is a UI component that displays a map. It also handles user interactions with the map, including navigating with touch gestures. Use Xcode and SwiftUI to add a map view.

1. In the body, create a MapView with the map created in the previous step.

   ContentView.swift

   Use dark colors for code blocks

   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 30 31 32 33 34 35 35 35

   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
       var body: some View {
   
           // Displays the map.
           MapView(map: map)
   
       }
   

1. In the Project Navigator, click MainApp.swift.

2. In the body, add an .ignoresSafeArea() modifier to the ContentView. The ContentView's body contains the MapView and this modifier ensures that the map view is displayed beyond the safe area to all edges.

   MainApp.swift

   Use dark colors for code blocks

   74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 74 75 75 75 75 75 75

   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
                   .ignoresSafeArea()
   

3. Press Command + R to run the app.

   If you are using the Xcode simulator your system must meet these minimum requirements: macOS 14 (Sonoma), Xcode 16, iOS 18. If you are using a physical device, then refer to the system requirements.

You should see a map with the topographic basemap layer centered on the Santa Monica Mountains in California. Pinch, drag, and double-tap the map view to explore the map.

Alternatively, you can download the tutorial solution, as follows.

1. Click the Download solution link under Solution and unzip the file to a location on your machine.

2. Open the .xcodeproj file in Xcode.

Since the downloaded solution does not contain authentication credentials, you must add the developer credentials that you created in the Set up authentication section.

To allow your app users to access ArcGIS location services, use the developer credentials that you created in the Set up authentication step to authenticate requests for resources.

Pass your API Key access token to the ArcGISEnvironment.

1. In the Project Navigator, click MainApp.swift.

2. Set the AuthenticationMode to .apiKey.

   MainApp.swift

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
       // Change the `AuthenticationMode` to `.apiKey` if your application uses API key authentication.
   
       private var authenticationMode: AuthenticationMode { .apiKey }
   
   

3. Set the apiKey property with your API key access token.

   MainApp.swift

   Expand

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
       // Please enter an API key access token if your application uses API key authentication.
   
       private let apiKey = APIKey("<#YOUR-ACCESS-TOKEN#>")
   
   

Best Practice: The access token is stored directly in the code as a convenience for this tutorial. Do not store credentials directly in source code in a production environment.

Use the Authenticator toolkit component to manage your OAuth credentials and pass it to the ArcGISEnvironment.

1. In the Project Navigator, click MainApp.swift.

2. Set the AuthenticationMode to .user.

   MainApp.swift

   Use dark colors for code blocks

   1
   2
   3
   // Change the `AuthenticationMode` to `.user` if your application uses OAuth credentials.
   
   private var authenticationMode: AuthenticationMode { .user }

3. Set your portalURL, clientID and redirectURL values.

   MainApp.swift

   Expand

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
       // Setup an `Authenticator` with OAuth configuration if your application uses OAuth credentials.
       @ObservedObject var authenticator = Authenticator(
           oAuthUserConfigurations: [
               OAuthUserConfiguration(
   
                   // Please enter OAuth credentials for user authentication.
   
                   portalURL: URL(string: "<#YOUR-PORTAL-URL#>")!,
                   clientID: "<#YOUR-CLIENT-ID#>",
                   redirectURL: URL(string: "<#YOUR-REDIRECT-URL#>")!
   
               )
           ]
       )
   

Best Practice: The OAuth credentials are stored directly in the code as a convenience for this tutorial. Do not store credentials directly in source code in a production environment.

Press Command + R to run the app.

If you are using the Xcode simulator your system must meet these minimum requirements: macOS 14 (Sonoma), Xcode 16, iOS 18. If you are using a physical device, then refer to the system requirements.

You should see a map with the topographic basemap layer centered on the Santa Monica Mountains in California. Pinch, drag, and double-tap the map view to explore the map.

Learn how to use additional API features, ArcGIS location services, and ArcGIS tools in these tutorials:

• Display a web map
• Add a point, line, and polygon
• Search for an address
• Add a feature layer

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4