Plotly.py 模板系统升级：新增 scattermap 和 map 轨迹支持

背景介绍

Plotly.py 作为 Python 生态中强大的可视化库，其模板系统允许用户快速应用预定义的图表样式。近期社区发现模板系统中存在一个需要改进的地方：现有的模板没有为 scattermap 和 map 这两种地理轨迹类型提供与 scattermapbox 和 mapbox 相同的支持。

问题分析

在 Plotly.py 的模板文件中，地理可视化相关的轨迹类型存在不一致性。虽然 scattermapbox 和 mapbox 已经在模板中定义，但功能相似的 scattermap 和 map 却未被包含。这种缺失会导致：

1. 使用这些轨迹类型时无法自动应用模板样式
2. 用户需要手动设置样式，降低了开发效率
3. 与 Plotly 生态其他部分的行为不一致

技术实现方案

社区成员通过分析代码结构，发现模板文件位于 packages/python/plotly/plotly/package_data/templates/ 目录下，这些文件由专门的模板生成器 templategen 创建。解决方案包括：

1. 修改模板生成器的定义文件，添加 map 轨迹类型的支持
2. 确保生成器正确处理 scattermap 轨迹类型
3. 更新相关配置文件以反映这些变化

实施过程

技术团队采取了以下步骤来完成这项改进：

1. 检查并修复了模板生成器中的热图轨迹引用问题
2. 将主生成逻辑重构到 __main__.py 文件中以便直接执行
3. 运行生成器命令重新生成所有核心模板文件
4. 验证新生成的模板文件确实包含了所需的轨迹类型定义

影响与意义

这项改进将为 Plotly.py 用户带来以下好处：

1. 更一致的地理可视化体验
2. 减少手动配置样式的工作量
3. 提高代码的可维护性和可扩展性
4. 为未来添加更多轨迹类型支持奠定了基础

最佳实践建议

对于使用 Plotly.py 进行地理可视化的开发者，建议：

1. 更新到包含此修复的版本以获得完整功能
2. 检查现有代码中是否依赖手动设置的样式
3. 考虑使用模板系统来统一项目中的图表风格
4. 关注 Plotly 社区的更新以获取更多功能增强

这项改进展示了开源社区如何通过协作不断完善工具链，最终为用户提供更强大、更一致的使用体验。