Data sources & attribution

Vigil only combines feeds that are published for public use. Every upstream is fetched server-side by our own API routes, normalised, cached and rate limited. The browser never calls a third-party data API and no API key ever reaches the client. (Basemap tiles and fonts are the one exception: the map engine loads them directly from the tile hosts listed below.)

Each feed's live health — last success, last error and record count — is shown in the status bar at the bottom of the map.

This file is rendered at /attributions. When you add a layer, add its section here with the same anchor as sourceDocAnchor in its meta.ts.


Live data layers

Earthquakes — USGS Earthquake Hazards Program

Endpoint https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_week.geojson
Docs https://earthquake.usgs.gov/earthquakes/feed/v1.0/geojson.php
License U.S. Government work — public domain
Upstream update rate Every minute
Our refresh 60 s server-side (shared cache); clients poll every 60 s
Attribution "Earthquake data: U.S. Geological Survey"
Notes Past 7 days, all magnitudes. The 1 h / 24 h / 7 d window and minimum-magnitude filters are applied client-side to the same cached feed.

ISS position — Where the ISS at?

Endpoint https://api.wheretheiss.at/v1/satellites/25544
Docs https://wheretheiss.at/w/developer
License Free public API, no key. No formal data licence published.
Upstream limit ~1 request per second
Our refresh 5 s server-side (one upstream call per 5 s regardless of traffic)
Attribution "ISS position: wheretheiss.at"

Aircraft — adsb.fi open data (default)

Endpoints https://opendata.adsb.fi/api/v2/mil, /api/v2/sqk/{7500,7600,7700}, /api/v3/lat/{lat}/lon/{lon}/dist/{nm} (max 250 nm)
Docs https://github.com/adsbfi/opendata
Terms Personal, non-commercial use only. The data may not be licensed, sold, rented or leased. Attribution with a link to https://adsb.fi/ is required (shown in the map's attribution and on each aircraft card). Contact adsb.fi for commercial use or higher rates.
Upstream limit 1 request per second on public endpoints. 400/401/403/404/429 responses count toward a temporary IP restriction. No global "all aircraft" endpoint.
Our refresh One shared gate spaces every call ≥ 1.1 s. Base snapshot (worldwide military) every 10 s; emergency squawks every ~30 s. Viewport detail in 5° grid cells (≤ 212 nm circles, at most 6 per view), cached 8 s (just under the 10 s client poll) and shared by all viewers; if the queue to adsb.fi backs up beyond 6 s, cached cells are served instead of queueing more calls. 429/503 trigger a back-off honouring Retry-After.
Attribution "Aircraft: adsb.fi" (linked)
Notes Military flag = source dbFlags & 1, plus a conservative ICAO address-block list (US, UK, FR, DE).

Aircraft — adsb.lol (alternative, ADSB_PROVIDER=adsblol)

Endpoints https://api.adsb.lol/v2/mil, /v2/sqk/{squawk}, /v2/lat/{lat}/lon/{lon}/dist/{nm}
License ODbL 1.0
Upstream limit Keyless: 500 requests per day per IP (published in x-ratelimit-* headers). A quota pacer spreads them evenly, so refreshes are minutes apart without a key.
Attribution "Aircraft: adsb.lol (ODbL)" — update aircraft/meta.ts if you switch.

Ships — AISStream.io

Endpoint wss://stream.aisstream.io/v0/stream (websocket; free API key)
Docs https://aisstream.io/documentation
License Free service, no SLA; AIS broadcasts are public radio transmissions. Attribution requested.
Ingestion worker/ais.mts, a separate long-running process (not a Vercel function). Subscribes to position reports (class A/B) and static data worldwide, keeps the latest state per MMSI, upserts to the Postgres vessels table every 15 s, prunes vessels silent for 72 h.
Our refresh Map reads the table every 15 s (clients poll every 30 s).
Attribution "Ships: AISStream.io"
Derived flags Went dark: under way (≥ 1 kn, not anchored/moored), ≥ 3 reports, then silent > AIS_DARK_HOURS (default 6 h). This can also mean the vessel left terrestrial receiver coverage — the card says so. Flag state: from the MMSI's Maritime Identification Digits (ITU), not the registry.

Sanctions — OFAC Specially Designated Nationals list

Endpoint https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.CSV
Docs https://ofac.treasury.gov/specially-designated-nationals-and-blocked-persons-list-sdn-human-readable-lists
License U.S. Government work — public domain
Our refresh Daily (cached in Postgres); vessel rows only
Matching IMO numbers and MMSIs extracted from the Remarks field. IMO matches are strong (the IMO number survives renames and reflagging); MMSI-only matches are weaker because MMSIs change with flag. The card states which matched.
Attribution "Sanctions data: U.S. Department of the Treasury, OFAC"
Disclaimer A match is an automated lead, not a legal determination. Verify against the official OFAC search tool.

Wildfires — NASA FIRMS

Endpoint https://firms.modaps.eosdis.nasa.gov/api/area/csv/{MAP_KEY}/{VIIRS_NOAA20_NRT,VIIRS_NOAA21_NRT}/world/2
Docs https://firms.modaps.eosdis.nasa.gov/api/
License NASA open data — free to use with attribution. NRT data is for situational awareness, not ground truth.
Key Free FIRMS_MAP_KEY (server-side only). Limit: 5,000 transactions per 10 minutes.
Our refresh Every 30 min (FIRMS updates per satellite pass, roughly every few hours). Two requests per refresh. Viewport-loaded; up to 25,000 detections per response, strongest fire radiative power first; clustered above 5,000.
Attribution "Fire data: NASA FIRMS (LANCE / VIIRS)"
Notes Each point is a 375 m VIIRS pixel with a thermal anomaly — it may also be a gas flare, volcano or industrial heat source.

Tropical cyclones — NOAA NHC + GDACS

Endpoints NHC: https://www.nhc.noaa.gov/CurrentStorms.json and the GIS map service https://mapservices.weather.noaa.gov/tropical/rest/services/tropical/NHC_tropical_weather/MapServer ({bin} Forecast Cone / Forecast Track / Past Track, queried as GeoJSON). GDACS: event list (below) plus /gdacsapi/api/polygons/getgeometry per active cyclone.
License NHC: U.S. Government work, public domain. GDACS: free to use with attribution.
Coverage NHC covers the Atlantic and the Eastern/Central Pacific; GDACS covers every basin (its tracks come from JTWC/NHC). Where both report the same storm, NHC is used.
Our refresh 15 min
Attribution "Cyclone data: NOAA National Hurricane Center; GDACS"

Disaster alerts — GDACS

Endpoint https://www.gdacs.org/gdacsapi/api/events/geteventlist/SEARCH?eventlist=TC;EQ;FL;VO;WF;DR&alertlevel=Green;Orange;Red&fromDate=…&toDate=… (current events only)
Docs https://www.gdacs.org/ — Global Disaster Alert and Coordination System (European Commission JRC and UN OCHA)
License Free to use with attribution
Our refresh 15 min; one list request shared by the alerts and cyclone layers
Attribution "Disaster alerts: GDACS"

Disease outbreaks — WHO Disease Outbreak News

Endpoint https://www.who.int/api/news/diseaseoutbreaknews (latest 100 notices)
Site https://www.who.int/emergencies/disease-outbreak-news
License © World Health Organization; reuse with attribution per WHO terms (https://www.who.int/about/policies/publishing/copyright)
Our refresh Every 6 h
Placement Countries are matched in each notice's title (offline table from the world-countries package, ODbL) and pinned at the country's representative point, not the outbreak site. One pin per disease and country, showing the latest notice and the number of notices in the past year. Global and multi-region notices are not mapped.
Attribution "Outbreak notices: World Health Organization"

Public cameras — transport-agency open data (9 sources, ~10,400 cameras)

All cameras come from feeds that agencies publish for public use. Nothing behind a login is used. Camera lists are refreshed every 6 hours into the cameras table. Snapshots go through our proxy (/api/cameras/image), which only fetches cameras we listed, only from each source's allow-listed hosts, only real image bytes, and caches each image for half its update interval, so many viewers cost one upstream request. Live HLS streams and MP4 clips are played directly by the viewer's browser from the agency's video server, because proxying video isn't practical.

Source Endpoint Cameras Media Licence / terms Attribution
Caltrans CWWP2 (California) https://cwwp2.dot.ca.gov/data/d{1-12}/cctv/cctvStatusD{nn}.json ~3,400 stills; ~2,200 live HLS (wzmedia.dot.ca.gov, CORS-enabled) Public Caltrans data "Caltrans"
NYC DOT (NYCTMC) https://webcams.nyctmc.org/api/cameras ~980 stills (~2 s updates; we refresh ≥ 10 s) Public traffic camera images published by NYC DOT — verify terms before commercial use "NYC DOT"
TfL JamCams (London) https://api.tfl.gov.uk/Place/Type/JamCam ~830 stills + 10 s MP4 clips (S3 jamcams.tfl.gov.uk) TfL Open Data terms; anonymous use is rate-limited (register an app key for more) "Powered by TfL Open Data"
DriveBC (British Columbia) https://www.drivebc.ca/api/webcams/ ~1,060 stills Province of British Columbia; images credited to DriveBC.ca "DriveBC.ca"
DGT (Spain) https://nap.dgt.es/datex2/v3/dgt/DevicePublication/camaras_datex2_v37.xml (DATEX II) ~1,980 stills (etraffic.dgt.es) CC BY (National Access Point) "DGT (nap.dgt.es)"
Fintraffic Digitraffic (Finland) https://tie.digitraffic.fi/api/weathercam/v1/stations ~810 sites, several views each stills (weathercam.digitraffic.fi) CC BY 4.0; send a Digitraffic-User header "Fintraffic / digitraffic.fi"
NZ Transport Agency https://trafficnz.info/service/traffic/rest/4/cameras/all ~250 stills NZTA Waka Kotahi open traffic data (CC BY 4.0) "NZ Transport Agency Waka Kotahi"
Hong Kong Transport Department https://static.data.gov.hk/td/traffic-snapshot-images/code/Traffic_Camera_Locations_En.xml ~1,000 stills (tdcctv.data.one.gov.hk) DATA.GOV.HK terms of use "Transport Department, HKSAR"
Singapore LTA https://api.data.gov.sg/v1/transport/traffic-images 8 (the v1 API currently returns only 8) stills; URLs rotate each minute, resolved at view time Singapore Open Data Licence "LTA, data.gov.sg"

Refresh: lists every 6 h; stills at each camera's own interval (10 s – 15 min), paused while the tab is hidden.

Checked but not used:

  • German Autobahn API: reports no webcams on any road.
  • Ontario 511 and Alberta 511: now require a developer key.
  • Taiwan freeway CCTV: the endpoint was unreachable.

Ready to add with free keys: Utah, Nevada, New York State and other US 511 systems, Ontario, Alberta, Washington (WSDOT), Oregon (TripCheck), Sweden (Trafikverket), and Windy Webcams (worldwide).

News — The GDELT Project (GKG 2.0)

Endpoint https://data.gdeltproject.org/gdeltv2/lastupdate.txt → {YYYYMMDDHHMMSS}.gkg.csv.zip (published every 15 minutes)
Docs https://www.gdeltproject.org/data.html#rawdatafiles
License GDELT data is free for any use with attribution ("The GDELT Project", link to gdeltproject.org). Headlines and links point to third-party publishers; we show the headline and link only, never article text.
Our refresh 15 min; up to 8 missed files back-filled. Articles are kept 48 h in news_articles; the map shows the last 24 h.
Filter Articles tagged with a crisis/security theme (killing, armed conflict, terrorism, protest, unrest, disasters, evacuations, coups …) and negative tone; duplicate headlines dropped. Pinned at the article's most specific location (city > state > country).
Scoring Each kept article is scored once, in batches of 25, by Claude (claude-opus-5-5, low effort, structured output): severity 1–5 and a one-sentence neutral summary written from the headline only. Capped at NEWS_SCORE_PER_HOUR (default 200); the most likely-important unscored articles go first. Until scored, a pin shows a provisional severity from GDELT themes and tone, labelled as such.
Attribution "News: The GDELT Project"
Note The GDELT GEO 2.0 API (geocoded pins) now returns 404, and the DOC 2.0 API has no coordinates and allows 1 request per 5 s. The raw GKG files replace both.

Conflict events — UCDP Georeferenced Event Dataset

Endpoint https://ucdpapi.pcr.uu.se/api/gedevents/{version}?pagesize=1000&StartDate=…
Docs https://ucdp.uu.se/apidocs/
Key Free access token (header x-ucdp-access-token), set as UCDP_TOKEN. Version: UCDP_GED_VERSION (default 25.1); optional monthly candidate release: UCDP_CANDIDATE_VERSION.
License CC BY 4.0 — cite Uppsala Conflict Data Program (Sundberg & Melander 2013; Davies et al.)
Our refresh Daily into conflict_events; the map shows the last 3 years with best-estimate fatalities.
Attribution "Conflict data: UCDP, Uppsala University"

Risk hexes — derived

Method For each H3 cell (resolution 3, ~60 km), sum 2.5^(severity−1) over news (half-life 1 day), UCDP events (half-life 90 days) and GDACS alerts (half-life 7 days); severity-1 items are ignored. The score maps to levels 1–5 on a log scale. Each hex lists its top contributing items.
Caveat It reflects coverage as much as events: places with dense media coverage score higher. It is an awareness aid, not a risk assessment.

Country indicators — World Bank WDI

Endpoint https://api.worldbank.org/v2/country/{iso2}/indicator/{ids}?source=2&mrnev=1
License CC BY 4.0
Indicators Population, GDP, GDP per capita, inflation, unemployment (ILO modelled), life expectancy — most recent non-empty year.
Our refresh Cached 24 h per country
Attribution "World Development Indicators, The World Bank"

Map assistant — Claude (Anthropic API)

How it works /api/assistant runs a tool loop on our server (Messages API tool runner, claude-opus-5-5, medium effort). Claude can only call our own read-only tools: list layers, query a layer by area or near a point, "what's here?", geocode (our Nominatim proxy), country brief. Answers cite the layer behind each fact; the panel also lists every layer consulted with its data time.
Data sent to Anthropic The user's questions and the tool results (public layer data). No user location or identity.
Cost controls Per-client rate limit and ASSISTANT_DAILY_LIMIT (default 200 questions/day per server instance).

Basemaps, search and terrain

Vector basemap — OpenFreeMap / OpenMapTiles / OpenStreetMap

Endpoint https://tiles.openfreemap.org/ (vector tiles, glyphs, sprites)
Docs https://openfreemap.org/
License Free, no key, no request limits. Tiles: OpenMapTiles schema (BSD/CC-BY); data: © OpenStreetMap contributors, ODbL 1.0
Attribution "OpenFreeMap © OpenMapTiles Data from OpenStreetMap" (shown in the map's attribution control)
Notes The "Night" and "Relief" palettes are our own recolouring of OpenFreeMap's dark style structure.

Place search — Nominatim (OpenStreetMap Foundation)

Endpoint https://nominatim.openstreetmap.org/search, /reverse
Policy https://operations.osmfoundation.org/policies/nominatim/
License Data © OpenStreetMap contributors, ODbL 1.0
How we comply Requests go through /api/search and /api/here only; a global gate keeps us at ≤ 1 request/second; a descriptive User-Agent identifies the app; results are cached in memory for 1 h; we search only when the user presses Enter (no search-as-you-type). Queries are not logged or persisted.
Attribution "Place search © OpenStreetMap contributors" (shown under search results)
Production note For heavy traffic, switch to a self-hosted Nominatim or a commercial geocoder; the public instance is for light use.

Satellite imagery — Esri World Imagery

Endpoint https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}
Terms https://www.esri.com/en-us/legal/terms/full-master-agreement
Attribution "Imagery © Esri, Maxar, Earthstar Geographics, and the GIS User Community"
Notes Review before commercial launch. Esri permits attributed use of this basemap, but some commercial uses require an ArcGIS account. Alternatives: MapTiler Satellite (free key tier) or EOX Sentinel-2 cloudless (CC BY-NC-SA for recent years).

Elevation (relief hillshade) — Terrain Tiles on AWS Open Data

Endpoint https://s3.amazonaws.com/elevation-tiles-prod/terrarium/{z}/{x}/{y}.png
Docs https://registry.opendata.aws/terrain-tiles/
License Mixed open sources — see https://github.com/tilezen/joerd/blob/master/docs/attribution.md
Attribution "Elevation: Mapzen Terrain Tiles (SRTM, GMTED2010, ETOPO1 and others)"

Planned sources

These are listed so their terms are reviewed before integration. Each one gets a full section (endpoint, licence, refresh, attribution) when its layer lands.

  • Infrastructure: WRI Global Power Plant Database, OurAirports, NGA World Port Index, GRanD dams

Reference data

Country names and centres — world-countries

Source npm package world-countries (https://github.com/mledoze/countries)
License ODbL 1.0
Use Matching country names in text and placing country-level items