Maplibre GL JS 中 Globe 投影模式下 flyTo 方法的 padding 参数问题分析

问题背景

在使用 Maplibre GL JS 5.0.0-pre.3 版本时，开发者发现当启用 Globe 投影模式后，flyTo 方法的 padding 参数表现异常。具体表现为：首次调用 flyTo 时 padding 参数能正常生效，但后续调用时新指定的 padding 值不会被应用，而是继续使用初始的 padding 值。

问题复现条件

1. 使用 Globe 投影模式
2. 地图缩放级别大于0
3. 连续调用 flyTo 方法并尝试修改 padding 参数

技术分析

不同投影模式的实现差异

通过对比 Mercator 和 Globe 两种投影模式的实现代码，可以发现它们在处理 padding 参数时采用了不同的方式：

1. Mercator 投影：在调用 flyTo 时使用 pointAtOffset 方法来更新 padding
2. Globe 投影：尝试在返回 ease 函数之前处理 padding，实际上忽略了 pointAtOffset 方法

核心问题定位

问题根源在于 mercator_camera_helper.ts 文件中的 cameraForBoxAndBearing 方法。该方法计算可用空间时会将当前的边缘 padding 与用户新提供的 padding 相加，导致在第二次调用 fitBounds 时可用空间变得极小，最终导致相机位置跳转到看似随机的位置。

影响范围

该问题仅影响 Globe 投影模式下的 flyTo 方法调用，Mercator 投影模式下表现正常。主要影响需要动态调整地图边距并实现平滑过渡的场景。

解决方案建议

修复此问题需要仔细调整 Globe 投影模式下 padding 参数的处理逻辑，确保：

1. 每次调用 flyTo 时都能正确应用新的 padding 值
2. 保持与 Mercator 投影模式一致的行为
3. 不破坏现有的其他功能

由于涉及底层相机控制逻辑，修改时需要全面测试各种边界情况，包括不同缩放级别、不同 padding 组合等场景。

总结

Maplibre GL JS 作为开源地图库，其 Globe 投影模式仍在不断完善中。开发者在使用时应注意此类投影模式特定的行为差异，特别是在处理相机动画和布局参数时。对于需要精确控制地图边距的场景，建议暂时使用 setPadding 方法配合适当的过渡动画作为替代方案。