iOS MapKit中MKOverlay的渲染层级顺序如何确定及调整？

MKMapView 对 MKOverlay 的渲染顺序不是由 overlays 数组顺序或单纯的添加时间决定，官方文档也明确否定了数组顺序和视觉顺序的关联。要精准控制渲染层级（比如让蓝色圆圈显示在红色方框上方），有两种可靠的官方方式：

• 直接设置渲染器的 zPosition 属性
  当你为 overlay 创建对应的 MKOverlayRenderer（或其子类如 MKCircleRenderer、MKPolygonRenderer）时，给需要显示在上方的 overlay 的渲染器设置更高的 zPosition 值即可。比如：

  // 红色方框的渲染器
  let boxRenderer = MKPolygonRenderer(polygon: redBoxPolygon)
  boxRenderer.zPosition = 1
  // 蓝色圆圈的渲染器
  let circleRenderer = MKCircleRenderer(circle: blueCircleOverlay)
  circleRenderer.zPosition = 2
  

  数值越大，渲染层级越高，会覆盖在数值小的元素上方。

• 使用 MKMapView 的层级插入方法
  如果你已经添加了多个 overlay，可以用 insertOverlay(_:aboveOverlay:) 或 insertOverlay(_:belowOverlay:) 方法手动调整相对层级：

  // 把蓝色圆圈 overlay 插入到红色方框 overlay 的上方
  mapView.insertOverlay(blueCircleOverlay, aboveOverlay: redBoxPolygon)
  

  这种方式可以直接指定两个 overlay 的上下关系，不需要关心它们的添加顺序。

另外你提到的“后添加的显示在上方”只是默认的行为，但这不是可靠的规则——系统可能会根据 overlay 的类型调整层级，所以不要依赖添加时间来控制顺序，用上面两种官方方法才是稳妥的。

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