iOS MapKit自定义用户定位朝向旋转异常问题排查

你的自定义大头针旋转翻倍的核心原因是：MKMapView会自动为AnnotationView应用与地图朝向一致的旋转变换，而你又手动叠加了基于真北的用户朝向变换，两者叠加导致旋转角度翻倍。系统的默认用户大头针由MapKit内部处理，会自动抵消地图的旋转影响，只显示用户相对于地图的朝向，所以不会出现这个问题。

解决步骤 #

1. 计算用户相对于地图的朝向
   需要用用户的真实朝向减去地图当前的朝向（即地图相机的heading值），得到用户朝向相对于地图坐标系的角度，避免叠加地图的旋转。

2. 修正旋转方向
   UIKit的CGAffineTransform旋转以逆时针为正方向，但CLLocationDirection是顺时针递增（0度为真北），所以需要对计算出的相对角度取负，才能匹配正确的旋转方向。

修改后的代码 #

更新AnnotationView的headingChanged方法

添加地图朝向参数，计算相对角度后再设置变换：

class AnnotationView : MKAnnotationView, HeadingDelegate {
    required init?(coder aDecoder: NSCoder) {
        super.init(coder: aDecoder)
    }

    override init(annotation: MKAnnotation?, reuseIdentifier: String?) {
        super.init(annotation: annotation, reuseIdentifier: reuseIdentifier)
    }

    // 新增mapHeading参数，接收地图当前朝向
    func headingChanged(_ userHeading: CLLocationDirection, mapHeading: CLLocationDirection) {
        // 计算相对朝向，处理角度负值（保证在0-360范围内）
        var relativeHeading = userHeading - mapHeading
        if relativeHeading < 0 {
            relativeHeading += 360
        }
        // 转换为UIKit兼容的旋转弧度（取负修正方向）
        let rotationAngle = -CGFloat(relativeHeading * .pi / 180.0)
        
        UIView.animate(withDuration: 0.1, animations: { [unowned self] in
            self.transform = CGAffineTransform(rotationAngle: rotationAngle)
        })
    }
}

在位置管理器的朝向更新方法中传递地图朝向

确保在获取用户朝向时，同时传入地图的相机朝向：

func locationManager(_ manager: CLLocationManager, didUpdateHeading newHeading: CLHeading) {
    // 过滤无效的朝向数据
    guard newHeading.headingAccuracy >= 0 else { return }
    // 获取用户真实朝向（若使用磁北则用magneticHeading）
    let userHeading = newHeading.trueHeading
    // 获取地图当前的朝向
    let mapHeading = mapView.camera.heading
    // 通知AnnotationView更新旋转
    annotationView?.headingChanged(userHeading, mapHeading: mapHeading)
}

额外注意事项 #

• 确保你的MKMapView的userTrackingMode设置为.followWithHeading，这样地图会跟随用户朝向旋转，和系统默认行为一致。
• 如果你的自定义大头针图片默认朝向不是真北（比如默认朝东），需要在计算rotationAngle时加上初始偏移角度。

内容的提问来源于stack exchange，提问作者Guntis Treulands