Recreation.gov Availability Checker 综合评估
核心用法
本工具是专为美国联邦露营地设计的可用性查询脚本，直接对接 recreation.gov 官方数据。用户通过 campground ID 查询指定日期范围内的营地空位状态，支持多营地批量查询和精细筛选。
基础查询模式：
- 必需参数：营地ID（
-c）、起始日期（-s）、住宿夜数（-n） - 数据来源：国家公园管理局（NPS）、林务局（USFS）、土地管理局（BLM）、陆军工程兵团
- 输出格式：默认为可读文本，支持
--json机器解析
高级筛选能力：
| 维度 | 选项 |
|------|------|
| 营地类型 | tent, rv, standard, cabin, group |
| 电力供应 | `--electric` / `--nonelectric` |
| 宠物友好 | `--pets`（需额外API调用） |
| 环境特征 | `--shade`（有遮阴）、`--fire-pit`（有火坑） |
| 车辆限制 | `--vehicle-length N`（最小车长英尺） |
显著优点
1. 官方数据源直连：直接读取 recreation.gov 实时库存，非第三方爬取，数据准确性高
2. 零配置门槛：Python 3.8+ 标准库即可运行，无需 API 密钥或账户注册
3. 批量查询效率：支持多营地ID同时查询，适合路线规划时沿线的营地比价
4. 状态语义清晰：区分 Available/Reserved/NYR（未开放预订）/FCFS（先到先得）四种状态
5. 生态衔接：与 ridb-search 技能联动，形成"搜索→查询→决策"闭环
潜在局限与风险
性能约束：
- 设施筛选（宠物、遮阴、火坑、车长）会触发额外 API 调用，查询速度显著下降
- 官方预订窗口通常为提前6个月，超期日期返回 NYR 状态
功能边界：
- 不支持预订操作，仅提供可用性查询（需跳转 recreation.gov 完成支付）
- 州属公园（State Parks）不在覆盖范围，需使用
reserveamerica或其他工具 - 先到先得（FCFS）营地仅标记状态，无法预判实际到场空位
数据时效：
- 依赖 recreation.gov 官方 API 稳定性，高峰期可能出现延迟
- 缓存策略未明确说明，极端情况下可能存在分钟级数据延迟
适合人群
- 自驾露营规划者：提前6个月锁定国家公园热门营地（如优胜美地、大烟山）
- 多目的地路线规划：批量比对沿途 USFS/BLM 营地可用性
- 装备特定需求者：RV用户筛选电力/车长限制，家庭用户筛选宠物友好
- 自动化工作流开发者：JSON输出支持与其他行程规划工具集成
常规风险提示
- 查询结果仅为可用性快照，非预订确认，热门营地建议立即跳转官网锁定
- 设施标签（遮阴、火坑）依赖营地管理方录入完整性，存在标注缺失可能
- 时区处理需注意：营地本地时间 vs 用户查询时间的潜在差异
- 频繁高频查询可能触发 recreation.gov 速率限制