用途:聚合 FEMA OpenShelters 与美国红十字会开放避难所两个美国数据源(去重),为代理和用户提供开放避难所信息。两源各有缺口:FEMA 下游同步、最多滞后一天,故仅取其一都不完整。覆盖范围仅限美国及其领土。
主要能力:shelters 列出开放避难所,可按州、宠物、ADA、轮椅、管理组织、状态、县/教区、现场发电机过滤,每条带 source 字段(fema、redcross 或 fema+redcross);shelter 按稳定的 shelter_id 查询单个避难所详情;near 按经纬度、ZIP 或地址返回最近开放避难所并做地理编码;capacity 仅在人口与容量同时存在时计算使用率并标注分母;brief 一次输出开放数量、按州与按事件分布、宠物友好与无障碍数量及容量概况;另有 gis-links 和 credits。
使用方式:需先安装 CLI。npx -y @mvanhorn/printing-press-library install shelters --cli-only,验证 shelters-pp-cli --version;若失败可用 go install github.com/mvanhorn/printing-press-library/library/other/shelters/cmd/shelters-pp-cli@latest(需 Go 1.26.6+)。命令无需 API 密钥,均为只读。可加 --agent(等价 --json --compact --no-input --no-color --yes)、--select 精简字段、--dry-run 预览。输出为 {source, fetched_at, data} 封装。
限制:仅支持美国及其领土;坐标常为空,near 会尝试地理编码,无法定位者计入报告而非丢弃;容量缺失分母时不计算;被红十字会从公开地图隐藏的避难所会被剔除;本工具为非官方工具,紧急情况请拨打 911 并遵循官方指引。