SuperAPI AI 工具集

tencentmap-lbs-skill

通用与其它

查看项目

更新于 10-16 08:26

技能介绍

腾讯地图位置服务开发技能面向需要在对话中查询地点、搜索周边、规划路线和展示轨迹数据的场景,调用腾讯位置服务提供的地图数据能力。

【主要能力】

  • 搜索:支持关键词与 POI 搜索;支持基于中心点坐标和半径的周边搜索。
  • 规划:支持步行、驾车、骑行(自行车)、电动车、公交等多种出行方式的路径规划,以及旅行日程规划。
  • 数据可视化:支持地图数据可视化与轨迹数据可视化展示;轨迹可视化场景不需要 API Key。

【使用方式】 首次使用需安装 tmap-lbs,若需更新也使用同一命令:

npm install @tencent-map/lbs-skills -g

前置检查 API Key:

  • 已有正式 Key(环境变量 TMAP_WEBSERVICE_KEY、tmap-lbs config get-key 或对话中提供)→ 直接使用。
  • 未检测到 Key 时,会向用户输出选项:申请临时体验 Key(推荐,手机验证即可,14 天有效);或前往 https://lbs.qq.com/dev/console/key/manage 注册正式 Key。用户选择申请临时 Key 时,读取 tempkey-guide.md 并按其中步骤执行。

【场景判断】 收到请求后先判断场景:

  • 场景一:基于位置的周边或附近搜索。输入中同时包含「位置」和「搜索类别或 POI 类型」(如“西直门周边美食”“北京南站附近酒店”“搜索亚洲金融大厦附近的奶茶店”)。需先通过地理编码 API 获取该位置经纬度,再拼接带坐标的搜索链接;须先读取 references/scene1-nearby-search.md 并按文档步骤执行。
  • 场景二:POI 详细搜索,使用 Web 服务 API,支持关键词搜索、城市限定、周边搜索等,详见 references/scene2-poi-search.md。
  • 场景三:路径规划,详见 references/scene3-route-planning.md。
  • 场景四:旅游规划。用户提供多个想去的景点时规划最佳行程路线,可选推荐餐厅、酒店等;需先通过地理编码 API 获取各景点经纬度,再拼接旅游规划链接,须先读取 references/scene4-travel-planner.md 并按文档执行。
  • 场景五:轨迹可视化。用户提供轨迹数据地址或数据并希望生成轨迹图(如“轨迹”“轨迹图”“GPS 轨迹”“运动轨迹”“行驶轨迹”),无须 API Key,须先读取 references/scene5-trail-map.md 并按文档执行。

【触发条件】 用户表达以下意图之一:搜索某类地点或某个确定地点(如“故宫在哪”“搜酒店”“找加油站”);基于某位置搜索周边(如“奥林匹克公园周边美食”“北京西站附近的加油站”);包含“搜”“找”“查”“附近”“周边”“路线”“规划”等关键词;旅游规划(如“帮我规划北京一日游”“杭州西湖游览路线”);规划路线(如“从故宫到南锣鼓巷怎么走”“规划一条骑行路线”);轨迹可视化(如“帮我生成轨迹图”“上传轨迹数据”“GPS 轨迹展示”)。

【注意事项】

  • 场景判断是关键:区分“直接搜某个东西”“在某个位置附近搜某个东西”“规划路线”还是“旅游规划”。
  • 关键词应尽量精简准确,提取用户真正想搜的内容。
  • URL 中的中文关键词浏览器会自动处理编码,无需手动 encode。
  • 腾讯地图坐标格式为 纬度,经度(纬度在前,经度在后)。
  • 如果 API 返回 status 不为 0,说明请求失败,需提示用户检查地址是否有效。
  • API Key 请妥善保管,切勿分享给他人。

【文档引用】 references/scene1-nearby-search.md:场景一周边/附近搜索的执行步骤、API 格式、完整示例、回复模板;references/scene2-poi-search.md:场景二 POI 详细搜索的请求格式、参数说明、返回数据格式;references/scene3-route-planning.md:场景三路径规划的请求格式、API 端点、参数和返回数据说明;references/scene4-travel-planner.md:场景四旅游规划的使用方法与功能说明;references/scene5-trail-map.md:场景五轨迹可视化的 URL 格式、执行步骤、完整示例、回复模板。