| name | tencentmap-map-assistant |
| description | 腾讯位置服务·地图助手 Skill，一句自然语言调用腾讯地图全套能力，无需开发者账号、开箱即用。提供 AI 旅游攻略、地点搜索（含评分/人均/营业时间）、关键词提示、路线规划（驾车/步行/公交/骑行）、地址解析与逆解析、行政区划、IP 定位、距离计算、天气查询，并可将行程或多 POI 渲染成网页地图。涉及找地点、规划路线、旅游行程、查天气、坐标转换等出行场景时使用。 |
| version | 1.4.4 |
| license | MIT |
| display_name | 腾讯位置服务·地图助手 |
| display_name_en | Tencent Map Assistant |
| description_zh | 腾讯位置服务出品的地图助手 Skill。一句自然语言即可调用腾讯地图全套能力：AI 旅游攻略生成、POI 搜索（含评分/人均/营业时间）、路线规划（驾车/步行/公交/骑行）、地址坐标互转、行政区划查询、天气查询，并可将行程或 POI 渲染为网页地图。零配置开箱即用，支持配置正式 Key 提升稳定性。 |
| description_en | A map assistant powered by Tencent Location Services. Call the full suite of Tencent Maps with natural language: AI travel guides, POI search with ratings and price levels, route planning (driving/walking/transit/biking), geocoding and reverse geocoding, district queries, weather, and web map visualization of itineraries and POIs. Zero-config ready to use, with optional API key for enhanced stability. |
| visibility | public |
| icon | https://codebuddy-platform-1258344699.cos.accelerate.myqcloud.com/public/803d2199-f921-4b57-83b7-95ffefb69248/avatar/skill/au_3e746d31-4d9.png |
地图助手 Skill
腾讯位置服务出品。用一句自然语言即可生成旅游攻略、搜索地点、规划路线、解析地址坐标，并可将结果渲染成网页地图。
能力
能力命名与腾讯位置服务官网 WebService API 对齐。完整参数签名见下方「参数与返回」。
| 能力 | 说明 | 方法 |
|---|
| AI 旅游攻略 | 自然语言 query → 多日行程攻略，可联动腾讯地图小程序，与朋友共同编辑行程、规划多人出行 | travel_guide |
| 地点搜索 | 城市/区域搜索、周边圆形搜索、POI 详情 | poi_search / poi_nearby / poi_detail |
| 关键词输入提示 | 输入补全候选 POI | poi_sug |
| 行政区划 | 省市区列表、下级区划、区划搜索 | district_list / district_children / district_search |
| 地址解析 | 地址 → 坐标 | geocoder |
| 逆地址解析 | 坐标 → 地址（可附周边 POI） | regeocoder |
| IP 定位 | IP → 位置 | ip_location |
| 路线规划 | 驾车 / 步行 / 公交 / 骑行 | direction |
| 批量距离计算 | 多对多距离矩阵 | distance_matrix |
| 天气查询 | 行政区/坐标 → 实时或预报天气 | weather |
| 行程 / POI 可视化 | 把行程或多 POI 结果渲染为网页地图 | — |
安装
仅依赖 requests（多数环境已自带）。如缺失：
pip install requests
用法
import sys, os
sys.path.insert(0, os.path.expanduser('~/.workbuddy/skills/TencentMap_map-assistant/scripts'))
from tmap_client import TmapClient
client = TmapClient()
result = client.travel_guide("武汉5天攻略")
pois = client.poi_search("黄鹤楼", region="武汉")
addr = client.geocoder("深圳市腾讯滨海大厦")
配置自己的腾讯位置服务 Key（持久化到 skill 包内 .env，之后自动启用）：
