Bokeh项目中Google地图标记渲染问题分析与修复

问题背景

在Bokeh 3.4.0版本中，用户报告了一个关于Google地图(GMap)功能的重要缺陷。当使用GMap组件展示地理数据时，散点标记(scatter markers)无法正常显示在Google地图上。这个问题影响了所有使用GMap功能展示地理标记的场景。

技术分析

经过开发团队调查，发现问题根源在于PR #13554引入的变更。该变更在次级图形(glyphs)中对原始数据应用了投影变换，导致坐标数据被错误处理：

1. 投影变换被错误地应用于已经处理过的数据
2. 这种双重变换导致坐标值变为无效值或NaN(非数字)
3. 最终结果是标记无法在正确位置渲染

影响范围

该缺陷影响从Bokeh 3.4.0开始的所有版本，包括3.4.1。对于依赖GMap功能展示地理数据的应用来说，这是一个严重的功能性问题。

解决方案

开发团队已经修复了这个问题，主要调整包括：

1. 修正了投影变换的应用逻辑
2. 确保变换只应用于原始数据一次
3. 防止坐标值被错误地转换为NaN

版本规划

修复方案将包含在以下版本中：

1. 3.5.0版本(已修复)
2. 计划中的3.4.2维护版本(将包含向后移植的修复)

额外优化建议

在分析过程中，还发现Google Maps JavaScript API的加载方式可以优化：

1. 当前实现直接加载API而没有使用异步加载(async)模式
2. 这可能导致次优的性能表现
3. 建议按照Google推荐的最佳实践改进加载模式

总结

Bokeh项目团队快速响应并修复了这个影响GMap功能的渲染问题。对于生产环境中使用GMap功能的用户，建议升级到包含修复的版本(3.5.0或未来的3.4.2)。这个问题也提醒我们，在地理数据可视化中，坐标变换的处理需要特别小心，任何双重处理都可能导致数据损坏和渲染失败。