GET/v1/weather/frames

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

What it does

The NOAA GFS forecast frames MapMap processes for the map: kept runs (newest first), each frame's valid time and file paths, how each field's PNG bytes decode (encodings), a base URL the paths resolve against and a tiles template for the pressure-line and rain/temperature tile ids. A forecast, not an observation; derived from NOAA GFS and modified by MapMap; no endorsement by or affiliation with NOAA is implied. Freshness is a field (ok, stale, unknown), never an error. When the key is sent as ?api_key=, the same key is stamped onto base and tiles. One Standard unit per request; a browser (maps) key may call it.

Call it

bash

curl -fsS -X GET "https://api.mapmap.ai/v1/weather/frames" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

Name	In	Required	Description
run	query	no	One kept run, `YYYYMMDDHH`. `404 run-not-found` if it is not kept; `400 invalid-run` if malformed
latest	query	no	`1`: only the newest run. Default: every kept run

Responses

200The frame manifest

Field	Type	Required	Description
age_s	integer	no	Seconds since `generated_at`. `null` with no manifest.
attribution	object	yes	The credit, verbatim from the manifest.
base	string	yes	Frame paths below resolve against this URL.
encodings	object	yes	How each field's PNG bytes decode, verbatim from the manifest.
generated_at	string	no	The manifest's own generation time (RFC 3339). `null` with no manifest.
label	string	yes	Forecast, not an observation.
model	WeatherModel	yes	The model.
note	string	yes	The modification and no-endorsement note.
processed_by	string	yes	Always `MapMap`.
runs	WeatherRun[]	yes	Kept runs, newest first.
status	string	yes	`ok`, `stale` or `unknown`.
threshold_s	integer	yes	The age after which the manifest reads `stale`, seconds.
tiles	string	yes	Tile URL template for the `gateway` ids on each frame (`rain`, `temp`: `png`; `isobars`: `mvt`).

400invalid-run or invalid-latest. Not billed

404run-not-found. Not billed

501Weather frames not enabled (SN_WEATHER_DIR unset). Not billed

Error bodies follow the shared problem model documented on API conventions.

Also under live

GET /v1/events GET /v1/space-weather GET /v1/space-weather/aurora.png GET /v1/weather/frames/gfs/{run}/{field}/{file}

Generated from https://api.mapmap.ai/openapi.json on 2026-10-17 · operationId get_weather_frames