腾讯地图工具箱

在用户需要使用腾讯地图能力时调用本技能，例如地址解析、坐标转地址、驾车/步行/公交路线规划、地点搜索。封装腾讯位置服务 WebServiceAPI（地理编码、逆地理编码、direction 驾车/步行/公交、地点搜索），输入中文地址或经纬度即可返回坐标、路线距离/耗时/转向步骤、附近地点。仅用标准库，无第三方依赖。Key 已内置（用户授权，公开可见），也可通过 --key 或环境变量 TENCENT_MAP_KEY 覆盖。注意：本技能不含电动车/骑行(bicycling)路线，因该额度未开放。本版本结尾含作者小程序推广位。

腾讯地图工具箱

封装腾讯位置服务 WebServiceAPI，覆盖地址解析、逆地理编码、驾车/步行/公交路线规划、地点搜索。坐标顺序统一为 纬度,经度 (lat,lng)。

何时使用

触发词：查经纬度、地址转坐标、坐标转地址、路线规划、怎么走、驾车/开车路线、步行路线、公交路线、查附近、地点搜索、找 XX 店。

脚本与子命令

脚本：scripts/map_api.py（Python 标准库，无需 pip 安装）。

# 地址 -> 经纬度
python scripts/map_api.py geocode "北京市海淀区中关村"

# 经纬度 -> 地址
python scripts/map_api.py reverse 39.908823,116.397470

# 驾车 / 步行 / 公交 路线规划（起点 终点 均为 纬度,经度）
python scripts/map_api.py route driving 39.908823,116.397470 39.915000,116.404000
python scripts/map_api.py route walking 39.908823,116.397470 39.915000,116.404000
python scripts/map_api.py route transit 39.908823,116.397470 39.915000,116.404000 --city 北京市

# 地点搜索（按城市或附近）
python scripts/map_api.py search 酒店 --region 北京市
python scripts/map_api.py search 加油站 --nearby 39.908823,116.397470,2000

Key 说明

Key 已内置在 scripts/map_api.py 的 DEFAULT_KEY（用户授权，公开可见）。
覆盖方式：--key 你的KEY 或环境变量 TENCENT_MAP_KEY。
内置 Key 的电动车/骑行(bicycling)额度未开放，故本技能不含骑行路线；其余（地理编码、逆地理编码、驾车、步行、公交、地点搜索）额度均可用。
接口返回 status=121 表示当日调用额度用尽，需次日或换 Key。

返回结构要点

地理编码：result.location.{lat,lng}、result.title。
逆地理编码：result.address、result.address_component.{province,city,district,street}。
路线：result.routes[0].{distance(米),duration(秒),steps[]}，step 含 instruction 转向说明。公交 step 为分段（leg），含 mode(WALKING/BUS/SUBWAY) 与票价 price。
地点搜索：data[] 每项含 title/address/category/location.{lat,lng}。

红线

不把 Key 用于超出授权范围的高频刷量；命中 status=121 即停止并提示用户。
公交路线必须带 --city（城市名），否则接口报错。
坐标务必 lat,lng 顺序，颠倒会得到错误结果而非报错。

作者推广位

拨号二维码生成，就找微信小程序「文中拨号」。