mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 08:12:24 +00:00
Data attribution no longer builds Cesium credits itself: each credit is added through the renderer's credits port, in the attribution list as before. The port's credit carries one link, so a credit whose markup holds several links becomes one credit per link, shown together in order, its wording kept. dataCredits.js leaves the Cesium allow-list.
247 lines
8.8 KiB
JavaScript
247 lines
8.8 KiB
JavaScript
import { test } from 'node:test';
|
||
import assert from 'node:assert/strict';
|
||
import { DATA_CREDITS, NYC_DOT_DISCLAIMER } from './dataCredits.js';
|
||
import { bindFakeCesiumCredits } from '../testSupport/fakeCreditsPort.mjs';
|
||
|
||
test('every credit carries a unique key and some markup to render', () => {
|
||
const keys = DATA_CREDITS.map((entry) => entry.key);
|
||
assert.equal(
|
||
new Set(keys).size,
|
||
keys.length,
|
||
'a duplicate key would silently shadow one provider’s credit',
|
||
);
|
||
for (const entry of DATA_CREDITS) {
|
||
assert.ok(entry.key, 'a credit without a key cannot be registered');
|
||
assert.ok(
|
||
entry.html && entry.html.trim().length > 0,
|
||
`credit ${entry.key} has nothing to show`,
|
||
);
|
||
}
|
||
});
|
||
|
||
test('adsbdb is credited and carries its published route-data restriction', () => {
|
||
const credit = DATA_CREDITS.find((entry) => entry.key === 'adsbdb');
|
||
assert.ok(
|
||
credit,
|
||
'adsbdb supplies aircraft type and routes and must be credited',
|
||
);
|
||
// adsbdb publishes this restriction for its route data. Pin the provider's
|
||
// credits and restriction here so a later edit cannot silently remove them.
|
||
assert.match(credit.html, /David Taylor, Edinburgh/);
|
||
assert.match(credit.html, /Jim Mason, Glasgow/);
|
||
assert.match(
|
||
credit.html,
|
||
/may not be\s+copied, published, or incorporated into other databases/,
|
||
);
|
||
assert.match(credit.html, /explicit permission of David J Taylor, Edinburgh/);
|
||
assert.match(credit.html, /PlaneBase/);
|
||
assert.match(credit.html, /Guillaume Michel/);
|
||
assert.match(credit.html, /href="https:\/\/www\.adsbdb\.com"/);
|
||
});
|
||
|
||
test('OpenStreetMap has one generic data credit with separate tile and names distributors', () => {
|
||
const osm = DATA_CREDITS.filter((entry) =>
|
||
entry.html.includes('openstreetmap.org/copyright'),
|
||
);
|
||
assert.equal(osm.length, 1);
|
||
assert.equal(osm[0].key, 'openstreetmap');
|
||
assert.match(osm[0].html, /Map and place data/);
|
||
assert.match(osm[0].html, /© OpenStreetMap contributors/);
|
||
assert.match(
|
||
DATA_CREDITS.find((entry) => entry.key === 'openfreemap').html,
|
||
/Vector tiles:/,
|
||
);
|
||
assert.match(
|
||
DATA_CREDITS.find((entry) => entry.key === 'overture-military-names').html,
|
||
/Overture Maps Foundation/,
|
||
);
|
||
});
|
||
|
||
test('inline OSM attribution persists until its last display owner leaves', async (t) => {
|
||
const { showOsmCredit, hideOsmCredit } = await import('./dataCredits.js');
|
||
t.mock.timers.enable({ apis: ['setTimeout'] });
|
||
const visible = new Set();
|
||
const viewer = bindFakeCesiumCredits({
|
||
creditDisplay: {
|
||
addStaticCredit: (c) => visible.add(c),
|
||
removeStaticCredit: (c) => visible.delete(c),
|
||
},
|
||
scene: { requestRender() {} },
|
||
});
|
||
assert.equal(showOsmCredit(viewer, 'alpr'), true);
|
||
assert.equal(showOsmCredit(viewer, 'alpr'), false);
|
||
assert.equal(visible.size, 1);
|
||
assert.match(
|
||
[...visible][0].html,
|
||
/href="https:\/\/www.openstreetmap.org\/copyright"/,
|
||
);
|
||
assert.match([...visible][0].html, />© OpenStreetMap</);
|
||
assert.ok([...visible][0].showOnScreen);
|
||
t.mock.timers.tick(60000);
|
||
assert.equal(visible.size, 1);
|
||
showOsmCredit(viewer, 'traffic', { openMapTiles: true });
|
||
assert.equal(visible.size, 2);
|
||
hideOsmCredit(viewer, 'alpr');
|
||
assert.equal(visible.size, 2, 'traffic still owns both credits');
|
||
showOsmCredit(viewer, 'datacenters');
|
||
hideOsmCredit(viewer, 'traffic');
|
||
assert.equal(
|
||
visible.size,
|
||
1,
|
||
'bundled data does not retain the tile distributor',
|
||
);
|
||
hideOsmCredit(viewer, 'datacenters');
|
||
assert.equal(visible.size, 0);
|
||
assert.equal(hideOsmCredit(viewer, 'datacenters'), false);
|
||
showOsmCredit(viewer, 'alpr');
|
||
assert.equal(visible.size, 1, 'reenabling restores the short credit');
|
||
});
|
||
|
||
test('tile attribution follows source changes and viewers have independent ownership', async () => {
|
||
const { showOsmCredit, hideOsmCredit } = await import('./dataCredits.js');
|
||
const create = () => {
|
||
const credits = new Set();
|
||
return bindFakeCesiumCredits({
|
||
credits,
|
||
creditDisplay: {
|
||
addStaticCredit: (c) => credits.add(c),
|
||
removeStaticCredit: (c) => credits.delete(c),
|
||
},
|
||
});
|
||
};
|
||
const a = create(),
|
||
b = create();
|
||
showOsmCredit(a, 'installations', { openMapTiles: true });
|
||
showOsmCredit(b, 'installations');
|
||
assert.equal(a.credits.size, 2);
|
||
assert.equal(b.credits.size, 1);
|
||
showOsmCredit(a, 'installations');
|
||
assert.equal(a.credits.size, 1, 'wide names no longer use tiles');
|
||
hideOsmCredit(a, 'installations');
|
||
assert.equal(a.credits.size, 0);
|
||
assert.equal(b.credits.size, 1);
|
||
});
|
||
|
||
test('the NYC camera credit carries NYC DOT’s requested disclaimer', () => {
|
||
const credit = DATA_CREDITS.find((entry) => entry.key === 'nyc-cctv');
|
||
assert.ok(credit, 'NYC DOT camera frames must be credited');
|
||
assert.ok(credit.html.includes(NYC_DOT_DISCLAIMER));
|
||
assert.match(credit.html, /make no representation as to the accuracy/);
|
||
assert.match(credit.html, /observe posted signage/);
|
||
});
|
||
|
||
test('every Street Level imagery source is in the attribution lightbox', () => {
|
||
for (const key of [
|
||
'mapillary',
|
||
'google-street-view',
|
||
'kartaview',
|
||
'panoramax',
|
||
])
|
||
assert.ok(
|
||
DATA_CREDITS.some((entry) => entry.key === key),
|
||
`${key} has no credit`,
|
||
);
|
||
});
|
||
|
||
test('a credit with several links becomes one credit per link, in order', async () => {
|
||
const {
|
||
creditsFromMarkup,
|
||
OSM_CREDIT,
|
||
OPENMAPTILES_CREDIT,
|
||
WOF_CREDIT,
|
||
BHOTE_KOSHI_CREDIT,
|
||
} = await import('./dataCredits.js');
|
||
const html = (key) => DATA_CREDITS.find((entry) => entry.key === key).html;
|
||
const read = (markup) =>
|
||
creditsFromMarkup(markup).map(({ text, href }) => [text, href]);
|
||
assert.deepEqual(read(OSM_CREDIT.html), [
|
||
[
|
||
'Map and place data © OpenStreetMap contributors',
|
||
'https://www.openstreetmap.org/copyright',
|
||
],
|
||
['(ODbL)', 'https://opendatacommons.org/licenses/odbl/1-0/'],
|
||
]);
|
||
assert.deepEqual(read(OPENMAPTILES_CREDIT.html), [
|
||
['Vector tiles: OpenFreeMap', 'https://openfreemap.org'],
|
||
['© OpenMapTiles', 'https://openmaptiles.org'],
|
||
]);
|
||
assert.deepEqual(read(html('nasa-gibs'))[1], [
|
||
'HLS product page',
|
||
'https://lpdaac.usgs.gov/products/hlss30v002/',
|
||
]);
|
||
assert.deepEqual(read(html('wfigs')), [
|
||
[
|
||
'Wildfire perimeters: National Interagency Fire Center (WFIGS)',
|
||
'https://data-nifc.opendata.arcgis.com/',
|
||
],
|
||
['Incident information: InciWeb', 'https://inciweb.wildfire.gov/'],
|
||
]);
|
||
assert.deepEqual(read(html('eccc-aqhi')), [
|
||
[
|
||
'Air quality (AQHI): Environment and Climate Change Canada — MSC GeoMet (eccc-msc.github.io/open-data)',
|
||
'https://eccc-msc.github.io/open-data/',
|
||
],
|
||
[
|
||
'ECCC Data Servers End-use Licence',
|
||
'https://eccc-msc.github.io/open-data/licence/readme_en/',
|
||
],
|
||
]);
|
||
assert.deepEqual(
|
||
read(BHOTE_KOSHI_CREDIT.html)[1][0].slice(0, 15),
|
||
'and GeoPera (CC',
|
||
);
|
||
assert.deepEqual(
|
||
read(WOF_CREDIT.html).map(([text]) => text),
|
||
[
|
||
"Neighborhood boundaries: Who's On First and contributors, simplified",
|
||
'(sources and licences)',
|
||
],
|
||
);
|
||
const link = (text) => `<a href="https://example.org">${text}</a>`;
|
||
assert.deepEqual(
|
||
read(`${link('A')} by Hoffleit & Warren ${link('B')}`).map(
|
||
([text]) => text,
|
||
),
|
||
['A', 'by Hoffleit & Warren B'],
|
||
'a character reference is not a separator',
|
||
);
|
||
assert.deepEqual(read(html('usgs')), [
|
||
['Earthquakes: Data courtesy of the U.S. Geological Survey', undefined],
|
||
]);
|
||
for (const entry of DATA_CREDITS) {
|
||
const credits = creditsFromMarkup(entry.html);
|
||
const links = entry.html.match(/<a\b/g)?.length ?? 0;
|
||
assert.equal(credits.length, Math.max(links, 1), entry.key);
|
||
assert.ok(
|
||
credits.every((credit) => credit.inline === false),
|
||
`${entry.key} belongs in the attribution list`,
|
||
);
|
||
}
|
||
});
|
||
|
||
test('data credits go through the renderer to the attribution list', async () => {
|
||
const { registerDataCredits, registerDynamicCredit, TOMTOM_CREDIT } =
|
||
await import('./dataCredits.js');
|
||
const shown = [];
|
||
const viewer = bindFakeCesiumCredits({
|
||
creditDisplay: {
|
||
addStaticCredit: (c) => shown.push(c),
|
||
removeStaticCredit() {},
|
||
},
|
||
});
|
||
const credits = DATA_CREDITS.filter((entry) =>
|
||
['openstreetmap', 'usgs'].includes(entry.key),
|
||
);
|
||
registerDataCredits(viewer, credits);
|
||
assert.equal(shown.length, 3);
|
||
assert.ok(shown.every((credit) => !credit.showOnScreen));
|
||
const odbl = shown.find((credit) => credit.html.includes('opendatacommons'));
|
||
assert.match(odbl.html, /href="https:\/\/opendatacommons.org/);
|
||
assert.match(odbl.html, />\(ODbL\)</);
|
||
assert.equal(registerDynamicCredit(viewer, TOMTOM_CREDIT), true);
|
||
assert.equal(registerDynamicCredit(viewer, TOMTOM_CREDIT), true);
|
||
assert.equal(shown.length, 4, 'a dynamic credit is added once');
|
||
assert.match(shown[3].html, /Traffic flow data © TomTom/);
|
||
assert.equal(registerDynamicCredit({}, { key: 'none', html: 'x' }), false);
|
||
});
|