mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 16:22:20 +00:00
The transit, ALPR, vessel, CCTV and flight/military context fixes each wrapped 359.5° to north with an inline Math.round(x) % 360. They now call roundHeadingDegrees in src/data/headingDegrees.js, which also wraps negative and multi-turn bearings. normalizeHeading moves there with it, and cockpitMath re-exports it so existing imports keep working. It now adds a turn only to a negative remainder, so a bearing just under half a degree keeps its precision. The awareness, Local ADS-B, cockpit wind, cockpit heading and Street Level readouts use the same helper. The Cockpit's TRACK ACQUIRED signal rounded without wrapping and could read COURSE 360°; it now uses formatHeadingReadout, which shows --- for a track that is not finite.
174 lines
5.8 KiB
JavaScript
174 lines
5.8 KiB
JavaScript
import { AIRCRAFT_CLASS_LABELS } from '../../data/aircraftClass.js';
|
|
import { formatNumber, t, tn } from '../../i18n/index.js';
|
|
import { BAND_LABELS, LOCAL_ADSB_COLOR, SOURCE_LABELS } from './policy.js';
|
|
import { roundHeadingDegrees } from '../../data/headingDegrees.js';
|
|
|
|
const DASH = '—';
|
|
|
|
function rounded(value, digits = 0) {
|
|
if (!Number.isFinite(value)) return null;
|
|
return Number(value.toFixed(digits));
|
|
}
|
|
|
|
function grouped(value) {
|
|
return value === null ? DASH : formatNumber(value);
|
|
}
|
|
|
|
/**
|
|
* Title of a locally heard aircraft: callsign when decoded, else ICAO hex.
|
|
* @param {object} record Local ADS-B record.
|
|
* @returns {string}
|
|
*/
|
|
export function localAdsbTitle(record) {
|
|
return record?.callsign || String(record?.icao || '').toUpperCase();
|
|
}
|
|
|
|
function recordBands(record) {
|
|
if (Array.isArray(record?.bands) && record.bands.length) return record.bands;
|
|
return record?.band ? [record.band] : [];
|
|
}
|
|
|
|
function recordSources(record) {
|
|
if (Array.isArray(record?.sources) && record.sources.length)
|
|
return record.sources;
|
|
return record?.source ? [record.source] : [];
|
|
}
|
|
|
|
/**
|
|
* Whether an aircraft was heard only on 978 MHz UAT (its marker gets the
|
|
* UAT ring). One also heard on 1090 MHz draws as a 1090 aircraft.
|
|
* @param {object} record Local ADS-B record.
|
|
* @returns {boolean}
|
|
*/
|
|
export function localAdsbIsUat(record) {
|
|
const bands = recordBands(record);
|
|
return bands.includes('978') && !bands.includes('1090');
|
|
}
|
|
|
|
/**
|
|
* Receiver line of the click card, e.g. "Heard by your receiver · 1090 MHz ·
|
|
* browser SDR" or "… · 1090 MHz + 978 MHz UAT · browser SDR + decoder feed".
|
|
* @param {object} record Local ADS-B record (merged: `bands`, `sources`).
|
|
* @returns {string}
|
|
*/
|
|
export function localAdsbReceiverLine(record) {
|
|
const bands = recordBands(record).map(bandLabel).filter(Boolean);
|
|
const sources = recordSources(record).map(sourceLabel).filter(Boolean);
|
|
return [t('Heard by your receiver'), bands.join(' + '), sources.join(' + ')]
|
|
.filter(Boolean)
|
|
.join(' · ');
|
|
}
|
|
|
|
/** A receiver band (policy.js BAND_LABELS) in the UI language: "1090 МГц". */
|
|
function bandLabel(band) {
|
|
switch (String(band)) {
|
|
case '1090':
|
|
return t('1090 MHz');
|
|
case '978':
|
|
return t('978 MHz UAT');
|
|
default:
|
|
return BAND_LABELS[band];
|
|
}
|
|
}
|
|
|
|
/** A receiver source (policy.js SOURCE_LABELS) in the UI language. */
|
|
function sourceLabel(source) {
|
|
switch (source) {
|
|
case 'webusb':
|
|
return t('browser SDR');
|
|
case 'feed':
|
|
return t('decoder feed');
|
|
default:
|
|
return SOURCE_LABELS[source];
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Where a heard aircraft came from, for the entity context's source field.
|
|
* @param {object} record Local ADS-B record.
|
|
* @returns {string}
|
|
*/
|
|
export function localAdsbSourceText(record) {
|
|
const sources = recordSources(record);
|
|
if (sources.includes('webusb') && sources.includes('feed'))
|
|
return t('Your RTL-SDR receiver and decoder feed');
|
|
if (sources.includes('feed')) return t('Your decoder feed');
|
|
return t('Your RTL-SDR receiver');
|
|
}
|
|
|
|
/**
|
|
* Class line of the click card, e.g. "Helicopter · A7". Empty when neither an
|
|
* ICAO type nor an emitter category backs the class.
|
|
* @param {object} record Local ADS-B record.
|
|
* @param {{klass?:string, evidence?:boolean}} [aircraftClass]
|
|
* @returns {string}
|
|
*/
|
|
export function localAdsbClassLine(record, aircraftClass = {}) {
|
|
if (!aircraftClass.evidence) return '';
|
|
const label = AIRCRAFT_CLASS_LABELS[aircraftClass.klass];
|
|
return [label && t(label), record?.category].filter(Boolean).join(' · ');
|
|
}
|
|
|
|
/**
|
|
* Click-card presentation for one locally heard aircraft.
|
|
* @param {object} record Local ADS-B record.
|
|
* @param {number} nowMs Current epoch ms, for the position age.
|
|
* @param {object} [extras]
|
|
* @param {{klass:string, evidence:boolean}} [extras.aircraftClass] Class and
|
|
* whether a type or category backs it.
|
|
* @param {object|null} [extras.meta] adsbdb metadata (typeCode, typeName,
|
|
* airline).
|
|
* @param {object|null} [extras.route] A route already judged plausible.
|
|
* @returns {{title:string, details:string[], accent:string}}
|
|
*/
|
|
export function localAdsbCardModel(
|
|
record,
|
|
nowMs,
|
|
{ aircraftClass = null, meta = null, route = null } = {},
|
|
) {
|
|
const icao = String(record?.icao || '').toUpperCase();
|
|
const altitude = rounded(record?.altitudeFt);
|
|
const speed = rounded(record?.groundSpeedKt);
|
|
const track = rounded(record?.trackDeg);
|
|
const vertical = rounded(record?.verticalRateFpm);
|
|
const ageS = Number.isFinite(record?.lastPositionAt)
|
|
? Math.max(0, Math.round((nowMs - record.lastPositionAt) / 1000))
|
|
: null;
|
|
const messages = Math.max(0, Math.trunc(Number(record?.messageCount) || 0));
|
|
// Same identity and route lines the public flight card shows.
|
|
const identity = [meta?.airline, meta?.typeName || meta?.typeCode]
|
|
.filter(Boolean)
|
|
.join(' · ');
|
|
const routeLine =
|
|
route?.origin?.code && route?.destination?.code
|
|
? `${route.origin.code} → ${route.destination.code}`
|
|
: '';
|
|
return {
|
|
title: localAdsbTitle(record),
|
|
details: [
|
|
`ICAO ${icao} · ${record?.callsign || t('NO CALLSIGN')}`,
|
|
localAdsbClassLine(record, aircraftClass || {}),
|
|
identity,
|
|
routeLine,
|
|
t('ALT {altitude} FT · GS {speed} KT · TRK {track}', {
|
|
altitude: grouped(altitude),
|
|
speed: speed === null ? DASH : speed,
|
|
track: track === null ? DASH : `${roundHeadingDegrees(track)}°`,
|
|
}),
|
|
vertical === null
|
|
? t('V/S {rate}', { rate: DASH })
|
|
: t('V/S {rate} FPM', {
|
|
rate: `${vertical > 0 ? '+' : ''}${grouped(vertical)}`,
|
|
}),
|
|
[
|
|
ageS === null
|
|
? t('POSITION {age}', { age: DASH })
|
|
: t('POSITION {seconds} S AGO', { seconds: ageS }),
|
|
tn(messages, '{count} MSG', '{count} MSGS'),
|
|
].join(' · '),
|
|
localAdsbReceiverLine(record),
|
|
].filter(Boolean),
|
|
accent: LOCAL_ADSB_COLOR,
|
|
};
|
|
}
|