名称： ridb-search
描述： 在 Recreation Information Database (RIDB) 中搜索指定位置附近的露营地与休闲设施。适用于根据位置/半径查找露营地、休闲区或联邦设施。支持地理编码（城市名）和经纬度坐标。

RIDB 搜索

在 recreation.gov 数据库中搜索指定位置附近的露营地与设施。

环境配置

需要一个免费的 RIDB API 密钥：
1. 访问 https://ridb.recreation.gov/profile
2. 注册并生成 API 密钥
3. 设置环境变量：export RIDB_API_KEY=your_key_here

使用方法

按位置名称搜索（自动地理编码）：

python scripts/search.py --location "Bend, OR" --radius 50
python scripts/search.py -l "Yosemite Valley" -r 25 --camping-only

按坐标搜索：

python scripts/search.py --lat 44.0582 --lon -121.3153 --radius 50

参数选项

输出示例

人类可读格式（默认）：

📍 已将 'Bend, OR' 地理编码为 44.0582, -121.3153

在 50 英里范围内找到 23 个设施
------------------------------------------------------------

🏕️  Tumalo State Park
   ID: 234567 | ✅ 可预订
   管理机构：Oregon State Parks
   链接：https://www.recreation.gov/camping/campgrounds/234567

JSON 格式输出（使用 --json 参数）：

{
  "query": {"latitude": 44.0582, "longitude": -121.3153, "radius_miles": 50},
  "total_count": 23,
  "facilities": [
    {
      "id": "234567",
      "name": "Tumalo State Park",
      "reservable": true,
      "url": "https://www.recreation.gov/camping/campgrounds/234567"
    }
  ]
}

注意事项

• RIDB 主要包含联邦休闲设施数据，部分州立或私营露营地可能未收录
• id 字段为 recreation.gov 上用于查询营地可用性的唯一标识符
• 搜索半径单位为英里（RIDB 原生单位）
• 地理编码服务基于 OpenStreetMap/Nominatim（免费，无需密钥）