Coverage
KaiCast forecasts named spots — dive and snorkel sites with a calibrated location on the water — grouped into regions with global ids ({country}-{admin1}-{area}, e.g. us-hi-oahu). Location is always a parameter, and coverage grows region by region; anywhere not listed is not covered yet, and every endpoint says so explicitly instead of guessing.
The live list is always at GET /api/v1/coverage (or the list_coverage MCP tool). The map and table below are rendered from it.
Regions today #
| Region | Id | Decisions | Notes |
|---|---|---|---|
| Oʻahu | us-hi-oahu | Full | Largest spot set; south, west and north shores |
| Maui | us-hi-maui | Full | Includes Molokini |
| Kauaʻi | us-hi-kauai | Full | |
| Hawaiʻi Island | us-hi-hawaii | Full | Kona and Kohala coasts |
| Molokaʻi | us-hi-molokai | Full | One spot |
Decision support levels #
| Level | Meaning |
|---|---|
| Full | Calibrated visibility model plus the composite condition score. recommend_spot / best_day rank here. |
| Conditions only | Wind, swell, tide and temperature are published, but there's no credible clarity model yet, so decision tools decline with status: "conditions_only" and point to the facts. Any newly published region starts here. |
| Not covered | No public data. Decision tools return status: "not_covered" with the nearest covered spot and its distance; get_conditions returns no_spot_nearby. |
Data quality, per answer #
Quality isn't uniform even inside a covered region, so every answer says what it's built on:
visibility_source—satellitewhen a recent satellite water-clarity reading feeds the estimate;heuristicwhen visibility is estimated from wind, swell, rain and tide alone (satellite ocean color is often clouded out). Decisions add avisibility_estimatedcaveat and lower confidence for heuristic estimates.freshness—live,recent,aging,staleornone, for the model's inputs. Stale inputs add astale_inputscaveat.confidence— per period (0–1), from the model.- Calibration — visibility predictions are corrected nightly against divers' logged observations (bias per spot and condition bucket). Spots with more logged dives are better calibrated.
Inputs #
NOAA NDBC buoys and CO-OPS tides, PacIOOS ROMS and WaveWatch III ocean models, Open-Meteo Marine, OpenWeather, NOAA CoastWatch satellite ocean color (Kd490, chlorophyll), USGS stream gauges and Hawaiʻi DOH advisories for runoff, CUDEM bathymetry for exposure. Each conditions response lists the sources that fed it.
Forecast horizon #
7 days, in 3-hour periods, refreshed hourly. No historical conditions are served.
Requesting a region #
Building for somewhere KaiCast doesn't cover yet? Tell us where and what you need at dawson@kaicast.com — demand from agent builders shapes where coverage goes next.