mapbox-google-maps-migration

用途：帮助开发者把基于 Google Maps Platform 的代码迁移到 Mapbox GL JS，提供 API 对照、写法转换和迁移策略。核心差异在于设计思路：Google Maps 以命令式、面向对象为主，创建 Marker、Polygon 等对象后用 setMap 挂载、用 setter 改属性；Mapbox GL JS 是声明式、数据驱动的，通过添加数据源、定义图层、以 JSON 样式渲染，更新的是数据而非对象属性。主要对照：初始化用 new mapboxgl.Map，需设置 accessToken、container、style 与 center；坐标顺序从 {lat, lng} 反转为 [lng, lat]；地图类型改用样式 URL；setCenter、panTo、fitBounds、setStyle 等均有对应写法，事件改用 map.on，属性 latLng 变为 lngLat，center_changed、zoom_changed 等事件名也不同。标记与弹窗方面，单点可用 Marker 加 Popup，上百点建议用 GeoJSON 数据源加 circle 或 symbol 图层，由 WebGL 渲染，适合 1000 至 10000 以上点位。用法上给出七步迁移流程：盘点现有功能、接入 Mapbox 脚本与样式、转换基础地图、逐项迁移功能、改写事件处理、针对 Mapbox 优化、全面测试。限制与注意：坐标顺序、事件属性、加载时机（需在 load 后加源加层）易出错；删除要素要同时移除图层与数据源；更新数据应使用 setData 或 setFilter，避免删后重建导致闪烁；Street View 无对应功能。若强依赖街景、深度集成 Google 相关服务、已有高度优化或团队成本过高、项目周期很短，可考虑不迁移。具体版本号、令牌配置与更多主题另见技能内引用文件。