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
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