Agent Skills
返回列表
腾讯地图 WebService API

腾讯地图 WebService API

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @tencent-adm/tencentmap-webservice-skill。

技能介绍

解决的问题

做位置功能时,常见麻烦不只是调用腾讯地图,而是把地址、坐标、路线、距离、天气和 Key 权限串起来。手工拼 GET 请求容易踩坐标顺序、坐标系、配额和错误码的坑。

技能如何工作

它按用户意图路由到腾讯位置服务 WebService API,并覆盖以下场景:

  • 地址服务:/ws/geocoder/v1/ 做地址解析、逆解析和智能地址解析
  • 搜索服务:地点搜索、关键词提示、行政区划
  • 路线服务:驾车、步行、骑行、公交,以及 /ws/distance/v1/matrix 距离矩阵
  • 定位与天气:IP 城市级定位和天气查询
  • 坐标转换:GPS/百度等坐标转入 GCJ-02

关键步骤是:先检查或保存 key,再判断场景,组合请求时先得到坐标,再执行搜索、路线或天气。若某个 Key 失效,它会切换候选 Key 并给出失败原因。它把接口调用、key 候选和错误处理放在同一个工作流里,减少重复排查。

边界与注意点

坐标统一为 纬度,经度,GPS 原始坐标需先转换;key、QPS、白名单和权限开通都会影响调用。智能地址解析需企业认证,距离矩阵、途经点、坐标点数量都有上限。适合需要把位置能力嵌入应用或脚本的工程师。

使用场景

  • 把收货地址解析为坐标,再调用天气接口查询当前天气。
  • 在门店拓展时,用关键词搜索周边 POI 并获取行政区划信息。
  • 为车队批量计算多个起终点的驾车距离矩阵,减少循环请求。
  • 将 GPS 原始坐标转换为 GCJ-02,再规划公交或驾车路线。

适合人员

  • 需要把订单地址转成坐标并调用天气或路线接口的前端工程师
  • 要在报表中批量计算门店间驾车距离矩阵的数据工程师
  • 需要从聊天记录文本中提取地址和联系人的后端工程师
  • 要在应用中接入腾讯地图 POI 搜索和输入提示的全栈工程师