docs(attribution): credit adsbdb and carry its route-data terms

adsbdb supplies the aircraft type, model name and registration behind every
enriched flight, and the airline and origin/destination pair behind the
tracked contact's FROM -> TO strip. It appeared in neither attribution
surface: DATA_SOURCES.md and src/data/dataCredits.js each held zero
occurrences of it, against the rule both files state for themselves and
CONTRIBUTING's fourth pull-request item. adsb.lol is a different operator and
its ODbL credit does not reach this data.

The reporter of #256 left the patch off deliberately, saying the terms were
what should not be guessed. They are published, so this takes them from the
source rather than inventing them: adsbdb credits PlaneBase for the aircraft
data and Guillaume Michel for the ICAO-to-N-number conversion, and states that
the flight route data "is the work of David Taylor, Edinburgh and Jim Mason,
Glasgow, and may not be copied, published, or incorporated into other
databases without the explicit permission of David J Taylor, Edinburgh". No
licence or rate limit is published for the service itself.

That restriction is the reason the note records what the proxy does with what
it fetches: responses are cached per key for 24 hours in .gev-cache/adsbdb.json,
which is gitignored, so the data stays on the operator's machine and is never
bundled with this repo or redistributed.

A test pins the credit. The attribution is a requirement rather than a
preference, so it should fail loudly if a later edit drops the names or the
restriction, instead of surviving on luck.
This commit is contained in:
daikaginza committed 2026-09-19 20:12:36 +07:00
1 parent 0d41b6be54
commit ae35a2c939
5 files changed
+65 -1

No files matched your search

+10
View File
@@ -1,5 +1,15 @@
# Changelog
- Credit adsbdb, which supplies the aircraft type, model name and registration
on enriched flights and the airline and origin/destination pair behind the
tracked contact's route strip. `DATA_SOURCES.md` now records the terms adsbdb
publishes — aircraft data from PlaneBase, and route data that is the work of
David Taylor, Edinburgh, and Jim Mason, Glasgow, and may not be copied into
another database without his permission — along with the request bounds and
the gitignored 24-hour cache that keep the app inside them. A matching
`DATA_CREDITS` entry surfaces the credit in the in-app Data attribution
popover, and a test pins the wording the route data requires.
- Distinguish PARTIAL vessel snapshots from STALE data in the layer panel, with
accepted-record counts and unchanged retention, freshness and outage safeguards.