为何GMSMarker与GMSOverlay重叠时需双击才显示信息窗口？

这个问题我之前做Google Maps iOS开发时也碰到过，核心基本是交互层级冲突或者事件拦截导致的，咱们一步步拆解：

为什么会出现双击的情况？ #

最常见的两种原因：

• 层级顺序搞反了：虽然你说Marker是加在Overlay上方，但如果没明确设置zIndex，可能Overlay的层级意外盖过了Marker。Google Maps SDK默认Marker优先级高于Overlay，但如果Overlay的zIndex被设得比Marker高，点击时就会先触发Overlay的didTap回调——第一次点击被Overlay“抢走”，第二次点击才会触发Marker的交互。
• 事件识别的小偏差：极少数情况下，重叠区域的点击会被SDK误判为Overlay点击，第一次点击仅触发Overlay的回调，第二次点击才被识别为Marker点击，进而显示信息窗口。

具体解决方法 #

1. 强制设置Marker层级高于Overlay #

这是最直接有效的方法，通过zIndex明确Marker在Overlay之上：

// 把Overlay的层级设为较低值（默认就是0）
yourOverlay.zIndex = 0
// 给Marker设置更高层级，确保它在交互和视觉上都在Overlay之上
yourMarker.zIndex = 1

设置后，点击重叠区域时SDK会优先识别Marker的点击，直接触发didTap marker回调并显示信息窗口，无需双击。

2. 在Overlay的点击回调中做判断（需保留Overlay点击功能时） #

如果你还需要Overlay的点击逻辑，但想在重叠区域优先响应Marker，可以在Overlay的didTap回调里检查点击位置是否有Marker，有的话直接触发Marker的信息窗口：

// 先给mapView添加Tap手势记录点击的屏幕坐标
let tapGesture = UITapGestureRecognizer(target: self, action: #selector(handleMapTap(_:)))
mapView.addGestureRecognizer(tapGesture)

// 存储点击点的变量
private var lastTapScreenPoint: CGPoint?

@objc func handleMapTap(_ gesture: UITapGestureRecognizer) {
    lastTapScreenPoint = gesture.location(in: mapView)
}

// Overlay的点击回调
func mapView(_ mapView: GMSMapView, didTap overlay: GMSOverlay) {
    guard let screenPoint = lastTapScreenPoint else { return }
    
    // 屏幕坐标转地图坐标
    let tapCoordinate = mapView.projection.coordinate(for: screenPoint)
    
    // 查找点击位置附近的Marker（40pt范围可根据图标大小调整）
    let tappedMarker = mapView.markers.first { marker in
        let markerScreenPoint = mapView.projection.point(for: marker.position)
        let distance = hypot(markerScreenPoint.x - screenPoint.x, markerScreenPoint.y - screenPoint.y)
        return distance < 40
    }
    
    if let marker = tappedMarker {
        // 显示Marker的信息窗口
        mapView.selectedMarker = marker
        return // 跳过Overlay的点击处理
    }
    
    // 这里处理正常的Overlay点击逻辑
}

3. 检查Marker的可点击状态 #

别漏掉基础检查：确保Marker的isTappable属性为true（默认是true，但如果不小心被修改过就会出问题）：

yourMarker.isTappable = true

4. 扩大Marker的点击区域（图标较小时） #

如果Marker图标本身很小，SDK可能难以识别点击，你可以通过调整groundAnchor或自定义iconView扩大点击范围：

// 自定义iconView并设置更大的frame
let iconView = UIImageView(image: UIImage(named: "marker-icon"))
iconView.frame = CGRect(x: 0, y: 0, width: 60, height: 60) // 扩大点击区域
yourMarker.iconView = iconView
yourMarker.groundAnchor = CGPoint(x: 0.5, y: 0.5) // 锚点居中

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