FlutterMap 中地图旋转时 onTap 返回错误坐标的问题分析

问题现象

在使用 FlutterMap 6.2.1 版本时，开发者发现当地图旋转后，onTap 和 onLongPress 回调返回的地理坐标（latlng）会出现偏移错误。具体表现为：

1. 当地图旋转90度或-90度时，偏移误差达到最大，甚至可能导致返回的坐标点超出屏幕范围
2. 当地图旋转180度时，坐标又变得正确
3. 偏移量与缩放级别相关，但偏移的像素距离在屏幕上保持相同
4. 偏移方向保持趋势，只增加位置偏移而不改变方向

问题根源

经过深入调查，发现问题并非直接出在 FlutterMap 核心代码中，而是与 MobileLayerTransformer 的使用方式有关。当这个转换器被嵌套在 FlutterMap 的 children 层级中时，会导致 tapPosition.relative 计算出现错误。

临时解决方案

开发者提供了一个有效的临时解决方案，通过手动计算相对点击位置来绕过问题：

onTap: (tapPosition, point) {
  // 手动计算相对偏移量
  final widgetBox = mapKey.currentContext?.findRenderObject() as RenderBox?;
  if (widgetBox != null) {
    final relativeTapPos = tapPosition.global - widgetBox.localToGlobal(Offset.zero);
    final correctedLatLng = mapController.camera.offsetToCrs(relativeTapPos);
    // 使用修正后的坐标
    onMapTap(context, correctedLatLng);
  }
},

技术分析

这个问题揭示了在地图交互处理中几个重要的技术点：

1. 坐标转换流程：FlutterMap 需要将屏幕点击位置转换为地理坐标，这个过程涉及多层转换
2. 旋转处理：地图旋转时，坐标转换需要考虑旋转矩阵的影响
3. 层级嵌套：当有额外的变换层（如 MobileLayerTransformer）介入时，可能会干扰正常的坐标转换流程

最佳实践建议

1. 检查项目中是否有额外的变换层可能干扰 FlutterMap 的正常坐标转换
2. 对于需要处理旋转地图交互的场景，建议先在小范围测试坐标转换的准确性
3. 考虑将交互处理逻辑放在地图变换层之外，避免嵌套带来的复杂性问题

结论

虽然这个问题最终发现是由特定插件的使用方式引起的，但它提醒我们在处理地图交互时要特别注意坐标转换的完整性和准确性。对于复杂的交互场景，建议进行充分的测试，特别是在地图旋转等变换状态下验证坐标转换的正确性。