Official first
Life-safety and operational claims link to the responsible authority. Derived recommendations never replace official instructions.
Data policy
Source, timestamp, confidence.
Every live record is cached outside the request path and carries enough metadata to answer where it came from and how old it is.
| Stream | Provider | Target cadence | Role |
|---|---|---|---|
| Current/model weather | Open-Meteo | 5 min | Authoritative current, UV, and seven-day numeric model supplement |
| Air quality | Open-Meteo / CAMS Global | 1 h | Authoritative 45 km model context |
| Public forecast | NOAA / NWS San Juan | 1 h | Official point forecast |
| Hourly forecast | NOAA / NWS San Juan | 1 h | Official hourly grid forecast |
| Weather alerts | NOAA / NWS San Juan | 3 min | Official |
| Marine alerts | NOAA / NWS San Juan | 3 min | Official AMZ726 alerts |
| Sea observation | NOAA NDBC / CariCOOS 41052 | 10 min | Official real-time observation |
| Coastal forecast | NOAA / NWS San Juan | 1 h | Official AMZ726 CWF product |
| Tropical cyclones | NOAA / NHC | 15 min | Official status summary |
| Tropical outlook | NOAA / NHC | 30 min | Official formation areas |
| Earthquakes | USGS | 5 min | Official |
| Tides | NOAA Tides & Currents | 6 h | Official prediction |
| STT observation | NOAA Aviation Weather | 15 min | Official METAR |
| Power outages | Virgin Islands WAPA | 5 min | First-party map; undocumented schema |
| Beach bulletin | Virgin Islands DPNR | 6 h | Official dated advisory index |
| Beach samples | EPA Water Quality Portal | 24 h | Official historical results |
| Sargassum update | Virgin Islands DPNR | 6 h | Official territory bulletin |
| Park operations | National Park Service | 15 min | Official; optional API key |
| Ferry schedules | Operators / VIPA | Monthly review | Curated first-party schedules |
Stale is not clear
An expired or failed feed is labeled unavailable or stale. It is never converted into “no alerts” or normal operations.
Cache before serving
A worker polls upstream sources. User requests read PostgreSQL or a safe fallback and do not inherit third-party latency.
Corrections and commercial data
Directory facts need a source URL and verification date. Sponsored placement, affiliate links, or paid inclusion must be disclosed and must not change safety or editorial rankings. Corrections should preserve the previous record in an audit trail when the directory workflow is added.
Time and units
Local times use Atlantic Standard Time (America/Puerto_Rico, UTC−4) year-round. Visitor-facing temperatures use Fahrenheit, distances use miles, wind uses mph, rain uses inches, and tides use feet.