林茨公共交通

使用该技能与 Linz Linien EFA 接口进行交互：

• GET /efa/XML_STOPFINDER_REQUEST
• GET /efa/XML_DM_REQUEST

在实现前，请先阅读 {baseDir}/references/endpoints.md 中的接口详细说明。 默认执行路径为 {baseDir}/scripts/linz_transport.py。

工作流程

1. 解析 API 基础 URL。
2. 运行与任务匹配的脚本子命令。
3. 返回简洁、面向用户的摘要结果。

主要工具

• 脚本路径：{baseDir}/scripts/linz_transport.py
• 运行时环境：Python 3，仅使用标准库。
• 基础 URL 输入方式：
  • 通过 --base-url 参数指定，或
  • 通过环境变量 LINZ_TRANSPORT_API_BASE_URL 指定，或
  • 默认使用 http://www.linzag.at/linz2。

推荐使用的命令：

• 搜索站点：
  • python {baseDir}/scripts/linz_transport.py stops "taubenmarkt"
• 按站点 ID 获取发车信息：
  • python {baseDir}/scripts/linz_transport.py departures --stop-id 60501160 --limit 10
• 一次性完成站点解析与发车信息获取：
  • python {baseDir}/scripts/linz_transport.py next "taubenmarkt" --limit 10 --pick-first

步骤 1：解析基础 URL

• 优先采用用户提供的基础 URL。
• 若未提供，则使用环境变量 LINZ_TRANSPORT_API_BASE_URL（如已设置）。
• 若以上两者均不可用，则回退至默认值 http://www.linzag.at/linz2。

步骤 2：输出格式规范

• 如需排序，按 countdownInMinutes 升序排列。
• 默认展示接下来的 5–10 班次，除非用户明确要求更多。
• 同时显示相对时间（countdownInMinutes）和绝对时间（time）。
• 返回 JSON 时保持字段名称稳定不变。

错误处理

• 若站点搜索返回空列表，建议相近拼写并尝试使用更短的查询词重试。
• 若返回多个匹配站点，应显式指定 --stop-id 重新执行；仅在可接受歧义时使用 next ... --pick-first。
• 若发车信息响应为空，应明确告知“当前暂无即将发车的班次”。
• 若 HTTP 请求失败，需报告状态码、请求端点及重试建议。
• 若 EFA 响应中包含 message 错误码，应在诊断信息中一并返回该代码。

最小化示例

python {baseDir}/scripts/linz_transport.py stops "taubenmarkt"
python {baseDir}/scripts/linz_transport.py departures --stop-id 60501160 --limit 10
python {baseDir}/scripts/linz_transport.py next "taubenmarkt" --limit 10 --pick-first

python "{baseDir}/scripts/linz_transport.py" stops "taubenmarkt"
python "{baseDir}/scripts/linz_transport.py" departures --stop-id 60501160 --limit 10
python "{baseDir}/scripts/linz_transport.py" next "taubenmarkt" --limit 10 --pick-first