Files
gods-eye-view/src/layers/vessels/index.js
T
Sameh Khamis 347e77d1f6 feat(vessels): a selected vessel shows its Open Vessel Photos photo and MMSI
Selecting a vessel asks Open Vessel Photos (a free, keyless API) for its
photo by MMSI, once per MMSI. The CONTACTS view shows it under the vessel's
name and MMSI with the photographer, the photo's open licence and a link to
the vessel's page; only images on Open Vessel Photos' own host are shown, and
an answer about another MMSI is no photo. The vessel source exposes the lookup
as getEnrichment({kind: 'photo'}) and fetchOpenVesselPhoto for applications
with their own vessel source.
2026-11-12 20:10:30 -08:00

115 lines
4.4 KiB
JavaScript

import { createVesselState } from './state.js';
import { createLifecycle } from './lifecycle.js';
import { createIngestion } from './ingestion.js';
import { vesselViewArea } from './cameraArea.js';
import { createVesselSnapshotRenderer } from './snapshotRenderer.js';
import { createRendering } from './rendering.js';
import { createSelection } from './selection.js';
import { createTracking } from './tracking.js';
import { createCards } from './cards.js';
import { createPhotos } from './photos.js';
import { createTesting } from './testing.js';
import { createEvidence } from './evidence.js';
import { createQueries } from './queries.js';
import { followsClock } from './policy.js';
import { createSnapshotTimeline } from '../../time/snapshotTimeline.js';
import { worldClock } from '../../time/worldClock.js';
/** Compose one vessel layer with application-owned scene services. */
export function createVesselLayer({ source, services, options = {} } = {}) {
const vesselState = createVesselState({ source, services });
const parts = {};
const layer = {};
const context = { vesselState, services, parts, layer, options };
parts.lifecycle = createLifecycle(context);
parts.rendering = createRendering(context);
parts.selection = createSelection(context);
parts.tracking = createTracking(context);
parts.cards = createCards(context);
parts.photos = createPhotos(context);
parts.testing = createTesting(context);
parts.evidence = createEvidence(context);
parts.queries = createQueries(context);
parts.snapshots = createVesselSnapshotRenderer({
state: vesselState.state,
records: vesselState.state.records,
rendering: parts.rendering,
tracking: parts.tracking,
selection: parts.selection,
cards: parts.cards,
followsClock: () => followsClock(vesselState),
});
parts.ingestion = createIngestion({
feed: vesselState.state.feed,
readSource: () => vesselState._source,
readViewer: () => vesselState.state.viewer,
readArea: vesselViewArea,
getRowLimit: parts.rendering.renderRowLimit,
readCount: () => vesselState.state.records.all.length,
applyRows: parts.snapshots.reconcileVessels,
classifySnapshot: parts.queries.classifyAisFeedSnapshot,
isDefinitiveTransportFailure: parts.lifecycle.isDefinitiveTransportFailure,
isGraceEligibleTransport: parts.lifecycle.isGraceEligibleTransport,
markUnavailable: parts.lifecycle.markAisUnavailable,
settleFirstConnect: parts.lifecycle.settleFirstConnectPhase,
now: () => vesselState._aisRuntime.now(),
setSourceLabel: (source) => {
layer.source = source;
},
followsClock: () => followsClock(vesselState),
reloadAtClock: () => vesselState.timeline.reload(),
});
// Vessels follow the world clock while the source declares a timeline.
vesselState.timeline = createSnapshotTimeline({
id: 'ais-live-vessels',
clock: worldClock,
source: () => vesselState._source,
load: (atMs, { signal, replace }) =>
parts.ingestion.loadAt(atMs, { signal, replace }),
clear: () => {
const { state } = vesselState;
if (state.viewer)
parts.snapshots.reconcileVessels(state.viewer, [], {
complete: true,
replace: true,
});
state.feed.count = state.records.all.length;
state.feed.lastUpdate = null;
},
resumeLive: () => {
void parts.ingestion.loadLivePositions(vesselState.state.viewer);
},
});
Object.assign(
layer,
parts.queries.methods,
parts.lifecycle.methods,
parts.ingestion.methods,
);
layer.source = source?.label || 'Vessels';
Object.assign(layer, {
applyVesselFocusDeemphasis: parts.rendering.applyVesselFocusDeemphasis,
buildVesselCard: parts.cards.buildVesselCard,
buildSelectedVesselCard: parts.cards.buildSelectedVesselCard,
cardScreenSeparated: parts.cards.cardScreenSeparated,
/** The vessel's Open Vessel Photos photo, once its lookup answered. */
getVesselPhoto: (id) =>
parts.photos.vesselPhoto(vesselState.state.records.byId.get(id)),
});
Object.defineProperty(layer, 'testing', { value: parts.testing });
return layer;
}
export { AIS_FIRST_CONNECT_GRACE_MS } from './policy.js';
export {
VESSEL_OVERLAY_SOURCE_ID,
VESSEL_LABEL_GRID_PX,
VESSEL_DEFAULT_LABEL_LIMIT,
VESSEL_OVERLAY_MAX_COHORT,
VESSEL_CARD_FADE_DISTANCE_M,
normalizeVesselType,
vesselTypeCss,
accentForVesselType,
vesselOverlayCohortLimit,
applyVesselOverlayPolicy,
} from '../../data/vesselLabels.js';