# 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:

- [Anguilla](https://seaweedradar.com/dispatch/v1/anguilla.json), Anguilla
- [Antigua](https://seaweedradar.com/dispatch/v1/antigua.json), Antigua and Barbuda
- [Aruba](https://seaweedradar.com/dispatch/v1/aruba.json), Aruba
- [Barbados](https://seaweedradar.com/dispatch/v1/barbados.json), Barbados
- [Belize](https://seaweedradar.com/dispatch/v1/belize.json), Belize
- [British Virgin Islands](https://seaweedradar.com/dispatch/v1/british-virgin-islands.json), British Virgin Islands
- [Cancún](https://seaweedradar.com/dispatch/v1/cancun.json), Mexico
- [Cayo Coco](https://seaweedradar.com/dispatch/v1/cayo-coco.json), Cuba
- [Costa Maya](https://seaweedradar.com/dispatch/v1/costa-maya.json), Mexico
- [Cozumel](https://seaweedradar.com/dispatch/v1/cozumel.json), Mexico
- [Culebra](https://seaweedradar.com/dispatch/v1/culebra.json), Puerto Rico
- [Curaçao](https://seaweedradar.com/dispatch/v1/curacao.json), Curaçao
- [Exuma](https://seaweedradar.com/dispatch/v1/exuma.json), The Bahamas
- [Florida's Gulf Coast](https://seaweedradar.com/dispatch/v1/florida-gulf-coast.json), United States
- [Florida's Space Coast](https://seaweedradar.com/dispatch/v1/florida-space-coast.json), United States
- [Florida](https://seaweedradar.com/dispatch/v1/florida.json), United States
- [Grand Cayman](https://seaweedradar.com/dispatch/v1/grand-cayman.json), Cayman Islands
- [Grenada](https://seaweedradar.com/dispatch/v1/grenada.json), Grenada
- [Guadeloupe](https://seaweedradar.com/dispatch/v1/guadeloupe.json), Guadeloupe (France)
- [Guardalavaca](https://seaweedradar.com/dispatch/v1/guardalavaca.json), Cuba
- [Holbox](https://seaweedradar.com/dispatch/v1/holbox.json), Mexico
- [Jamaica's south coast](https://seaweedradar.com/dispatch/v1/jamaica-south-coast.json), Jamaica
- [Martinique](https://seaweedradar.com/dispatch/v1/martinique.json), Martinique (France)
- [Montego Bay](https://seaweedradar.com/dispatch/v1/montego-bay.json), Jamaica
- [Nassau and Paradise Island](https://seaweedradar.com/dispatch/v1/nassau.json), The Bahamas
- [Negril](https://seaweedradar.com/dispatch/v1/negril.json), Jamaica
- [Ocho Rios](https://seaweedradar.com/dispatch/v1/ocho-rios.json), Jamaica
- [Port Antonio](https://seaweedradar.com/dispatch/v1/port-antonio.json), Jamaica
- [Puerto Plata](https://seaweedradar.com/dispatch/v1/puerto-plata.json), Dominican Republic
- [Puerto Rico's east coast](https://seaweedradar.com/dispatch/v1/puerto-rico-east.json), Puerto Rico
- [Puerto Rico's north coast](https://seaweedradar.com/dispatch/v1/puerto-rico-north.json), Puerto Rico
- [Puerto Rico's south coast](https://seaweedradar.com/dispatch/v1/puerto-rico-south.json), Puerto Rico
- [Puerto Rico's west coast](https://seaweedradar.com/dispatch/v1/puerto-rico-west.json), Puerto Rico
- [Punta Cana](https://seaweedradar.com/dispatch/v1/punta-cana.json), Dominican Republic
- [Riviera Maya](https://seaweedradar.com/dispatch/v1/riviera-maya.json), Mexico
- [Roatán](https://seaweedradar.com/dispatch/v1/roatan.json), Honduras
- [Samaná](https://seaweedradar.com/dispatch/v1/samana.json), Dominican Republic
- [San Juan](https://seaweedradar.com/dispatch/v1/san-juan.json), Puerto Rico
- [St. Croix](https://seaweedradar.com/dispatch/v1/st-croix.json), U.S. Virgin Islands
- [St. John](https://seaweedradar.com/dispatch/v1/st-john.json), U.S. Virgin Islands
- [St Lucia](https://seaweedradar.com/dispatch/v1/st-lucia.json), Saint Lucia
- [St. Martin / Sint Maarten](https://seaweedradar.com/dispatch/v1/st-martin.json), Saint Martin / Sint Maarten
- [St. Thomas](https://seaweedradar.com/dispatch/v1/st-thomas.json), U.S. Virgin Islands
- [Texas Gulf Coast](https://seaweedradar.com/dispatch/v1/texas.json), United States
- [Tobago](https://seaweedradar.com/dispatch/v1/tobago.json), Trinidad and Tobago
- [Turks and Caicos](https://seaweedradar.com/dispatch/v1/turks-and-caicos.json), Turks and Caicos Islands
- [Varadero](https://seaweedradar.com/dispatch/v1/varadero.json), Cuba
- [Vieques](https://seaweedradar.com/dispatch/v1/vieques.json), Puerto Rico

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).
