Get Started | Maps SDK | iOS

This guide will help you add the Maps SDK for iOS to your project and add a map to your iOS application.

Part 1: Create and configure your credentials

To download and install the SDK, follow the steps below. Start by logging into your Mapbox account, then get your default public token and add it to your project's Info.plist.

Step 1: Log in/Sign up for a Mapbox account

Your account includes a default public access token, and allows you to create a secret access token for use in the installation of the SDK.

Step 2: Configure your public token

Your public access token is used in your application code when requesting Mapbox resources.

To configure your public access token, follow these steps:

Open your project's Info.plist file
Hover over a key and click the plus button
Type MBXAccessToken into the key field
Click the value field and paste in your public access token.

Rotating Tokens

When you need to rotate your access token, you will need to update the token value in your Info.plist file.

GUIDE

Access token best practices

Learn how to keep access tokens private in mobile apps.

Part 2: Add the dependency

Mapbox provides the Maps SDK via Swift Package Manager, CocoaPods and direct download. You can choose whichever you prefer.

Swift Package Manager

CocoaPods

Direct download

The Mapbox Maps SDK can be installed via Swift Package Manager (SPM) by configuring your environment to download it from Mapbox with a secret token in your .netrc.

Open your Xcode project or workspace, then go to File > Add Packages Dependencies....
Enter https://github.com/mapbox/mapbox-maps-ios.git into the search bar in the top right corner.
Select the Dependency Rule you want to apply to the Maps SDK
- A common choice for Dependency Rule is "Up to Next Major Version", specifying 11.0.0 as the minimum version. To instead install a specific version set the Dependency Rule field to "Exact Version" and insert the desired version. The latest stable version of the Maps SDK is 11.8.0.
Hit enter or Click Add Package.
In the new window select the MapboxMaps library and click Add Package. Once SPM finishes installing the SDK you will see 4 new dependencies under Package Dependencies: MapboxCommon, MapboxCoreMaps, MapboxMaps, and Turf.
Click on your project's target, scroll down to Frameworks, Libraries, and Embedded Content and click the plus button.
From the list select MapboxMaps and click add.

Now you can use start using Mapbox in your project by calling import MapboxMaps in any of your scripts.

Troubleshooting and Updates

If you need to update your packages select File > Packages > Update To Latest Package Versions
If you receive invalid archive errors try the following fix:
- Step 1: Reset your Package cache in Xcode by clicking File > Packages > Reset Package Cache
- Step 2: Delete org.swift.swiftpm
  1. Go to your home directory: /Users/[CurrentUser]
  2. Press Command + Shift + .(the period key) in the finder window
  3. Go to Library/Caches
  4. Delete the org.swift.swiftpm file
  5. Try install again
- Step 3: Check that the following is true for your .netrc file:
  1. The .netrc file is correctly named .netrc and there is nothing before the period.
  2. The .netrc file is not a text file.
  3. The login name is mapbox and not your personal account name
  4. The .netrc file specifies Read & Write permissions. Check with these steps:
    - Go to your home directory: /Users/[CurrentUser]
    - Right click on the .netrc
      - If you do not see the .netrc file, press Command + Shift + .(the period key)
    - Click Get Info
    - Scroll down to Sharing & Permissions
    - Under your current username, make sure that to set Privilege to Read & Write

GUIDE

Troubleshooting Mapbox Maps and Navigation SDKs for iOS installation

Learn how to keep access tokens private in mobile apps.

Part 3: Add a map

You can add a map to your application using either UIKit or SwiftUI. Add the proper snippet and then run your application to see the map.

SwiftUI

UIKit

SwiftUI

UIKit


import SwiftUI
import MapboxMaps

struct ContentView: View {
    var body: some View {
        let center = CLLocationCoordinate2D(latitude: 39.5, longitude: -98.0)
        Map(initialViewport: .camera(center: center, zoom: 2, bearing: 0, pitch: 0))
            .ignoresSafeArea()
    }
}

SwiftUI

UIKit


import UIKit
import MapboxMaps

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()

        let mapView = MapView(frame: view.bounds)
        let cameraOptions = CameraOptions(center:
            CLLocationCoordinate2D(latitude: 39.5, longitude: -98.0),
            zoom: 2, bearing: 0, pitch: 0)
        mapView.mapboxMap.setCamera(to: cameraOptions)
        mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]

        view.addSubview(mapView)
    }
}

Troubleshooting

If you experience any issues while following the Get Started guide, try these fixes here:

Cannot find your .netrc file in your directory

Your finder window will hide the .netrc when it's created. To view the file in your directory, follow these steps:

Go to your home directory: /Users/[CurrentUser].
Press Command + Shift + .(the period key).
Now your .netrc file should appear.

Updating Packages

If you need to update your packages select File > Packages > Update To Latest Package Versions

Invalid Archive Errors with Swift Package Manager

If you receive invalid archive errors try the following fix:

Step 1: Reset your Package cache in Xcode by clicking File > Packages > Reset Package Cache

Step 2: Delete org.swift.swiftpm

Go to your home directory: /Users/[CurrentUser]
Press Command + Shift + .(the period key) in the finder window
Go to Library/Caches
Delete the org.swift.swiftpm file
Try installing the package again

Step 3: Check that the following is true for your .netrc file:

The .netrc file is just named .netrc and there is nothing before the period.
The .netrc file is not a text file.
The login name is mapbox and not your personal account name
Set .netrc file permissions to Read & Write if they aren't already. Check with these steps:
- Go to your home directory: /Users/[CurrentUser]
- Right click on the .netrc
  - If you do not see the .netrc file, press Command + Shift + .(the period key)
- Click Get Info
- Scroll down to Sharing & Permissions
- Under your current username, set Privilege is to Read & Write, if it isn't already.

追加の開発者リソース

このpageは役に立ちましたか？

Part 1: Create and configure your credentials​

Step 1: Log in/Sign up for a Mapbox account​

Step 2: Configure your public token​

Part 2: Add the dependency​

Part 3: Add a map​

Part 1: Create and configure your credentials

Step 1: Log in/Sign up for a Mapbox account

Step 2: Configure your public token

Part 2: Add the dependency

Part 3: Add a map