OA0 = Omni AI 0
OA0 是一个探索 AI 的论坛
现在注册
已注册用户请  登录
OA0  ›  技能包  ›  bvg-route:柏林公共交通 (BVG) 路径规划

bvg-route:柏林公共交通 (BVG) 路径规划

 
  root ·  2026-02-04 22:12:52 · 3 次点击  · 0 条评论  

名称: bvg-route
描述: "使用 v6.bvg.transport.rest API 进行柏林公共交通 (BVG) 路线规划。当用户询问以下内容时使用:(1) 两个地址或站点之间的路线建议,(2) 站点的实时下一班次信息,(3) 基于到达时间的行程规划(指定到达时间或出发时间)。支持输出 2–3 个按行程时间、换乘次数和步行距离排序的选项,并提供分步指引及用于实时更新的刷新令牌。"


BVG 路线规划技能

目的
- 使用 v6.bvg.transport.rest API,为柏林公共交通提供简洁、可操作的出行指引。

使用时机
- 用户询问柏林两个地点(地址、站点名称或坐标)之间的路线。
- 用户询问某个站点/车站的下一班次发车时间。
- 用户要求按特定时间到达(到达时间)或在特定时间出发(出发时间)。

核心行为
1. 使用 GET /locations 或 /locations/nearby,将 fromto 解析为站点 ID(首选)或地址/兴趣点对象。
2. 根据请求,调用 GET /journeys 并附带到达或出发时间参数,设置 results=3stopovers=true 以构建分段的详细行程。
3. 格式化 2–3 个选项:显示总行程时间、换乘次数、步行时间以及预计出发/到达时间。
4. 为选定的行程提供分步指引:步行至站点 A(距离/时间),乘坐 X 号线前往 Y 方向,在站点 B 下车(如有站台信息则提供),最后步行至目的地。
5. 在适当时,包含行程的 refreshToken 以及一个 GET /journeys/:ref 刷新步骤,以更新实时延误信息。
6. 对于简单的下一班次查询,使用 GET /stops/:id/departures 并设置 duration=20(或可配置值),返回最近的 3 个班次。

输出内容
- 人类可读的路线信息,包括出发时间、换乘次数、步行距离、预计到达时间以及简洁的步骤列表。
- 机器友好的 JSON 格式(可选),包含行程 ID、刷新令牌、行程段和站点 ID,便于程序化刷新。

参考资源
- 本技能预期使用 v6.bvg.transport.rest API (https://v6.bvg.transport.rest/api.html)。详细摘要和示例请参阅 references/API.md。

示例(触发词)
- "从 Invalidenstraße 43 10115 到 Leibnizstraße 62 怎么坐公共交通?"
- "U Rosenthaler Platz 站的下一班地铁什么时候来?"
- "找一下今晚 17:50 之前能到达 Deutsche Oper 的行程,优先最快的选项。"

开发者注意事项
- IBNR 格式(关键): /journeys 接口要求使用基础 IBNR 编码(6位数字),而非带有 :: 后缀的完整 ID。
- ❌ 错误示例:de:11000:900110001::3de:11000:900110001
- ✅ 正确示例:900110001(从 /stops 结果中提取基础的 6 位数字编码)
- 处理流程:先调用 /stops?query=...,从结果中提取 6 位 id,然后将其用于 /journeys
- URL 编码(关键): 所有查询字符串参数必须使用 urllib.parse.quote() 或等效方法进行正确的 URL 编码。例如:
- 空格 → %20
- ö%C3%B6
- ü%C3%BC
- Ä%C3%84
- 特殊字符如 &?# → 其对应的百分号编码
- 示例:Schönhauser AlleeSch%C3%B6nhauser%20Allee
- 任何在查询参数中包含地址/站点名称字符串的 API 调用,都必须在构建 URL 前进行编码。
- 调用 /journeys 时优先使用站点/车站 ID(比模糊名称更可靠):使用 /stops?query=... 解析名称 → 获取基础 IBNR。
- 使用 stopovers=true 来构建可读的步骤列表;当步行至入口的准确性很重要时,包含 entrances=true
- 请求 results=3,然后向用户提供前 2–3 个最佳选项。
- 处理带时区信息的 ISO 日期时间;如果未提供,则默认使用欧洲/柏林时区。

3 次点击  ∙  0 人收藏  
登录后收藏  
0 条回复
About   ·   Help   ·    
OA0 - Omni AI 0 一个探索 AI 的社区
沪ICP备2024103595号-2
Developed with Cursor