Roadgoose open gas prices
=========================

Gas prices that Roadgoose drivers report from the pump sign, published as open data.

Files (refreshed every hour, on the hour; Cache-Control 1 hour; CORS open):
  https://129-146-202-245.sslip.io/gas/open/v1/US-ID.json    one file per US state and DC (US-XX), an
                                                              empty "stations" list when none is published
  https://129-146-202-245.sslip.io/gas/open/v1/prices.csv    every state in one CSV
  https://129-146-202-245.sslip.io/gas/open/README           this file

JSON: {"v": 1, "license": "CC BY-NC 4.0", "attribution": "...", "region": "US-ID", "generated": "<hour>",
       "stations": [{"station": "osm:node/123", "osm": "node/123", "name": "", "lat": 43.6178, "lon": -116.1997,
                     "prices": {"regular": {"price": 3.459, "reported_hour": "2026-10-12T17:00:00Z",
                                            "last_seen_hour": "2026-10-12T19:00:00Z", "confirmations": 2,
                                            "freshness": "fresh"}}}]}
CSV columns: region, station, osm, name, lat, lon, grade, price, reported_hour, last_seen_hour, confirmations,
             freshness

  station          the station's key: "osm:<type>/<id>" (OpenStreetMap) or "ll:<lat>,<lon>" (its position)
  osm / name       the OpenStreetMap id when known, else the name a driver gave (filtered like chat text)
  lat, lon         the STATION's position (4 decimals), never a driver's
  price            USD per gallon including taxes, as on the sign (3 decimals)
  reported_hour    the hour (UTC, rounded down) the price was first reported
  last_seen_hour   the hour (UTC, rounded down) a driver last reported or confirmed it
  confirmations    how many other drivers said the same price
  freshness        "fresh" (seen in the last 24 hours) or "may_be_outdated"; prices drop out 48 hours after
                   they were last seen
A station near a state line can appear in both states' files.

What is NOT in it, ever: anything about the drivers - no names, pseudonyms, accounts, report ids, exact times,
expiry, device or location data. A price with a single report and no confirmation is held back until it is at
least one hour old, so a published price cannot time one driver's stop.

License: Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0),
https://creativecommons.org/licenses/by-nc/4.0/
Attribution (required, wherever the prices are shown):  Gas prices: Roadgoose drivers, CC BY-NC 4.0
Commercial use (a company, a paid product, ads) needs our written permission: lucasmullikin@gmail.com

Not part of this feed: the EIA weekly regional averages the app also shows (/gas/eia/averages.json). They are
U.S. Energy Information Administration data, public domain, with their own attribution
("Gas averages: U.S. Energy Information Administration"), and are not covered by this license.

Driver reports are what drivers saw; Roadgoose does not check them against the pump. No warranty.