1.0.2 • Published 4d agoCLI
@maptec/jsapi-skills
Licence
MIT
Version
1.0.2
Deps
0
Size
110 kB
Vulns
0
Weekly
0
jsapi-skills
为 AI Agent 提供 MAPTEC JSAPI 服务能力的 Skill 集合，支持地图加载、交互、控件、事件、覆盖物、地点检索、路线规划等功能。
简介
jsapi-skills 把 Maptec JSAPI 能力整理成结构化文档，供 AI Agent 进行能力归类、API 选型、参数约束、生命周期清理和代码生成。核心入口是 SKILL.md，各项能力的详细规则在 references/ 目录下。
功能列表
| 能力 | 说明 | 用户示例 |
|---|---|---|
| 地图加载 | 创建地图实例，初始化加载地图 | “生成一个新加坡的地图” |
| 地图交互 | 拖拽、缩放、旋转、倾斜、手势控制、交互开关配置 | “禁止用户旋转或拖拽地图” |
| 地图控件 | 缩放导航、比例尺、全屏、指南针、鹰眼控件配置 | “在地图右下角添加比例尺控件” |
| 样式切换 | 白天 / 黑夜模式切换 | “将地图切换为黑夜模式” |
| 事件监听 | 地图点击、缩放变化、中心点变化、覆盖物点击等 | “点击地图获取当前位置的经纬度” |
| Marker | Marker 覆盖物 | “在点击位置增加 Marker 点” |
| 矢量覆盖物 | 点、线、圆、多边形的样式、数据与事件绑定 | “在地图上绘制一个半径 2000 米的圆形” |
| 信息窗口 | 信息窗口覆盖物 | “点击地图增加一个信息窗口” |
| 轨迹动画 | 关键帧轨迹、轨迹增长、沿线移动、车头朝向、视角跟随 | “让小车图标沿路线移动” |
| POI 检索 | 关键词、周边、类型、详情检索 | “搜索新加坡所有咖啡馆并标注” |
| 路线规划 | 驾车路线规划与展示 | “绘制 NUS 到乌节路的驾车路线” |
| 地理编码 | 地址转经纬度坐标 | “将新加坡摩天观景轮标注在地图上” |
| 逆地理编码 | 经纬度坐标转地址信息 | “将用户当前位置坐标转换为详细地址” |
安装 Skill
用于将 jsapi-skills 安装到本机 Agent Skills 目录，供 AI Agent 识别和使用。
（1）通过 npm 包安装
npx @maptec/jsapi-skills install安装完成后，默认目录为：~/.agents/skills/jsapi-skills
（2）自定义安装目录
支持用环境变量 MAPTEC_SKILL_INSTALL_DIR 指定安装父目录：
MAPTEC_SKILL_INSTALL_DIR=/path/to/skills npx @maptec/jsapi-skills install（3）GitHub 开源地址
jsapi-skills 已开源到 GitHub 的 maptec-api/jsapi-skills 仓库，可以查看源码、了解目录结构，或在本地按需扩展能力文档：
https://github.com/maptec-api/jsapi-skills
如何被 Agent 使用
- 根据用户需求归类到功能列表中的一个或多个能力。
- 按
SKILL.md的能力路由，只读取相关的references/*.md。 - 使用参考文档中的真实 Maptec 类、方法、参数和生命周期规则。
- 生成代码前说明命中的能力和使用的 API。
- 生成代码时必须包含错误处理、空结果处理、事件解绑和资源清理。
- 对不确定的能力标记
需确认 Maptec 是否支持，不要写成确定 API。