路线规划助手

解决出行路线规划的碎片化查询

在开发出行类应用或编写自动化脚本时，获取从起点到终点的准确路线信息往往需要对接复杂的地图 SDK 或处理繁琐的 API 鉴权与解析逻辑。开发者经常需要在不同的出行方式（如驾车、公交、步行、骑行）之间切换，并提取距离、耗时以及具体的分步导航指引。planning-skill 旨在屏蔽底层地图 API 的复杂性，提供一个轻量级的路线规划解决方案，让开发者能够通过简单的命令行参数快速获取结构化的路线数据。

核心能力与工作原理

该技能基于腾讯地图 WebService API 实现，底层仅依赖 Python 标准库（urllib），无需安装任何第三方依赖。其核心工作流程通过执行 scripts/route_plan.py 脚本完成，主要包含以下几个关键步骤：

• 参数解析与请求构建：接收起点 --from 和终点 --to 的地址或坐标，结合腾讯地图 API Key --key 构建 HTTP 请求。
• 多模式路线计算：通过 --modes 参数指定出行方式（all、driving、transit、walking、bicycling），默认查询全部方案。
• 结果解析与格式化：将 API 返回的原始 JSON 数据解析，并按耗时从短到长排序。支持 --format 参数切换输出格式，text 模式输出包含前 8 步路线指引的可读文本，json 模式则输出包含 routes[] 数组的结构化数据，方便程序二次处理。

适用边界与注意事项

在实际接入时，需要注意该技能对 API 接口特性的依赖：

• 公交查询的城市限制：使用公交（transit）模式时，必须通过 --city 参数指定所在城市（默认为“北京”），否则 API 会返回错误。
• 短距离出行的场景约束：步行和骑行模式在长距离（通常大于 10 公里）时，API 可能无法返回有效结果，更适合社区周边或短途通勤场景。
• API 额度管理：依赖腾讯地图免费 API Key（每日 10000 次调用），在批量生成路线或高频轮询场景下需自行做好限流与缓存。