Back to skills
extension
Category: Data & AnalyticsAPI key required

新能源充电桩地图

基于高德地图 API,将指定城市全部充电桩以地图点位展示,标注充电桩数量与快充/慢充类别,生成单文件可交互 HTML 地图。

personAuthor: user_af163eaahubcommunity

新能源充电桩地图

触发词

充电桩地图 / 充电站分布 / 查本市充电桩 / 做充电地图

适用场景

新能源车主想一眼看全本市充电桩位置、数量与快慢充类型,规划补能。

核心能力

按城市拉取充电桩 POI;解析数量与快/慢充类别;地图标记点 + 点聚合;点击信息卡展示详情;侧边搜索列表。

工作流程

  1. 需求采集:询问目标城市名,以及是否已有「高德 Web 服务 key」(无则给免费申请指引:高德开放平台 → 个人开发者 → 创建应用 → 添加 KEY)。
  2. 环境准备:从环境变量 AMAP_KEY 读取 key;未配置则提示用户申请并填入,页面内用占位符 <YOUR_AMAP_KEY> + 顶部注释说明,不写死真实 key
  3. 数据拉取:用 Python 调用高德「关键字搜索」API(https://restapi.amap.com/v3/place/text?keywords=充电站&city={城市}&key=$AMAP_KEY),分页拉取全量 POI,写入技能目录内 data/stations.json相对路径,禁止硬编码 ~/.workbuddy 或 /Users/xxx)。翻页控速(每页间隔 ≥200ms)避免配额限制。
  4. 数据解析:提取每条的 名称 / 地址 / 经纬度 / 运营商;从名称或类型推断「充电桩总数、快充数、慢充数」(若 API 未直接给数量,则标注「数量未公开」而非编造)。
  5. 地图渲染:生成单文件 charging-map.html——引入高德 JS API 2.0,标记点启用 AMap.MarkerCluster 点聚合;点击弹信息卡(名称 / 地址 / 充电桩总数 / 快充数 / 慢充数 / 运营商);侧边列表支持名称搜索与点击联动定位;响应式适配手机/电脑。
  6. 合规校验:地图必须基于高德合规底图,确保中国国界与海岸线正确(加载 geo-map-compliance-guard 规则兜底)。
  7. 交付:本地双击打开 HTML 即看;key 不泄露、不写死。

输出规范

  • 单文件 HTML,除高德 CDN 外无外部依赖。
  • 信息卡固定展示:点位名称、地址、充电桩总数、快充数、慢充数、运营商。
  • 不含用户评价模块(按需求仅展示点位与快慢充类别)。

注意

  • 充电桩「数量 / 快慢充」以 API 返回为准;未返回则标「未公开」,严禁编造
  • 城市名须明确(如「深圳」),避免歧义。
  • 点位超量时必须点聚合,防止地图卡顿。
  • 中文显示正常,信息卡字体清晰。

红线

  • 禁止编造充电桩数量、快慢充数据或评价。
  • 禁止硬编码 key 或个人绝对路径。
  • 禁止用 Google Maps 等不合规底图。
  • 禁止把用户城市数据写死进技能目录。

适用边界

  • 依赖高德 POI 数据覆盖度;极偏远地区可能点位不全。
  • 需要用户自备高德 key(免费个人版有日配额)。
  • 纯静态快照,不含实时空闲桩状态。

示例

用户:「深圳的充电桩做个地图」→ 输出 charging-map.html:高德合规底图 + 全市充电站点聚合,点开看某站「快充 6 / 慢充 4 / 运营商 X」。

跨平台安装

本技能为纯规则 Skill,可安装于任意智能体客户端(不绑定单一平台):

  • WorkBuddy:复制到 ~/.workbuddy/skills/{slug}/
  • Claude:复制到 ~/.claude/skills/{slug}/
  • Cursor:复制到 ~/.cursor/skills/{slug}/
  • Codex / Windsurf / Gemini / Copilot / OpenClaw 等:复制到对应客户端的 skills/{slug}/ 目录 安装后在该客户端对话中即可用触发词调用。所有数据/示例文件均使用技能目录内相对路径(如 本技能目录内的 data/),不依赖任何平台专属绝对路径。

数据文件约定(R15)

  • POI 数据存于技能目录内 data/stations.json 相对路径;key 通过环境变量 AMAP_KEY 注入,均不写死平台/个人绝对路径。