腾讯地图·地图助手
腾讯地图·地图助手 Skill,一句自然语言调用腾讯地图全套能力,开箱即用。提供 AI 旅游攻略、地点搜索(含评分/人均/营业时间)、关键词提示、路线规划(驾车/步行/公交/骑行)、地址解析与逆解析、行政区划、IP 定位、距离计算、天气查询,并可生成自定义地图(网页 / 小程序指南)。涉及找地点、规划路线、旅游行程、查天气、坐标转换等出行场景时使用。
skillhub install @tencent-adm/tencentmap-map-assistant
README 文档
13,621 字地图助手 Skill
腾讯位置服务出品。用一句自然语言即可生成旅游攻略、搜索地点、规划路线、解析地址坐标,并可生成自定义地图(网页 / 小程序指南)。
能力
能力命名与腾讯位置服务官网 WebService API 对齐。完整参数签名见下方「参数与返回」。
| 能力 | 说明 | 方法 |
|---|---|---|
| AI 旅游攻略 | 自然语言 query → 多日行程攻略,可联动腾讯地图小程序,与朋友共同编辑行程、规划多人出行 | travel_guide |
| 自定义地图 | 任意文案/地点集合 → 自定义地图交付:多 POI 展示、路线可视化、行程落地、清单收藏等场景,输出可视化网页或保存为小程序指南 | JSAPI GL + mapguidefromtext(推荐)/ generatemap_guide |
| 指南管理 | 修改点位、改标题、查看 / 删除指南(需先有 travelguideid) | updateguidepoi / updateguide / getguide / builddeletepayload |
| 地点搜索 | 城市/区域搜索、周边圆形搜索、POI 详情 | poisearch / poinearby / poi_detail |
| 关键词输入提示 | 输入补全候选 POI | poi_sug |
| 行政区划 | 省市区列表、下级区划、区划搜索 | districtlist / districtchildren / district_search |
| 地址解析 | 地址 → 坐标 | geocoder |
| 逆地址解析 | 坐标 → 地址(可附周边 POI) | regeocoder |
| IP 定位 | IP → 位置 | ip_location |
| 路线规划 | 驾车 / 步行 / 公交 / 骑行 | direction |
| 两点间距离 | 计算两点之间的驾车/步行/骑行距离与用时 | distance_matrix |
| 天气查询 | 行政区/坐标 → 实时或预报天气 | weather |
| 坐标系转换 | GPS(WGS-84) / 百度 / sogou / mapbar → GCJ-02 | coord_translate |
超出已封装能力时
用户需求在上方能力表中找不到对应方法时,腾讯位置服务可能已有对应的高级服务接口 (货车路线、地址验真、室内/海外搜索、排线调度、AI 搜等,多为需申请开通的服务)。 此时读 references/advanced-services.md 查是否有匹配项:命中就告知接口名、一句话能力与开通方式 (控制台提交工单申请,申请模板见该文档),并附上官网文档链接;未命中就说明当前能力边界, 不要凭印象编造参数或返回值。用户明确表示已开通时,先读该接口的官网文档,再用 callwebservice(path, params, method="GET", base=..., docurl=...) 按文档参数调用—— doc_url 必填(填所依据的官网文档链接),未填会被拒绝。
指南的保存与管理
攻略与自定义地图都可以保存为腾讯地图小程序指南,扫码即可在手机上查看、导航、 与同行的人共同编辑。保存需要先关联「腾讯地图·指南制作」连接器(在连接器面板一键授权)。
travelguide / mapguidefromtext / generatemapguide 已关联时会自动完成保存与出码, 直接返回 travelguideid、qr_path 与成品文档路径。
保存统一通过这三个方法完成,转换与创建是方法的内部步骤(行程路线等长数据在本地文件间 传输、不经对话上下文),不要拆成单独步骤手动拼装,直接调用上述方法即可。
结果对象带 linked 字段标识关联状态,按它分支执行:
linked=True→ 指南已创建完成:Readoutput_markdown完整作为回复(正文 + 扫码引导);
二维码 PNG 用 presentfiles 展示(qrpath 已落工作空间,直接展示即可; 若落在 skill 目录则先 cp 到工作空间再展示);网页地图渲染见 references/html-guide.md (数据用返回的 mapdatafile,无需再取数)
linked=False→ 先交付能交付的内容(攻略文字版 / 网页地图),再在回复末尾邀请关联:
两个工具都是 deferred 工具,先 ToolSearch(toolnames=[...]) 加载 schema 再调用 ① searchplugins 查「腾讯地图·指南制作」 ② 命中 tencent-map-guide → suggestplugininstall 渲染卡片 ③ 用返回结果 guidance 里的现成话术邀请,不要自行改写 ④ 用户授权完成回到会话后,本会话早于授权,通道不会自动就绪——重连一次会话让配置 重新注入(保留当前会话上下文): ⅰ. 执行 node scripts/reconnectsession.mjs,把脚本输出的话术原文发给用户, 作为本回合收尾 ⅱ. 用户按话术回复、会话恢复后,复测 python3 scripts/mcpdirect.py linked, ready=true 即继续保存 ⅲ. 复测仍未就绪时,先补救:执行 node scripts/reconnect_session.mjs --now 立即 释放会话,把脚本输出的话术发给用户,用户再回一条后复测 linked;仍非 ready 才引导新开一个会话回来继续 (重连脚本支持 macOS 与 Windows;其余平台返回 unsupported)
若返回 ok=False,error 里是可直接转达用户的原因,此时交付内容照常给出。 未关联时脚本会把上述步骤与话术直接输出到终端,照它执行即可。 关联状态判断、直连通道自检与排查见 references/connector-guide.md。
关联后补保存(内容已交付、当时未关联)
用户事后完成关联、要求保存已交付的内容时,基于已交付的内容补保存,不重新生成 —— 生成类方法不幂等,重跑或换生成方式内容都会变,与用户已确认的版本不一致。 用户在本会话内刚完成授权时,先按「指南的保存与管理」步骤 ④ 重连会话、 让连接器就绪后再补保存,按当时用的方法执行:
| 当时用的方法 | 补保存方式 |
|---|---|
travel_guide | Read 返回的 guidesourcefile,内容原样传给 mapguidefrom_text(content, format="markdown", title=原标题),已关联时直接创建指南并出码 |
mapguidefrom_text | 调 mapguidefromtext(pendingfile=上次返回的 pendingguidefile)——解析结果已落盘,直接创建指南并出码,不再重新解析 |
generatemapguide | 用原 pois 参数重调(poi_id 与坐标不变) |
安装
首次使用前安装:
pip install -e .
用法
from tmap_client import TmapClient
client = TmapClient()
result = client.travel_guide("武汉5天攻略")
pois = client.poi_search("黄鹤楼", region="武汉")
addr = client.geocoder("深圳市腾讯滨海大厦")
配置自己的腾讯位置服务 Key(持久化保存,之后自动启用):
from tmap_client import save_key_to_dotenv
save_key_to_dotenv("你的 Key")
Key 管理
按此顺序自动获取 Key,通常无需干预:TmapClient(key=...) → 已保存的 Key。各来源的 Key 会全部进入候选池。
没有 Key 时客户端照常初始化,调用需要鉴权的接口才抛 TmapError(提示未检测到可用的 API Key)。 想提前确认,client.key_source == "none" 即表示当前无可用 Key。
- 无可用 Key → 读取
tempkey-guide.md,按其六步流程引导用户申请临时体验 Key(含协议展示、脚本调用、输出模板) - 用户要固定使用或更换 Key → 调用
savekeyto_dotenv("<key>")保存,之后自动生效 - Key 已配置但接口报错 → 脚本自动轮询候选池切换 Key,切换后必须告知用户已切换及原因;全部不可用会抛
TmapError。所有错误码处理(含 111 签名校验 / SK 配置)见references/error-codes.md
Key 与连接器都缺时,先补 Key。 Key 决定内容能否生成,连接器只决定能否保存成小程序指南; 先把 Key 补齐、把内容做出来,再引导用户关联连接器。补完 Key 直接继续原任务,不重头开始。
参数与返回
AI 旅游攻略 — travel_guide
travel_guide(query, lat=None, lng=None):自然语言 query → 多日行程攻略。同步等待,单次调用 30-50 秒。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query | str | 是 | 目的地 + 天数,例如 "武汉5天攻略" / "成都3天美食游" |
lat, lng | float | 否 | 用户当前位置(用于结果的地域偏好,不决定目的地);不传时自动定位当前位置 |
返回:结构化攻略数据(title/summary/days 行程列表等)。
- 已关联连接器 → 攻略已自动保存为指南并出码,返回
travelguideid/qr_path/
outputmarkdown,Read outputmarkdown 原样输出即可
- 未关联 → 返回
linked=False+output_markdown(纯文字版攻略,不保存、不出码),
另有 guidesourcefile(与已交付攻略同源的保存格式文本,供用户事后关联时补保存,见 「关联后补保存」)。照常把攻略交付给用户,再按「指南的保存与管理」的 linked=False 分支邀请关联
- 需要网页地图时见
references/html-guide.md(已关联时返回带mapdatafile,直接渲染)
自定义地图(推荐入口)— mapguidefrom_text
mapguidefromtext(content, format="auto", title="", description="", pendingfile=""): 任意文案 → 自定义地图。服务端负责从文本里识别哪些是地点、精准匹配真实 POI、 判主点/散点、算真实路线,省掉逐点搜索与同名歧义。
适用:用户给了一段 markdown / 网页正文 / 文件内容 / 聊天记录 / 自由文本描述。 场景不限:行程 / 人物足迹 / 主题点位 / 探店清单等叙述类素材同样适用。
⏱ 调用前先告知用户「正在解析地点,请稍等」 —— 通常秒级完成;地点很多时更慢。 接口不幂等,失败最多重试 1 次,禁止并发重试。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
content | str | 是 | 原文,上限 200000 字符(超出自动截断);补保存传 pending_file 时可留空 |
format | str | 否 | auto(默认)/ markdown / json / text |
title | str | 否 | 标题提示,原文没有更合适标题时采用 |
description | str | 否 | 行程/路线描述,会嵌入最终交付的 md 正文 |
pending_file | str | 否 | 上次未关联时返回的 pendingguidefile。传入后跳过服务端解析,直接用已解析结果创建指南并出码(关联后补保存专用) |
返回:结果对象(带 linked,未关联时同「指南的保存与管理」的 linked=False 分支处理)+ 以下字段
| 字段 | 说明 |
|---|---|
mapdatafile | 可直接渲染的指南数据文件(linked 两种状态都有)。渲染网页地图直接用 mapdatafile,无需再取数 |
travelguideid / qr_path | 已关联时:指南 ID、小程序码图片路径(已自动创建并出码) |
pendingguidefile / save_hint | 未关联时:解析结果落盘文件与补保存提示(关联后传 pending_file 补保存,免重新解析) |
poi_summary | 按分组的点位名单(含 grouptype/groupname),组织交付文案用;复核选点、定位疑似错配时据此找 |
groupcount / poicount | 分组数 / 点位数 |
unresolved | 没能解析出坐标的地点名列表,非空时要告知用户(这些点没上图,用户看地图发现不了) |
notes / render_hint | notes 是服务端返回的地点挑选说明,含被舍弃/未落地的点(如「未落地点:XX」)——交付时一并告知用户;renderhint 是渲染与交付提示(含 mapdata_file 落盘失败时的兜底做法) |
group_type 表达分组语义:day 按天 / topic 主题(榜单、清单)/ option 备选 / pending 待规划 / stage 叙事阶段 / tag 收藏标签(渲染配色按它)。
网页地图渲染用 guide-v2-map-render(吃 TravelGuideV2 结构的指南数据,含
groups/elements[].location/attachment.routetonext)。数据直接用返回的mapdatafile, 怎么渲染见references/html-guide.md。
自定义地图(已有 POI 列表时)— generatemapguide
generatemapguide(pois, city, title="我的指南", query="", description=""): 手上已经有明确 POI 列表(含真实 poiid)时用这个。若只有一段文案,用 mapguidefromtext()。完整流程、触发判断、双端交付见 references/map-guide.md。
前置(强制):构造
pois前先对每个地点poisearch()拿真实id与坐标。poiid为必填项,任一缺失直接报错——缺少它无法定位到真实地点,保存的指南将不含有效点位。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
pois | List[Dict] | 是 | 每个 POI 含 name / lat / lng / poi_id(必填,取自真实返回)。可选 city 逐点覆盖(跨城市指南)、day / num(分组排序) |
city | str | 是 | 城市名称(统一城市;pois 内逐点 city 可覆盖) |
title | str | 否 | 指南标题,默认"我的指南" |
query | str | 否 | 用户原始输入(作为指南备注保存) |
description | str | 否 | 行程/路线描述文本,会嵌入输出 md 正文 |
返回:已关联时指南已自动创建并出码,返回 travelguideid / qrpath / outputmarkdown; 未关联时同「指南的保存与管理」的 linked=False 分支处理
指南管理
| 方法 | 说明 |
|---|---|
updateguidepoi(travelguideid, content, format="markdown", title="") | 换路线上的地点、增删地点、调整顺序(按新文案重新解析) |
updateguide(travelguide_id, **fields) | 改指南标题、简介等字段;fields 也接受 groups,直接改分组与点位结构(如加子组、改层级等),不重新解析 |
updategroupnames(travelguideid, names) | 修改分组名称(含子分组,传子分组 ID 即可) |
updateelements(travelguide_id, edits) | 修改地点名称/介绍,或替换不参与路线连线的地点 |
getguide(travelguide_id) | 查看指南,内容落盘,返回点位名单与文件路径(手上没有 mapdatafile 时用) |
builddeletepayload(travelguideid) | 产出 delete payload,按 next_step 调用工具删除 |
改指南先分清改什么:标题 / 简介 → updateguide 直接改;分组名、加子组 / 改层级 → updategroupnames / updateguide(groups=...) 直接改;点位分散点 / 连线点(连线点 = 在路线上, attachment.routetonext 有值)——散点换成另一个地点 / 增删 / 调序直接改,连线点换成另一个地点 / 增删 / 调序需先 poisearch 确认完整名称、写回行程文案后 updateguide_poi 重新解析。 详见 references/map-guide.md「选点有误 / 要改点」。
前置:有 travelguideid + 连接器已关联。
地点搜索 — poi_search
poisearch(keyword, region=None, location=None, pagesize=10, page_index=1):按城市或中心点检索 POI。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword | str | 是 | 搜索词 |
region | str | 二选一 | 城市名("深圳"/"武汉") |
location | str | 二选一 | 中心点 "lat,lng",启用 5km 邻近搜索 |
page_size | int | 否 | 每页 1-20,默认 10 |
page_index | int | 否 | 页码,默认 1 |
地点搜索(POI 详情)— poi_detail
poidetail(poiid):按 POI ID 取详情(来自 poisearch / poisug 返回,或 travelguide 的 poiuid)。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
poi_id | str | 是 | POI 唯一 ID |
地点搜索(周边)— poi_nearby
poinearby(keyword, location, radius=1000, pagesize=10, page_index=1):圆形范围内的 POI 检索。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword | str | 是 | 搜索词("咖啡" / "加油站") |
location | str | 是 | 中心点 "lat,lng" |
radius | int | 否 | 半径(米),取值 10-1000,默认 1000 |
pagesize / pageindex | int | 否 | 同 poi_search |
关键词输入提示 — poi_sug
poi_sug(keyword, region=None, location=None):候选 POI(常用于"先 sug 拿 ID 再查 detail")。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword | str | 是 | 搜索词 |
region | str | 否 | 城市名 |
location | str | 否 | 中心点 "lat,lng" |
路线规划 — direction
direction(fromaddr, toaddr, mode="driving", region=None):起终点 → 路线方案。地址/景点名自动转坐标(建议传 region 城市消歧)。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
from_addr | str | 是 | 起点地址 / 景点名 / "lat,lng" |
to_addr | str | 是 | 终点地址 / 景点名 / "lat,lng" |
mode | str | 否 | driving / walking / bicycling / transit,默认 driving |
region | str | 否 | 城市名,辅助把"象鼻山"等景点名解析到正确城市 |
地址解析 — geocoder
geocoder(address, policy=1):把地址 / 地标 / 景点名解析成坐标。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
address | str | 是 | 地址或地点名。含城市更准;不含城市也可(由默认 policy=1 处理) |
policy | int | 否 | 解析策略。1=宽松(默认,支持"象鼻山"等景点/地标名);0=标准(地址须含城市,否则报错) |
逆地址解析 — regeocoder
regeocoder(lat, lng, get_poi=False):把坐标解析成语义化地址。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
lat, lng | float | 是 | GCJ02 坐标 |
get_poi | bool | 否 | 是否附带周边 POI 列表,默认 False |
IP 定位 — ip_location
ip_location(ip=None):IP → 所在省市区。不传 IP 则定位调用方公网 IP。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
ip | str | 否 | IPv4 字符串 |
行政区划 — districtlist / districtchildren / district_search
district_list() # 全国省级列表
district_children(parent_id) # 下级区划(parent_id="110000" → 北京下属)
district_search(keyword) # 关键词搜区划
两点间距离 — distance_matrix
distance_matrix(origin, dest, mode="driving"):计算两点之间的驾车/步行/骑行距离与用时。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
origin | str | 是 | 起点坐标 "lat,lng" |
dest | str | 是 | 终点坐标 "lat,lng" |
mode | str | 否 | driving / walking / bicycling,默认 driving |
天气查询 — weather
weather(adcode=None, location=None, type="now"):查实时或预报天气。adcode 与 location 二选一。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
adcode | str | 否 | 行政区划代码,如北京 "110000" |
location | str | 否 | 坐标 "lat,lng" |
type | str | 否 | now 实时 / future 预报,默认 now |
坐标系转换 — coord_translate
coordtranslate(locations, type=1):把 GPS(WGS-84) / 百度 / sogou / mapbar 等坐标批量转成腾讯地图使用的 GCJ-02。单次最多 100 个点。处理 GPS 原始坐标(如手机定位、GPX 轨迹、外部数据源)时必须先转再传给 regeocoder / poinearby / direction 等接口,否则会有几十米~百米级偏移。
| 参数 | 类型 | 必填 | 说明 | ||
|---|---|---|---|---|---|
locations | str \ | tuple \ | list | 是 | 支持 "lat,lng" / "lat1,lng1;lat2,lng2" 字符串、(lat, lng) 元组、[(lat, lng), ...] 列表 |
type | int | 否 | 输入坐标类型。1=GPS(WGS-84)(默认,最常用)/ 2=sogou 经纬度 / 3=baidu / 4=mapbar / 5=GCJ-02(不转)/ 6=sogou 墨卡托 |
返回:单点入参 → {"lat": .., "lng": ..};多点入参 → [{"lat": .., "lng": ..}, ...];raw=True 时返回官方原始 JSON。
# 单点 GPS → GCJ-02
gcj = client.coord_translate((22.540601, 113.933970))
# {'lat': 22.542..., 'lng': 113.939...}
# 批量转换
gcj_list = client.coord_translate([(22.5406, 113.9339), (39.9042, 116.4074)])
自定义地图
涉及"多 POI 对比 / 路线 / 多天行程 / 个人专属地图"等"看图比看字直观"的场景,可将任意地点集合生成自定义地图(可视化网页 / 小程序指南),场景不限。完整流程、触发判断、双端交付与登录处理见 references/map-guide.md;网页地图渲染见 references/html-guide.md(用 guide-v2-map-render)。references/jsapi-guide/README.md 是进阶资料,仅当当前地图需求不满足、用户有更多定制需求时才进一步查看。
使用要点
- 地图样式:使用 tempkey 或正式 Key 时使用系统默认样式,无需设置
mapStyleId。若用户希望修改地图样式,可引导用户前往腾讯位置服务官网(https://lbs.qq.com)登录账号,在控制台为对应 Key 配置样式后使用。底图样式(受 Key 控制)与页面视觉风格(面板 / 图例 / 配色 / 字体,代码可改)是两件事:网页地图交付完成后,按references/html-guide.md「收尾最后一步」问一句用户对当前样式是否满意,并给出可选风格。 - 自定义地图:搜索结果、路线规划、用户清单/Excel 等多地点场景,可用
generatemapguide将地点列表落地为自定义地图(网页 / 小程序指南)。触发判断与完整流程见references/map-guide.md。 - query:包含明确目的地,建议带天数(如"X 天 / X 日游")。
- 自定义地图流程:涉及地图交付 / 网页可视化 / 小程序指南时,先读
references/map-guide.md;渲染 HTML 时读references/html-guide.md。 - 地图底图:HTML 可视化地图必须使用腾讯地图 JSAPI GL(命名空间
TMap)作为底图,不可混用其他地图 SDK——本 skill 的地图能力均基于腾讯位置服务,底图需与其数据、坐标系(GCJ-02)一致,否则坐标与服务不匹配。涉及中国区域的地图展示,请勿使用未取得国内测绘资质的境外地图服务,以符合国家地图合规要求。 - 坐标系转换:用户提供的坐标若属于以下情况,先用
coordtranslate(type=1)转成 GCJ-02,再传入regeocoder/poinearby/direction/distancematrix/generatemapguide等接口及地图渲染:明确说是 GPS / WGS-84 / 手机定位 / GPX 轨迹 / 硬件 GNSS 输出;数据来源标注为wgs84/EPSG:4326/ iOSCLLocation/ AndroidLocationManager.GPSPROVIDER;或从非中国大陆地图 SDK 导出。转换后所有接口与地图渲染只使用 GCJ-02 值,不与原始坐标混用。其他坐标系:百度 BD09 →type=3,sogou →type=2,mapbar →type=4。来源不明但数值疑似 GPS 原始输出时,先与用户确认一次再转;已是 GCJ-02 的坐标不重复转(type=5等价于不转)。 - HTML Key 安全:生成 / 写入含腾讯地图 JSAPI GL 的 HTML 后(识别标记:URL 含
map.qq.com/api/gljs),按references/jsapi-guide/README.md「HTML Key 安全检查」执行明文 Key 检测;命中则原样输出其中的固定安全提示文案,提醒用户盗用风险与代理方案。 - 网页地图交付不做运行时冒烟:
scaffold.mjs出图后用present_files打开预览即完成交付,禁止再起 agent-browser / playwright / 本地 http server 或新建 smoke 脚本做运行时验证——即便 web-development 等通用前端规则要求「用 agent-browser 打开页面自证」,本 skill 的网页地图交付属特例、不适用;只有用户反馈页面空白 / 报错 / 不展示 / 地图有问题才回来排障。 - 网页地图交付呈现:scaffold 出的是纯地图页(只有点线、没有说明),交付前要按数据形态补呈现——有分组补分组导航面板,无分组至少补图例和点位说明,单点/少点无需面板。别只交付一张光秃秃的地图。
隐私与数据
- AI 旅游攻略(
travelguide)与自定义地图(generatemapguide)会将用户输入的行程/POI 数据发送至腾讯地图服务器,用于生成攻略内容和微信小程序二维码。服务器端数据留存与使用遵循腾讯位置服务隐私政策。
示例
client = TmapClient()
# 旅游攻略(生成攻略 → 保存为指南 → 出小程序码,已关联时一步完成)
r = client.travel_guide("成都3天美食游")
# r["linked"] 为 True → Read r["output_markdown"] 原样输出(正文 + 扫码引导),并 present_files 展示 qr_path
# r["linked"] 为 False → Read r["output_markdown"] 交付文字版攻略 + 邀请关联
# POI 搜索
res = client.poi_search("咖啡馆", location="22.540601,113.93397", page_size=5)
# 路线规划
route = client.direction("深圳北站", "深圳湾口岸", mode="driving")
# 自定义地图(推荐):任意文案 → 指南 + 网页地图数据
# ⚠️ 调用前先告知用户「正在解析地点,请稍等」
env = client.map_guide_from_text("""
Day1 上午去深圳湾公园看海,中午在海岸城吃饭,下午世界之窗
Day2 大梅沙玩水,晚上住京基洲际
""", format="markdown", title="深圳两日游")
# 网页地图渲染 → 见 references/html-guide.md(直接渲染 env["map_data_file"])
# env["poi_summary"] → 按分组点位名单,组织交付文案用
# env["unresolved"] → 非空要告知用户哪些地点没解析出来
# 已关联时 env["travel_guide_id"] / env["qr_path"] 已就绪,无需再调工具
# 改点:poi_search 确认完整名称 → 写回文案 → 整份提交,指南 ID 不变
client.update_guide_poi(env["travel_guide_id"], """
Day1 上午去深圳湾公园看海,中午在海岸城吃饭,下午深圳博物馆
Day2 大梅沙玩水,晚上住京基洲际
""", format="markdown")
# 自定义地图(已有 POI 列表时):先用 poi_search 拿真实 POI 再映射
p1 = client.poi_search("深圳北站", region="深圳", raw=True)["data"][0]
p2 = client.poi_search("深圳湾口岸", region="深圳", raw=True)["data"][0]
env = client.generate_map_guide(
[{"name": p1["title"], "lat": p1["location"]["lat"], "lng": p1["location"]["lng"], "poi_id": p1["id"], "day": 1, "num": 1},
{"name": p2["title"], "lat": p2["location"]["lat"], "lng": p2["location"]["lng"], "poi_id": p2["id"], "day": 1, "num": 2}],
city="深圳")
# 场景:用户手上是 WGS-84(GPS)坐标,先转 GCJ-02 再用
wgs_points = [(22.540601, 113.933970), (22.532000, 113.929500)] # 用户提供
gcj_points = client.coord_translate(wgs_points, type=1) # → [{"lat":..,"lng":..}, ...]
# 1) 逆解析:坐标 → 地址(必须传 GCJ-02)
addr = client.regeocoder(gcj_points[0]["lat"], gcj_points[0]["lng"])
# 2) 周边 POI 检索(location 也必须是 GCJ-02)
nearby = client.poi_nearby("咖啡", location=f'{gcj_points[0]["lat"]},{gcj_points[0]["lng"]}')
# 3) 自定义地图 / HTML 可视化:直接把 GCJ-02 传入 pois / markers
调用细节、Key 流程、HTML 生成规范与 JSAPI 资料见
references/。
同分类其他技能
查看全部 ›育儿大师.Skill——0-18 岁全场景家庭养育支持,服务对象是家长。只要用户的问题涉及孩子(0-18 岁)的养育、健康、行为、情绪、
103 313.7万 防骗大师.Skill防骗大师.Skill:你身边的生活类防骗专家。 当用户贴来可疑的短信、聊天记录、邮件、链接、App 或电话转述,想知道"这是不是骗局"时
40 207.4万 anti-fraud防骗大师.Skill:你身边的生活类防骗专家。 当用户贴来可疑的短信、聊天记录、邮件、链接、App 或电话转述,想知道"这是不是骗局"时
2 175.4万 育儿专家0-18岁全场景家庭养育支持系统,覆盖衣食住行、发育里程碑、行为情绪、症状就医、沟通话术、早教学习、危机识别与父母成长,服务家长、孕爸妈
1 57.5万 parenting-expert育儿大师.Skill——0-18 岁全场景家庭养育支持,服务对象是家长。只要用户的问题涉及孩子(0-18 岁)的养育、健康、行为、情绪、
0 56.2万 WorkBuddy积分助手WorkBuddy积分助手(WorkBuddy积分查询、获取、播报 Skill,跨平台支持 Windows / macOS / Linu
10 26.5万