Satellite data from · the site updates once a day

The data files

Every level on this site is also in a JSON file, one per destination, for anyone who wants to read the numbers with a program. The files are written from the same readings as the pages, each time the site is rebuilt after NOAA posts its daily map.

Where they are

Each file is at https://seaweedradar.com/dispatch/v1/<destination>.json, where the last part is the destination’s slug from its page address. The files now:

Any site or program may fetch them. They are sent with an open cross-origin header and may be cached for up to 15 minutes. Please fetch a file no more than once an hour: it changes about once a day.

What a file holds

shape
The version of this layout: 1 for every file in this folder.
destination
The destination’s slug, the same as in its page address.
name
The destination’s name, in English.
source
Where the levels come from, in words.
strands
The destination’s beaches, one object each, in the order its page lists them.

Each beach in a file

id
The beach’s slug, the same as in its page address.
name
The beach’s name.
lat
Latitude of the point used for the beach, in degrees north.
lon
Longitude of that point, in degrees east (negative is west).
faces
Which way the beach faces: north, northeast, east, southeast, south, southwest, west or northwest.
exposure
open if the beach faces the open sea, sheltered if it is turned away from it.
day
The date of NOAA’s newest map with a level for this beach (YYYY-MM-DD), or null if there is none yet. It is the data’s own date, usually one to two days before the file was written.
risk
NOAA’s level on that day as a number: 0 low, 1 warning, 2 medium, 3 high; null if none.
level
The same level as a word: low, warning, medium or high; null if none.
trend
rising, falling or steady: the average level of the last 7 days against the 7 before, with half a level as the line. unknown when either week has fewer than 4 days of data.
run_km
The length in km of the run of coast that NOAA scored as one on that day and that this beach sits in; null if not known.
fortnight
The 14 days up to day, oldest first, as [date, risk] pairs. The risk is null on a day NOAA published no map.

Changes to the layout

The v1 in the address is the version of this layout. A change that would break a program reading these files goes into a new folder beside it; the v1 files keep their fields and what they mean.

Licence and credit

The levels come from NOAA’s Sargassum Inundation Risk data, which NOAA releases under CC0, with no rights reserved. NOAA asks to be credited this way: Data courtesy of NOAA/AOML, NOAA CoastWatch, and USF.

You may use and republish these files with credit to Seaweed Radar (seaweedradar.com) and to NOAA. Do not present them as NOAA’s own or as an official source, and do not suggest that NOAA endorses your use. They describe a risk for long runs of coast, not the state of any beach.

Beach positions were checked against OpenStreetMap (© OpenStreetMap contributors).