配置凭据
注册并导航到Account页面。你将需要：
- 公共访问令牌：
从帐户的tokens页面，你可以复制默认的公共令牌或单击"create a token"按钮来创建新的公共令牌。
- 带有Downloads:Read范围的秘密访问令牌：
从你帐户的tokens页面中，单击"create a token"按钮。
在创建令牌页面上，为你的令牌命名，并确保Downloads:Read范围旁边的框被选中。
单击页面底部的"create token"按钮以创建你的令牌。
你创建的令牌是一个秘密令牌，这意味着你将只有一次机会将其复制到安全的地方。
配置秘密令牌
你的秘密令牌允许你直接从Mapbox下载SDK。
要使用你的秘密令牌，你需要将其存储在主目录（而不是项目文件夹）的.netrc文件中。
为.netrc配置0600权限：
chmod 0600 ~/.netrc要设置下载SDK所需的凭据，请将以下条目添加到你的.netrc文件中：
machine api.mapbox.com
login mapbox
password YOUR_SECRET_MAPBOX_ACCESS_TOKEN配置公共令牌
要配置你的公共访问令牌，请打开项目的Info.plist文件，并添加一个MBXAccessToken密钥，其值是你的公共访问令牌。
添加依赖项
MapBox地图库
Mapbox Maps可以通过Swift Package Manager（SPM）使用。要使用SPM添加Mapbox Maps SDK，你需要配置你的环境以从Mapbox下载它，请确保你已将秘密令牌添加到你的.netrc文件中。
打开Xcode项目，然后转到File > Swift Packages > Add Package Dependency，输入GitHub - mapbox/mapbox-maps-ios: Interactive, thoroughly customizable maps for iOS powered by vector tiles and Metal作为URL，按Enter键拉入软件包，然后单击Add Package。
在代码中可以用import MapboxMaps引入依赖包。
MapBox导航库
Mapbox Navigation SDK可以通过Swift Package Manager（SPM）使用。要使用SPM添加Mapbox Navigation SDK，你需要配置你的环境以从Mapbox下载它，请确保你已将秘密令牌添加到你的.netrc文件中。
打开Xcode项目，然后转到File > Swift Packages > Add Package Dependency，输入https://github.com/mapbox/mapbox-navigation-ios.git作为URL，按Enter键拉入软件包，然后单击Add Package。
将Dependency Rule设置为Up to Next Major Version，并输入2.14.0作为最小版本
选择MapboxNavigation库，如果不需要任何UI组件，则选择MapboxCoreNavigation。
在代码中可以用import MapboxNavigation引入依赖包。
隐私和权限
用户必须先授予您的应用程序权限，然后才能访问有关其位置的信息。添加下列配置到Info.plist。
向用户简要说明应用程序将如何使用其位置数据进行临时访问：
<key>NSLocationWhenInUseUsageDescription</key>
<string>Your precise location is used to calculate turn-by-turn directions, show your location on the map, and help improve the map.</string>添加LocationAccuracyAuthorizationDescription作为NSLocationTemporaryUsageDescriptionDictionary字典的元素，为用户提供简要解释为什么应用程序中的功能需要其确切位置：
<key>NSLocationTemporaryUsageDescriptionDictionary</key>
<dict><key>LocationAccuracyAuthorizationDescription</key><string>Please enable precise location. Turn-by-turn directions only work when precise location data is available.</string>
</dict>添加地图
import UIKit
import MapboxMapsclass MapViewController: UIViewController {internal var mapView: MapView!override public func viewDidLoad() {super.viewDidLoad()let myResourceOptions = ResourceOptions(accessToken: "your_public_access_token")let myMapInitOptions = MapInitOptions(resourceOptions: myResourceOptions)mapView = MapView(frame: view.bounds, mapInitOptions: myMapInitOptions)mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]self.view.addSubview(mapView)}
}
在地图上添加标记
let coordinate = CLLocationCoordinate2DMake(latitude, longitude)// Initialize a point annotation with a geometry ("coordinate" in this case)
var pointAnnotation = PointAnnotation(coordinate: coordinate)// Make the annotation show a red pin
pointAnnotation.image = .init(image: UIImage(named: "red_pin")!, name: "red_pin")
pointAnnotation.iconAnchor = .center
pointAnnotation.iconSize = 0.5 //icon image scale// Create the `PointAnnotationManager` which will be responsible for handling this annotation
let pointAnnotationManager = mapView.annotations.makePointAnnotationManager()// Add the annotation to the manager in order to render it on the map.
pointAnnotationManager.annotations = [pointAnnotation]在地图上添加路线
// Define two or more geographic coordinates to connect with a line.
// Line from New York City, NY to Washington, D.C.
let lineCoordinates = [CLLocationCoordinate2DMake(40.7128, -74.0060),CLLocationCoordinate2DMake(38.9072, -77.0369)
]// Create the line annotation.
var lineAnnotation = PolylineAnnotation(lineCoordinates: lineCoordinates)
lineAnnotation.lineColor = StyleColor(.blue)// Create the `PolylineAnnotationManager` which will be responsible for handling this annotation
let lineAnnnotationManager = mapView.annotations.makePolylineAnnotationManager()// Add the annotation to the manager.
lineAnnnotationManager.annotations = [lineAnnotation]设置相机位置
Maps SDK的相机是指用户在地图上方的观测点。
相机的位置和行为由其属性定义：
center：相机指向的经度和纬度。bearing：地图的视觉旋转。轴承值是相机指向的指南针方向，以向用户显示哪个方向是“向上”。例如，90°的方位将地图定向，使东面朝上。pitch：地图的视觉倾斜。0°的间距垂直于表面，直视地图，而60°等更大值则朝向地平线。zoom：缩放级别指定相机与所查看功能的距离。在缩放级别0时，视口显示大陆和海洋。11的中间值显示城市级别的细节，在更高的缩放级别，地图开始显示建筑物和兴趣点。padding：地图每个边缘的插图。影响渲染center的位置。anchor：地图坐标系中关于应应用zoom和bearing的点。与center相互排斥。
在地图初始化时设置相机
// Define center coord, zoom, pitch, bearing
let cameraOptions = CameraOptions(center: CLLocationCoordinate2D(latitude: 40.7135, longitude: -74.0066),zoom: 15.5,bearing: -17.6,pitch: 45)
// Pass camera options to map init options
let options = MapInitOptions(cameraOptions: cameraOptions)
// Pass options when initializing the map
mapView = MapView(frame: view.bounds, mapInitOptions: options)地图初始化后设置相机
let coordinate = CLLocationCoordinate2DMake(latitude, longitude)
let options = CameraOptions(center: coordinate, zoom: 10)
//不带动画
mapView.mapboxMap.setCamera(to: options)
//带动画
mapView.camera.fly(to: options, duration: 3)根据设备位置设置相机
if let locationCoordinate = self.mapView?.location.latestLocation?.coordinate {mapView.mapboxMap.setCamera(to: CameraOptions(center: locationCoordinate, zoom: 15))
}获取道路限速
import MapboxCoreNavigation
import MapboxNavigationclass LocationManager {private let passiveLocationManager = PassiveLocationManager()private lazy var passiveLocationProvider = PassiveLocationProvider(locationManager: passiveLocationManager)init() {NotificationCenter.default.addObserver(self, selector: #selector(didUpdatePassiveLocation), name: Notification.Name.passiveLocationManagerDidUpdate, object: nil)passiveLocationProvider.startUpdatingLocation()}@objc func didUpdatePassiveLocation(_ notification: Notification) {let speedLimitObj = notification.userInfo?[PassiveLocationManager.NotificationUserInfoKey.speedLimitKey]if (speedLimitObj != nil) {let speedLimit: Measurement<UnitSpeed> = speedLimitObj! as! Measurement<UnitSpeed>print("speedLimit:", speedLimit, speedLimit.value)}}
}
