# Data

<https://snowyet.com/data/>

Every place page is built from one small JSON file per place, made each day from NOAA's grid and USDA's stations. The same numbers are published for anyone to read.

## The files

| Address | What it holds |
|---|---|
| [`/data/<id>.json`](https://snowyet.com/data/big-bear-ca.json) | One place: the answer, every point's depth, band, trend, last snowfall and past eight days, and nearby station readings. |
| [`/data/day.json`](https://snowyet.com/data/day.json) | The day: the grid day, when the files were made, and which places changed answer. |

## Fields in a place file

| Field | Meaning |
|---|---|
| `grid_day` | The day of the grid file, which describes 06:00 UTC that day. |
| `as_of_utc, as_of_local` | The time the snow values describe, in UTC and in the place's time zone. |
| `answer.band` | none, dusting or snow, for the town point. |
| `points[].depth_in, water_in` | Modelled snow depth and snow water equivalent in inches, one decimal; null when the grid gave no value. |
| `points[].trend` | bare, rising, holding or melting, compared with the day before; null when there is nothing to compare. |
| `points[].last_snow_day` | The latest grid day on record when depth rose by half an inch or more; null if none. The page says it as the 24 hours to that grid day's as-of time, in the place's zone. |
| `points[].week` | The eight days ending on the grid day, oldest first; a missing day has depth null. |
| `stations[]` | SNOTEL triplet, name, miles from the place, elevation, measured depth in inches, local time read, and whether the reading is old. |
| `changed` | True when the answer differs from the day before. |
| `page, markdown` | The address of the place's page and of its plain Markdown copy. |
| `answer.shown, points[].shown` | The word the page shows: snow, dusting, none, or unknown when the grid gave no value (band then stays none). |
| `sentence` | The page's first sentence, one entry per language, keyed by language code. |
| `stations[].provisional` | Always true: SNOTEL readings are provisional and may be revised. |
| `credit` | The credit line for the sources, one entry per language. |
| `sources` | Each source's name and the address of its own page. |
| `points[].label, points[].labels` | The point's name: label in English, labels with one entry per language, keyed by language code. |

## Credit

If you use these numbers, credit NOAA NOHRSC SNODAS (served by NSIDC) for modelled depth and USDA NRCS SNOTEL for station readings. The full citation is on the sources page.
