{
  "service": "flashq",
  "description": "Lightning near a latitude and longitude, from the Geostationary Lightning Mapper on NOAA's two GOES satellites: every flash, cloud and ground together, over the Americas and the oceans beside them.",
  "usage": [
    "GET /27.95,-82.46                  -- lightning near a point: the nearest flash, counts within 10, 20 and 40 km, the trend and the all-clear",
    "GET /?lat=27.95&lon=-82.46",
    "GET /27.95,-82.46?minutes=30&within=100 -- a window of 1 to 120 minutes (default 60) and a radius of 10 to 100 km (default 40)",
    "GET /flashes?bbox=-84,26,-80,30    -- every flash in a box at most 5° on a side, as GeoJSON, oldest first; minutes= as above",
    "GET /flashes?minutes=10               -- with no box, every flash both satellites saw, 1 to 15 minutes (default 10)",
    "GET /map                           -- the same, on one map, for a browser",
    "GET /sources                       -- how each satellite's feed is doing: when the cron last ran and passed, its newest file"
  ],
  "answer": {
    "nearest": "The closest flash within the radius and window, or null. distanceKm and bearingInDegrees from the point.",
    "rings": "Flashes within 10, 20 and 40 km, then the radius itself, each with its newest flash's time.",
    "trend": "The nearest flash in the last 10 minutes against the 10 before: approaching, steady (within 5 km) or receding. Null when either has none.",
    "allClear": "flashq's rule, 30 minutes with no flash within 10 km, after the US National Weather Service's advice for thunder. until is when it's clear, in the past once it is. It looks back 2 hours whatever minutes= says.",
    "coverage": "What GLM sees: flashes, cloud and ground together, about 3 in 4 of them. pixelKm is how far apart its pixels are at the point, newestAt the end of the newest file read, missingSeconds any of the window whose file isn't in the store.",
    "available": "false, with a reason, where neither satellite sees the point: no flashes there is never an answer of no lightning.",
    "errors": "502 when a satellite's feed is over 5 minutes late. A late feed says nothing about the place; show the last answer and its age."
  },
  "sources": [
    "NOAA GOES-R Series Geostationary Lightning Mapper: GOES-19 (GOES-East, 75.2°W) and GOES-18 (GOES-West, 137°W), a file every 20 seconds from NOAA's bucket on AWS, read every minute. Each keeps the flashes on its own side of 106.1°W."
  ],
  "auth": "None. CORS is open, so a browser can call this directly.",
  "terms": "Free, unsupported, not for volume, and as is. Send a User-Agent that names your app. https://almanac.observer/#use"
}