用途:腾讯地图位置服务 Skill,面向地址与地点搜索、周边查询、路线规划、旅游行程规划,以及地图数据和轨迹数据的可视化展示。当用户表达搜索地点、查找某位置周边美食酒店景点、规划出行路线或生成轨迹图等意图时可调用。
主要能力:
- 搜索:支持关键词 POI 搜索,以及基于中心点坐标加半径的周边/附近搜索。
- 规划:支持旅行日程规划,以及步行、驾车、骑行、公交等路径规划。
- 可视化:地图数据可视化,以及用户提供轨迹数据后的轨迹图展示。
使用方式: 首次使用需安装 tmap-lbs:npm install @tencent-map/lbs-skills -g。 使用前必须配置正式 Key,可通过 tmap-lbs config set-key <你的Key> 配置,或设置环境变量 export TMAP_WEBSERVICE_KEY=<你的Key>,也可在对话中直接提供。申请地址为 https://lbs.qq.com/dev/console/key/manage。 Skill 加载后第一步即检查是否已有正式 Key,未检测到 Key 时会拦截并提示用户选择正式模式或受限体验模式。 正式模式下不建议在浏览器端使用 JSONP,以免 Key 泄露,应通过 CLI 或服务端代理转发。
体验模式规则(仅资料所述):无正式 Key 时可选用腾讯位置服务平台预设体验 Key。此模式下将域名 https://apis.map.qq.com 替换为 https://h5gw.map.qq.com,设置 key=none,并按接口路径填写对应 apptag;需使用 JSONP 调用(附加 output=jsonp&callback=函数名)。体验 Key 存在访问频次上限、数据稳定性一般、不建议用于生产环境,且电动车路线等接口不可用。每次体验模式 API 调用后需提示用户申请正式 Key。
场景说明:Skill 按场景一至五处理,包含周边搜索、POI 详细搜索、路径规划、旅游规划和轨迹可视化,各场景详细步骤需读取 references/ 目录下对应文档。场景五轨迹可视化不需要 API Key。
限制:坐标格式为纬度在前、经度在后;若 API 返回 status 不为 0 则请求失败;API Key 需妥善保管。体验模式下电动车路线不可用,且存在 CORS 限制。其他未在资料中说明的收费、配额、平台支持等信息暂未提供。