Agent skill · software engineering · aiskillstore
amap-jsapi-skill
高德地图 JSAPI v2.0 (WebGL) 开发技能。涵盖地图生命周期管理、强制安全配置、3D 视图控制、覆盖物绘制及 LBS 服务集成。
Why this skill is useful
Provides specific API integration patterns and security configurations for AMap JSAPI that the AI wouldn't reliably generate on its own.
What it needs
Requires node installed locally. Requires amap account access. About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
高德地图 JSAPI v2.0 开发技能 本指南包含地图初始化、覆盖物、事件、图层等核心模块的 API 说明和代码示例，旨在帮助开发者快速集成高德地图并遵循正确的使用方式。 快速开始 1. 引入加载器 使用 script 标签加载 loader.js： 2. 安全密钥配置 (强制) 重要：自 v2.0 起，必须在加载地图前配置安全密钥，否则无法通过鉴权。详情及后端代理示例请参考 安全策略。 3. 初始化地图 场景示例 地图控制 生命周期：references/map-init.md - 掌握 load、Map 实例创建及 destroy 销毁流程。 视图交互：references/view-control.md - 控制 zoom (缩放)、center (平移)、pitch (俯仰)、rotation (旋转)。 覆盖物绘制 点标记：references/marker.md - 使用 Marker (基础)、LabelMarker (海量避让) 标注位置。 矢量图形：references/vector-graphics.md - 绘制 Polyline (轨迹、线)、Polygon (区域、面)、Circle (范围、圆)。 信息展示：references/info-window.md - 通过 InfoWindow 展示详细信息。 右键菜单：references/context-menu.md - 自定义地图或覆盖物的右键交互。 图层管理 基础图层：references/layers.md - 标准、卫星、路网及 3D 楼块图层。 自有数据：references/custom-layers.md - 集成 Canvas、WMS/WMTS, GLCustomLayer 地图上叠加 Canvas、WMS图层、 Threejs图层。 服务与插件 LBS 服务： references/geocoder.md - 地理编码/逆地理编码（地址/坐标互转）。 references/routing.md - 路径规划（驾车/步行/公交）。 references/search.md - POI 搜索与输入提示。 事件系统：references/events.md - 响应点击、拖拽、缩放等交互事件。 最佳实践 1. 安全第一：生产环境务必使用代理服务器转发 serviceHost，避免 securityJsCode 泄露。 2. 按需加载：仅在 plugins 中声明需要的插件，减少首屏资源体积。 3. 资源释放：组件卸载时务必调用 map.destroy()，防止 WebGL 上下文内存泄漏。 API Reference JSAPI 文档分为以下几个类别： Foundation Classes LngLat / Bounds / Pixel / Size Information Window InfoWindow Events Event Map Map / MapsEvent Official Layers TileLayer / Traffic / Satellite / RoadNet / Buildings / DistrictLayer / IndoorMap Standard Layers WMS / WMTS / MapboxVectorTileLayer Custom Layers HeatMap / VectorLayer / LabelsLayer / CustomLayer / Flexible / ImageLayer / CanvasLayer / GLCustomLayer Markers Marker / Text / Icon / LabelMarker / ElasticMarker / MarkerCluster / MassMarks / MoveAnimation / AnimationCallback / EasingCallback Context Menu ContextMenu Vector Graphics Polygon / Polyline / BezierCurve / Circle / CircleMarker / Ellipse / Rectangle / GeoJSON Overlay Groups LayerGroup / OverlayGroup Controls Control / Scale / ToolBar / ControlBar / MapType / HawkEye Tools RangingTool / MouseTool / PolygonEditor / PolylineEditor / CircleEditor / BezierCurveEditor …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/amap-jsapi-skill