核心用法
RIDB Search 是一款面向户外爱好者的命令行工具，用于查询美国 Recreation Information Database (RIDB) 中的联邦休闲设施。用户可通过城市名称（自动地理编码）或直接输入经纬度坐标，指定搜索半径（默认 50 英里）获取附近的露营地、国家公园等设施的详细信息。
主要功能特性：
- 双模式定位：支持自然语言地点（如 "Bend, OR"）自动转换为坐标，或直接输入 lat/lon
- 灵活筛选：可选仅显示可露营设施 (
--camping-only) 或仅可预订设施 (--reservable-only) - 多格式输出：默认人类可读格式（含 Emoji 图标）或 JSON 格式便于程序调用
- 官方数据直连：直接对接 recreation.gov 官方 API，设施 ID 可直接用于官网预订查询
显著优点：
1. 权威数据源：RIDB 为美国联邦土地管理机构的官方数据库，覆盖国家公园、国家森林、BLM 土地等数千个联邦设施
2. 零成本接入：API 密钥免费申请，地理编码服务（OpenStreetMap/Nominatim）无需额外密钥
3. 开发者友好：JSON 输出模式便于集成至自动化工作流或第三方应用
4. 离线脚本化：纯 Python CLI 工具，适合服务器定时任务或本地脚本集成
潜在局限与风险：
- 覆盖范围限制：仅包含联邦管辖设施，州立公园、私有露营地、郡立营地等可能缺失
- 数据时效性：依赖 recreation.gov 官方数据更新频率，可能存在设施关闭或信息滞后的情况
- 地理编码依赖：城市名称解析依赖第三方 Nominatim 服务，边缘地区或拼写变体可能导致定位偏差
- API 配额：虽免费但存在速率限制，高频调用需合理控制请求频率
适合人群：
- 计划美国境内自驾游、露营旅行的户外爱好者
- 需要批量获取联邦露营地数据的开发者或旅行工具开发者
- 希望快速筛选可预订设施、避免访问多个官网的效率型用户
- 集成至个人旅行规划自动化流程的技术用户
常规风险提示：
使用本工具获取的设施信息仍需通过 recreation.gov 官网二次确认实时可用性，API 返回的「可预订」状态不代表目标日期实际有空位。建议出行前直接访问官网或致电管理方核实。