Swift iOS Google Maps SDK 重叠GMSOverlay设置zIndex后顶层点击失效问题

修复方案 #

问题根因 #

1. 你的zIndex赋值逻辑circleZIndex = Int32(1600 - placeSize)依赖尺寸计算，容易出现预期外的层级偏差，若业务逻辑是小尺寸覆盖层在上，需要确认最终赋值的zIndex值确实是越小的覆盖层数值越高。
2. Google Maps iOS SDK存在已知的点击判定缺陷：当上层覆盖层的opacity低于0.2时，即使zIndex更高，点击事件也会被判定到下层不透明度更高的覆盖层上。
3. 你采用延迟1秒异步添加覆盖层的逻辑，可能出现高zIndex的覆盖层先被添加到地图，低zIndex的后添加，导致实际渲染层级和zIndex设定不一致。
4. 部分版本的SDK中，GMSGroundOverlay的点击判定会优先命中bounds更大的覆盖层，忽略zIndex设置。

具体修改步骤 #

1. 修正zIndex赋值逻辑，确保需要优先响应点击的覆盖层zIndex绝对大于下层，避免使用计算式出现误差：

// 替换原有的circleZIndex计算逻辑
// 若需要小尺寸覆盖层在上，可直接按创建顺序递增加上基础值，确保高优先级覆盖层zIndex更高
let circleZIndex = Int32(2000 + mapMarkers.count)

2. 给可点击覆盖层的透明度增加兜底，禁止低于0.2，如果UI需要半透明效果，可以在icon图片资源中实现半透明，overlay本身的opacity保持0.2以上：

// 在原有透明度赋值后增加兜底逻辑
customMarker.opacity = max(customMarker.opacity, 0.2)
customMarker.fixedOpacity = max(customMarker.fixedOpacity, 0.2)

3. 调整覆盖层添加逻辑，避免异步添加打乱层级，如果需要延迟显示可以先设置隐藏，添加到地图后再延迟展示：

// 替换原有的DispatchQueue.main.asyncAfter添加逻辑
customMarker.isHidden = true
customMarker.map = mapView
DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
    customMarker.isHidden = false
}

4. 在地图的点击回调中手动筛选当前点击坐标下zIndex最高的覆盖层，弥补SDK的判定缺陷：

func mapView(_ mapView: GMSMapView, didTap overlay: GMSOverlay) -> Bool {
    let tapCoordinate = mapView.projection.coordinate(for: tapPoint)
    // 筛选当前点击坐标下的所有自定义覆盖层
    let tappedOverlays = mapMarkers.filter { marker in
        GMSGeometryContainsLocation(tapCoordinate, marker.bounds, true)
    }
    // 取zIndex最高的覆盖层处理点击
    guard let topOverlay = tappedOverlays.max(by: { $0.zIndex < $1.zIndex }) else {
        return false
    }
    // 在此处处理topOverlay的点击逻辑
    processOverlayTap(topOverlay)
    return true
}

5. 如果以上方案都无法解决，可将需要顶层响应点击的覆盖层替换为GMSMarker，GMSMarker的点击判定优先级天然高于GMSGroundOverlay，不会被下层的GMSGroundOverlay拦截。

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