$npx -y skills add baidu-maps/jsapi-skills --skill bmap-jsapi-gl百度地图 JSAPI WebGL (BMapGL)完整开发指南,覆盖地图初始化、覆盖物、图层、事件、样式、性能优化的任务,一站式开发高性能 3D 地图应用。当用户提及 BMapGL、百度地图、jsapi-gl或相关地图开发需求时自动触发。
| 1 | # JSAPI GL 开发指南 |
| 2 | |
| 3 | 百度地图 JSAPI WebGL 版本开发指南。包含地图初始化、覆盖物、事件、图层等核心模块的 API 说明和代码示例,旨在帮助开发者快速集成百度地图并遵循正确的使用方式。 |
| 4 | |
| 5 | ## 何时适用 |
| 6 | |
| 7 | 在以下场景中参考这些指南: |
| 8 | |
| 9 | - 创建新的地图页面或组件 |
| 10 | - 在地图上添加标注、折线、多边形等覆盖物 |
| 11 | - 处理地图交互事件(点击、拖拽、缩放等) |
| 12 | - 配置地图样式或切换图层 |
| 13 | - 调试地图渲染或性能问题 |
| 14 | |
| 15 | |
| 16 | ## 快速参考 |
| 17 | |
| 18 | ### 0. 基础概念 |
| 19 | |
| 20 | - `references/base-classes.md` - 基础类:Point、Bounds、Size、Pixel、Icon |
| 21 | - `references/constants.md` - 通用常量:搜索状态码、POI 类型 |
| 22 | |
| 23 | ### 1. 地图 |
| 24 | |
| 25 | - `references/map-init.md` - 地图初始化:资源引入、创建实例、配置选项、交互与视图控制 |
| 26 | |
| 27 | ### 2. 地图覆盖物 |
| 28 | |
| 29 | - `references/overlay-common.md` - 覆盖物通用操作:添加/移除、显示/隐藏、批量清除 |
| 30 | - `references/marker.md` - 点标记:构造参数、位置/图标/旋转/置顶/拖拽方法 |
| 31 | - `references/polyline.md` - 折线:构造参数、线条样式、坐标操作、编辑模式 |
| 32 | - `references/polygon.md` - 多边形:构造参数、边框/填充样式、带孔多边形、编辑模式 |
| 33 | - `references/circle.md` - 圆形:构造参数、中心点/半径、样式设置、编辑模式 |
| 34 | - `references/custom-overlay.md` - 自定义覆盖物:DOM 创建、属性传递、事件绑定、旋转控制 |
| 35 | - `references/info-window.md` - 信息窗口:构造参数、内容/尺寸设置、最大化、与 Marker 配合使用 |
| 36 | |
| 37 | ### 3. 事件 |
| 38 | |
| 39 | - `references/map-events.md` - 地图事件:绑定方式、交互事件、视图变化事件、生命周期事件 |
| 40 | - `references/overlay-events.md` - 覆盖物事件:通用事件、拖拽事件、矢量图形事件 |
| 41 | |
| 42 | ### 4. 地图样式 |
| 43 | |
| 44 | - `references/map-style.md` - 个性化地图:自定义地图外观(颜色、显隐),实现深色主题、简洁地图等效果 |
| 45 | |
| 46 | ### 5. 图层服务 |
| 47 | |
| 48 | - `references/xyz-layer.md` - 第三方图层:加载 XYZ/TMS/WMS/WMTS 标准瓦片 |
| 49 | - `references/mvt-layer.md` - 矢量瓦片:加载 MVT/PBF 格式瓦片,支持样式表达式、特征交互、状态管理 |
| 50 | |
| 51 | ### 6. 路径规划 |
| 52 | |
| 53 | - `references/route-common.md` - 通用配置:构造参数、渲染选项、回调函数、数据结构、状态常量 |
| 54 | - `references/driving-route.md` - 驾车:策略枚举、途经点、路况、收费、拖拽 |
| 55 | - `references/walking-route.md` - 步行:转向类型、拖拽 |
| 56 | - `references/riding-route.md` - 骑行:骑行搜索 |
| 57 | - `references/transit-route.md` - 公交:市内/跨城策略、交通方式、换乘 |
| 58 | |
| 59 | ### 7. 其他LBS服务 |
| 60 | |
| 61 | - `references/local-search.md` - 本地检索:普通/范围/周边检索、结果处理、翻页、POI 数据结构 |
| 62 | - `references/geocoder.md` - 地理编码:正地理编码(地址→坐标)、逆地理编码(坐标→地址) |
| 63 | - `references/convertor.md` - 坐标转换:GPS/高德/谷歌坐标转百度坐标 |
| 64 | |
| 65 | ## 如何使用 |
| 66 | |
| 67 | 请阅读各个参考文件以获取详细说明和代码示例: |
| 68 | |
| 69 | ``` |
| 70 | references/map-init.md |
| 71 | ``` |
| 72 | |
| 73 | 每个参考文件包含: |
| 74 | |
| 75 | - 功能简要说明 |
| 76 | - 完整代码示例及解释 |
| 77 | - API 参数说明和注意事项 |
| 78 | |
| 79 | ## 注意事项 |
| 80 | |
| 81 | - `references/get-ak.md` - 获取密钥(AK):当用户无 AK 或 AK 失效时,引导用户前往控制台申请浏览器端类型的 AK |