核心用法
Open Data Hub CLI (`odh`) 是由开源开发者 galjos 维护的命令行工具，用于高效访问 NOI Techpark Open Data Hub 的开放数据集。该 Hub 是意大利南蒂罗尔自治省（South Tyrol / Autonomous Province of Bolzano）的核心数据基础设施，涵盖旅游、交通、停车、电动汽车充电、A22 高速公路及公共交通等多领域实时与静态数据。
主要功能模块
1. Discovery（数据发现）：odh apis、odh datasets search、odh mobility types/origins/datatypes 等命令帮助用户探索可用 API 端点、数据集及数据类型，避免盲目构造请求。
2. Traffic（交通事件）：查询道路施工、封路、事件，支持按区域 (--area)、坐标半径 (--near)、类别 (--type) 过滤。odh a22 status 提供 A22 布伦纳高速公路实时路况。
3. Mobility Measurements（移动性测量）：实时查询停车场空位 (ParkingStation)、充电桩状态 (EVChargingStation)、交通传感器数据。支持新鲜度过滤 (--fresh-within) 和来源追溯 (--origin)。
4. Transit（公共交通）：基于 STA（Südtiroler Transportstrukturen）GTFS 数据，提供站点搜索 (stops search)、时刻表查询 (departures, trip)、多模式路径规划 (journey)。--with-realtime 可叠加 GTFS-RT 实时信息，但需注意工具仅做标注而非动态重路由。
5. Tourism（旅游数据）：POI 查询、活动事件 (tourism-events)，含多语言详情与地理坐标。
显著优点
- 结构化优于爬取：官方封装 REST API，返回稳定 JSON/Table 格式，避免页面解析的脆弱性
- 地域专业深度：对南蒂罗尔/A22 公路的数据粒度、来源标注（
source,source_detail,endpoint）清晰，适合本地化应用 - 实时与历史兼顾：支持最新测量值 (
latest)、新鲜度过滤、预测数据 (forecast-minutes) - GTFS 生态完整：集成静态时刻表与 GTFS-RT 实时更新，满足公交规划需求
- CLI 设计成熟：全局超时 (
--timeout)、参数转义安全 (--param支持逗号)、诊断命令 (doctor)、版本兼容性检查
潜在缺点与局限性
- 地理范围受限：核心数据集中在南蒂罗尔/博尔扎诺自治省，其他地区覆盖稀疏
- 实时性非绝对：
--with-realtime仅附加实时标注，不保证服务正点；缺失实时实体不代表准点 - 历史数据保留不明：A22 实时事件可能不保留历史，需依赖外部档案
- 安装依赖 Go 工具链：虽有 install 脚本，但非系统包管理器原生支持
- 数据源异构：不同
origin的数据质量、更新频率差异大，需人工验证warnings和date_status
适合人群
- 南蒂罗尔地区的开发者、数据分析师、智能城市研究者
- 需要集成 A22 公路、本地停车/充电、STA 公交的出行应用开发者
- 替代网页爬取、需要结构化开放数据的自动化工作流
常规风险
- 数据新鲜度误判：
latest返回可能包含陈旧记录，必须结合--fresh-within和warnings字段校验 - 坐标与地名混淆：
--near半径搜索需确认坐标系一致性；stop-id比站点名称更可靠 - 实时信息过度解读：GTFS-RT 延迟或缺失不应推断为"准点"，需明确标注不确定性
- API 变更风险：虽 CLI 封装了版本兼容性，但底层 Open Data Hub API 合约变更可能影响字段可用性