## 定位 CoreLocation 是 iOS 中用于设备定位的框架。通过这个框架可以实现定位进而获取位置信息如经度、纬度、海拔信息等。 ### 模块与常见类 - 定位所包含的类都在`CoreLocation`模块中，使用时必须导入。 - `CLLocationManager`：定位管理器，可以理解为定位不能自己工作，需要有个类对它进行全过程管理。 - `CLLocationManagerDelegate`：定位管理代理，不管是定位成功与失败，都会有相应的代理方法进行回调。 - `CLLocation`：表示某个位置的地理信息，包含经纬度、海拔等。 - `CLPlacemark`：位置信息，包含的信息如国家、城市、街道等。 - `CLGeocoder`：地理编码。 ### 工作流程 1. 创建`CLLocationManager`，设置代理并发起定位。 2. 实现`CLLocationManagerDelegate`中定位成功和失败的代理方法。 3. 在成功的代理方法中获取`CLLocation`对象并通过`CLGeocoder`进行反向地理编码获取对应的位置信息`CLPlacemark`。 5. 通过`CLPlacemark`获取具体的位置信息。 ### 权限 #### 授权对话框 - 程序中调用`requestWhenInUseAuthorization`发起定位授权。 - 程序中调用`requestAlwaysAuthorization`发起定位授权。 #### 前台定位 - 需要在 Info.plist 中配置`Privacy - Location When In Use Usage Description`。 - 程序中调用`requestWhenInUseAuthorization`发起定位授权。 - 弹出的授权对话框新增了精确位置开关，同时新增了小地图展示当前位置。 #### 后台定位 - 需要勾选 **Capabilities —> Background Modes —> Location updates**。 - 程序中允许后台定位：`locationManager.allowsBackgroundLocationUpdates = true`。 - 此时授权分为 2 种情况：（1）`Privacy - Location When In Use Usage Description` + `requestWhenInUseAuthorization`：可以后台定位，但会在设备顶部出现蓝条（刘海屏设备会出现在左边刘海）。（2）`Privacy - Location When In Use Usage Description` + `Privacy - Location Always and When In Use Usage Description` + `requestAlwaysAuthorization`：可以后台定位，不会出现蓝条。这种方式会**出现 2 次授权对话框**：第一次和前台定位一样，在同意使用`While Using App`模式后，继续使用定位才会弹出第二次，询问是否切换到`Always`模式。 #### 精度控制 - iOS 14 新增了一种定位精度控制，在定位授权对话框中有一个**精度切换**开关，可以切换精确和模糊定位（默认精确）。 - 可以通过`CLLocationManager`的`accuracyAuthorization`属性获取当前的定位精度权限。 - 当已经获得定位权限且当前用户选择的是模糊定位，则可以使用`CLLocationManager`的`requestTemporaryFullAccuracyAuthorization(withPurposeKey purposeKey: String, completion: ((Error?) -> Void)? = nil)`方法申请一次临时精确定位权限，其中`purposeKey`为 Info.plist 中配置的`Privacy - Location Temporary Usage Description Dictionary`字段下某个具体原因的 key，可以设置多个 key 以应对不同的定位使用场景。 - `requestTemporaryFullAccuracyAuthorization`方法并不能用于申请定位权限，只能用于从模糊定位升级为精确定位；如果没有获得定位权限，直接调用此 API 无效。 - 如果不想使用精确定位，则可以在 Info.plist 中配置`Privacy - Location Default Accuracy Reduced`为`YES`，此时申请定位权限的小地图中不再有精度切换开关。需要注意 2 点：（1）如果发现该字段不是 Bool 型，需要以源码形式打开 Info.plist，然后手动修改`NSLocationDefaultAccuracyReduced`为 Bool 型的值，否则无法生效。（2）配置该字段后，如果 Info.plist 中还配置了`Privacy - Location Temporary Usage Description Dictionary`，则仍可以通过`requestTemporaryFullAccuracyAuthorization`申请临时的精确定位权限，会再次弹出授权对话框进行确认。 ### 模拟器定位由于定位需要 GPS，一般情况下需要真机进行测试。但对于模拟器，也可以进行虚拟定位，主要有 2 种方式。 - **方式一**：
（1）新建一个`gpx`文件，可以取名`XXX.gpx`，然后将自己的定位信息填写进 xml 对应的位置。（2）`gpx`文件设置完成以后，首先需要运行一次 App，然后选择`Edit Scheme`，在`Options`中选择自己的`gpx`文件，这样模拟器运行的时候就会读取该文件的位置信息。然后可以选择`Debug`—>`Simulate Location`或底部调试栏上的定位按钮进行`gpx`文件或位置信息的切换。 ```xml 安徽商贸职业技术学院中国安徽省芜湖市弋江区文昌西路24号邮政编码: 241002 中国安徽省芜湖市弋江区文昌西路24号邮政编码: 241002 ``` - **方式二**：运行程序开始定位 —> 模拟器菜单 —> **Features** —> **Location** —> **Custom Location** —> 输入经纬度。 ### 实现步骤 1. 导入`CoreLocation`模块。 2. 创建`CLLcationManager`对象，设置参数和代理，配置 Info.plist 并请求定位授权。 3. 调用`CLLcationManager`对象的`startUpdatingLocation()`或`requestLocation()`方法进行定位。 4. 实现代理方法，在定位成功的方法中进行位置信息的处理。 ```swift import CoreLocation import UIKit class ViewController: UIViewController { // CLLocationManager lazy var locationManager = CLLocationManager() // CLGeocoder lazy var gecoder = CLGeocoder() override func viewDidLoad() { super.viewDidLoad() setupManager() } func setupManager() { // 默认情况下每当位置改变时LocationManager就调用一次代理。通过设置distanceFilter可以实现当位置改变超出一定范围时LocationManager才调用相应的代理方法。这样可以达到省电的目的。 locationManager.distanceFilter = 300 // 精度比如为10 就会尽量达到10米以内的精度 locationManager.desiredAccuracy = kCLLocationAccuracyBest // 代理 locationManager.delegate = self // 第一种：能后台定位但是会在顶部出现大蓝条（打开后台定位的开关） // 允许后台定位 locationManager.allowsBackgroundLocationUpdates = true locationManager.requestWhenInUseAuthorization() // 第二种：能后台定位并且不会出现大蓝条 // locationManager.requestAlwaysAuthorization() } override func touchesBegan(_ touches: Set, with event: UIEvent?) { // 以下2个方法都会调用代理方法 // 1. 发起位置更新（定位）会一直轮询，耗电 locationManager.startUpdatingLocation() // 2. 只请求一次用户的位置，省电 // locationManager.requestLocation() } } extension ViewController: CLLocationManagerDelegate { // 定位成功 func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) { if let location = locations.last { // 反地理编码转换成具体的地址 gecoder.reverseGeocodeLocation(location) { placeMarks, _ in // CLPlacemark －－国家城市街道 if let placeMark = placeMarks?.first { print(placeMark) // print("\(placeMark.country!) -- \(placeMark.name!) -- \(placeMark.locality!)") } } } // 停止位置更新 locationManager.stopUpdatingLocation() } // 定位失败 func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) { print(error.localizedDescription) } } ``` ## 地图 - 地图所包含的类都在`MapKit`模块中，使用时必须导入。 - 除了可以显示地图，还支持在地图上进行标记处理。 - 地图看似很复杂，其实它仅仅是一个控件 MKMapView，就和以前学习过的 UIButton、UITableView 等一样，可以在 storyboard 和代码中使用。 - 地图上如果想要显示用户的位置，必须与定位配合，那么就需要创建定位管理器、设置权限等（参考**定位**知识），同时需要通过 storyboard 或者代码设置地图的相关属性。 ### 准备工作 1. 添加一个地图并设置相关属性。 2. Info.plist 中配置定位权限。 3. 创建 CLLocationManager 对象并请求定位权限。 ### 基本使用显示地图，同时显示用户所处的位置。点击用户的位置，显示一个气泡展示用户位置的具体信息。 ```swift import MapKit class ViewController: UIViewController { @IBOutlet var mapView: MKMapView! lazy var locationManager: CLLocationManager = CLLocationManager() override func viewDidLoad() { super.viewDidLoad() setupMapView() } func setupManager() { locationManager.requestWhenInUseAuthorization() // 不需要发起定位 } func setupMapView() { // 设置定位 setupManager() // 地图类型 mapView.mapType = .hybridFlyover // 显示兴趣点 mapView.showsPointsOfInterest = true // 显示指南针 mapView.showsCompass = true // 显示交通 mapView.showsTraffic = true // 显示建筑 mapView.showsBuildings = true // 显示级别 mapView.showsScale = true // 用户跟踪模式 mapView.userTrackingMode = .followWithHeading } } ``` ### 缩放级别在之前功能的基础上实现地图的任意视角（“缩放级别”）。 ```swift // 设置“缩放级别” func setRegion() { if let location = location { // 设置范围，显示地图的哪一部分以及显示的范围大小 let region = MKCoordinateRegion(center: mapView.userLocation.coordinate, latitudinalMeters: 500, longitudinalMeters: 500) // 调整范围 let adjustedRegion = mapView.regionThatFits(region) // 地图显示范围 mapView.setRegion(adjustedRegion, animated: true) } } ``` ### 标注在地图上可以添加标注来显示一个个关键的信息点，用于对用户的提示。 #### 分类 - MKPinAnnotationView：系统自带的标注，继承于 MKAnnotationView，形状跟棒棒糖类似，可以设置糖的颜色，和显示的时候是否有动画效果（Swift 不推荐使用）。 - MKMarkerAnnotationView：iOS 11 推出，建议使用。 - MKAnnotationView：可以用指定的图片作为标注的样式，但显示的时候没有动画效果，如果没有指定图片会什么都不显示（自定义时使用）。 #### 创建模型 ```swift class MapFlag: NSObject, MKAnnotation { // 标题 let title: String? // 副标题 let subtitle: String? // 经纬度 let coordinate: CLLocationCoordinate2D // 附加信息 let urlString: String init(title: String?, subtitle: String?, coordinate: CLLocationCoordinate2D, urlString: String) { self.title = title self.subtitle = subtitle self.coordinate = coordinate self.urlString = urlString } } ``` #### 添加标注 - 添加系统标注，点击能够显示标题和副标题。 ```swift override func touchesBegan(_ touches: Set, with event: UIEvent?) { let flag = MapFlag(title: "标题", subtitle: "副标题", coordinate: CLLocationCoordinate2D(latitude: 31.2906511800, longitude: 118.3623587000), urlString: "https://www.baidu.com") mapView.addAnnotation(flag) } ``` - 添加系统标注，点击以气泡形式显示标题、副标题及自定义内容，此时需要重写地图的代理方法，返回标注的样式。 ```swift extension ViewController: MKMapViewDelegate { func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? { guard let annotation = annotation as? MapFlag else { return nil } // 如果是用户的位置，使用默认样式 if annotation == mapView.userLocation { return nil } // 标注的标识符 let identifier = "marker" // 获取AnnotationView var annotationView = mapView.dequeueReusableAnnotationView(withIdentifier: identifier) as? MKMarkerAnnotationView // 判空 if annotationView == nil { annotationView = MKMarkerAnnotationView(annotation: annotation, reuseIdentifier: identifier) // 显示气泡 annotationView?.canShowCallout = true // 左边显示的辅助视图 annotationView?.leftCalloutAccessoryView = UIImageView(image: UIImage(systemName: "heart")) // 右边显示的辅助视图 let button = UIButton(type: .detailDisclosure, primaryAction: UIAction(handler: { _ in print(annotation.urlString) })) annotationView?.rightCalloutAccessoryView = button } return annotationView } } ``` - 如果希望标注的图标为自定义样式，只需要稍加更改代理方法并设置自己的标注图片即可。 ```swift extension ViewController: MKMapViewDelegate { func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? { guard let annotation = annotation as? MapFlag else { return nil } // 如果是用户的位置，使用默认样式 if annotation == mapView.userLocation { return nil } // 标注的标识符 let identifier = "custom" // 标注的自定义图片 let annotationImage = ["pin.circle.fill", "car.circle.fill", "airplane.circle.fill", "cross.circle.fill"] // 获取AnnotationView var annotationView = mapView.dequeueReusableAnnotationView(withIdentifier: identifier) // 判空 if annotationView == nil { annotationView = MKAnnotationView(annotation: annotation, reuseIdentifier: identifier) // 图标，每次随机取一个 annotationView?.image = UIImage(systemName: annotationImage.randomElement()!) // 显示气泡 annotationView?.canShowCallout = true // 左边显示的辅助视图 annotationView?.leftCalloutAccessoryView = UIImageView(image: UIImage(systemName: "heart")) // 右边显示的辅助视图 let button = UIButton(type: .detailDisclosure, primaryAction: UIAction(handler: { _ in print(annotation.urlString) })) annotationView?.rightCalloutAccessoryView = button // 弹出的位置偏移 annotationView?.calloutOffset = CGPoint(x: -5.0, y: 5.0) } return annotationView } } // 点击地图插入一个标注，标注的标题和副标题显示的是标注的具体位置 override func touchesBegan(_ touches: Set, with event: UIEvent?) { let touchPoint = touches.first?.location(in: mapView) // 将坐标转换成为经纬度,然后赋值给标注 let coordinate = mapView.convert(touchPoint!, toCoordinateFrom: mapView) let location = CLLocation(latitude: coordinate.latitude, longitude: coordinate.longitude) let gecoder = CLGeocoder() // 反地理编码转换成具体的地址 gecoder.reverseGeocodeLocation(location) { placeMarks, _ in let placeMark = placeMarks?.first if let placeMark = placeMark { let flag = MapFlag(title: placeMark.locality, subtitle: placeMark.subLocality, coordinate: coordinate, urlString: "https://www.baidu.com") self.mapView.addAnnotation(flag) } } } ```