当前位置：首页 > news >正文

iOS添加Mapbox地图库

news 2026/2/9 18:07:17

配置凭据

注册并导航到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 Maps可以通过Swift Package Manager（SPM）使用。要使用SPM添加Mapbox Maps SDK，你需要配置你的环境以从Mapbox下载它，请确保你已将秘密令牌添加到你的.netrc文件中。

打开Xcode项目，然后转到File > Swift Packages > Add Package Dependency，输入https://github.com/mapbox/mapbox-maps-ios.git作为URL，按Enter键拉入软件包，然后单击Add Package。

在代码中可以用import MapboxMaps引入依赖包。

隐私和权限

用户必须先授予您的应用程序权限，然后才能访问有关其位置的信息。添加下列配置到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))
}