自定义Map Annotation View如何实现MapMarker的信息遮挡隐藏效果？

默认系统MapMarker自带和地图文本（城市名、道路名等）的碰撞避让逻辑：缩放级别较低时，Marker会遮挡下方文本；缩放足够近后，两者不再重叠，文本才显示。自定义Annotation View默认没有这套机制，所以会和文本同时显示，显得杂乱。可以通过以下几种方式实现相同的避让效果：

• 开启系统内置碰撞避让
  针对iOS的MKAnnotationView，通过设置两个关键属性让系统自动处理碰撞：

  func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
      guard let customAnnotation = annotation as? CustomAnnotation else { return nil }
      let identifier = "CustomAnnotation"
      var annotationView = mapView.dequeueReusableAnnotationView(withIdentifier: identifier) as? CustomAnnotationView
      if annotationView == nil {
          annotationView = CustomAnnotationView(annotation: customAnnotation, reuseIdentifier: identifier)
          // 开启碰撞检测，用圆形范围匹配默认Marker的行为
          annotationView?.collisionMode = .circle
          // 设置优先级低于地图文本，重叠时Annotation会被隐藏
          annotationView?.annotationVisibilityPriority = .defaultLow
      }
      return annotationView
  }
  

  系统会根据碰撞检测结果，自动控制自定义Annotation的显示/隐藏，和默认Marker逻辑一致。

• 自定义碰撞检测范围
  如果你的Annotation View不是圆形，可以手动设置碰撞区域，让系统更准确判断重叠情况：

  // 以View中心为原点，设置40x40的碰撞矩形，根据实际View尺寸调整
  annotationView?.collisionBounds = CGRect(x: -20, y: -20, width: 40, height: 40)
  

• 手动根据缩放级别控制显示
  要是系统自动机制不符合需求，也可以监听地图缩放变化，自己控制Annotation的显示状态：

  func mapView(_ mapView: MKMapView, regionDidChangeAnimated animated: Bool) {
      // 计算当前缩放级别
      let zoomLevel = log2(360 / mapView.region.span.latitudeDelta)
      // 设定阈值，比如缩放级别大于12时显示Annotation，否则隐藏
      mapView.annotations.forEach {
          if let view = mapView.view(for: $0) as? CustomAnnotationView {
              view.isHidden = zoomLevel < 12
          }
      }
  }
  

  这种方式需要自己测试合适的缩放阈值，来匹配默认Marker的显示节奏。

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