SwiftUI中MapKit的MapPolyline在3D实景地图样式下显示异常求助

不用急着换Google SDK，试试下面几个实际的解决方案：

• 修正Polyline坐标的海拔信息
  真实地形模式下，MapKit会严格依据坐标的海拔值渲染Polyline。如果你的Polyline坐标只提供了经纬度（无海拔），系统默认用0海拔，会在起伏地形上出现错位或穿透。可以通过CLGeocoder获取对应经纬度的真实海拔，给每个CLLocationCoordinate2D补充altitude参数后再创建MKPolyline。

• 自定义Polyline渲染器
  默认的MKPolylineRenderer在3D实景模式下可能存在适配缺陷，自定义渲染器可以完全控制绘制逻辑：

  class CustomPolylineRenderer: MKPolylineRenderer {
      override func draw(_ mapRect: MKMapRect, zoomScale: MKZoomScale, in context: CGContext) {
          guard let mapView = self.mapView else { return }
          let path = CGMutablePath()
          let points = self.points()
          
          for i in 0..<self.pointCount {
              let coordinate = points[i].coordinate
              let mapPoint = MKMapPoint(coordinate)
              // 转换为适配地形的屏幕坐标
              let screenPoint = mapView.convert(mapPoint, toPointTo: nil)
              i == 0 ? path.move(to: screenPoint) : path.addLine(to: screenPoint)
          }
          
          context.addPath(path)
          context.setStrokeColor(self.strokeColor?.cgColor ?? UIColor.blue.cgColor)
          context.setLineWidth(self.lineWidth / zoomScale)
          context.strokePath()
      }
  }
  

  在MKMapViewDelegate中返回这个自定义渲染器：

  func mapView(_ mapView: MKMapView, rendererFor overlay: MKOverlay) -> MKOverlayRenderer {
      guard let polyline = overlay as? MKPolyline else {
          return MKOverlayRenderer(overlay: overlay)
      }
      let renderer = CustomPolylineRenderer(polyline: polyline)
      renderer.strokeColor = .blue
      renderer.lineWidth = 3
      return renderer
  }
  

• 检查地图配置参数
  排查可能的设置冲突：

  • 临时禁用isRotateEnabled或isPitchEnabled，测试是否恢复正常显示；
  • 调整地图相机的pitch角度，极端角度可能加剧渲染异常；
  • 关闭showsBuildings等可能干扰Overlay渲染的选项。

• 适配系统版本
  部分iOS早期版本（比如iOS 16.x）存在MapKit实景地形下的Overlay渲染bug，尝试升级到最新iOS版本，或查看Apple开发者文档的已知问题列表，确认是否有官方修复方案。

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