mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 08:12:24 +00:00
A failure now ends when its city leaves range or the camera rises above the activation gate, so an empty map no longer reads LOAD FAILED. Late activation and status rejections are ignored like late successes. Partial failure reads DEGRADED, every in-range city failing over cached points reads STALE, and freshness advances only on a refresh that succeeded. Behavioural tests drive the real proximity, update and enable paths. Docs say no licence is published for Toronto and list Social Bicycles and PBSC. The merge also restored the #61 GBFS v3 changelog entry that an earlier merge on main dropped.
94 lines
3.3 KiB
JavaScript
94 lines
3.3 KiB
JavaScript
import { STATUS_POLL_MS } from './policy.js';
|
|
|
|
export function createControls({ state: layerState, services, parts, source }) {
|
|
const methods = {
|
|
id: 'bikeshare',
|
|
|
|
name: 'Bikeshare',
|
|
|
|
icon: '🚲',
|
|
|
|
source: 'GBFS',
|
|
|
|
updateInterval: STATUS_POLL_MS,
|
|
|
|
/**
|
|
* Return a sampled array of detectable station objects for HUD overlay rendering.
|
|
* @param {Object} [options] - Sampling options (maxCount, seed).
|
|
* @returns {Array<{ position: Cesium.Cartesian3, id: string, type: string, skipLabel: boolean }>}
|
|
*/
|
|
getDetectableObjects(options = {}) {
|
|
return parts.queries.collectDetectableStations(options);
|
|
},
|
|
|
|
/**
|
|
* Snapshot loaded bikeshare stations as plain JSON-safe records for the analyst
|
|
* query engine. On demand only (once per spoken query); [] while the
|
|
* layer is off.
|
|
* @param {number} [maxCount=Infinity] Most records to return.
|
|
* @returns {Array<Object>} {id, name, city, lat, lon, bikesAvailable, docksAvailable, capacity, renting}.
|
|
*/
|
|
getAnalystRecords(maxCount = Infinity) {
|
|
if (!layerState._enabled) return [];
|
|
const num = (v) => (Number.isFinite(v) ? v : null);
|
|
const result = [];
|
|
for (const record of layerState._stationRenderMap.values()) {
|
|
if (result.length >= maxCount) break;
|
|
const info = layerState._stationInfoCache
|
|
.get(record.cityId)
|
|
?.get(record.stationId);
|
|
if (!Number.isFinite(info?.lat) || !Number.isFinite(info?.lon))
|
|
continue;
|
|
result.push({
|
|
id: record.stationName || `Dock ${record.stationId}`,
|
|
name: record.stationName || null,
|
|
city: record.cityId || null,
|
|
lat: info.lat,
|
|
lon: info.lon,
|
|
bikesAvailable: num(record.bikesAvailable),
|
|
docksAvailable: num(record.docksAvailable),
|
|
capacity: num(record.capacity),
|
|
renting: record.isRenting !== false,
|
|
});
|
|
}
|
|
return result;
|
|
},
|
|
|
|
/**
|
|
* Return current layer statistics for the UI status display.
|
|
* @returns {{ count: number, lastUpdate: number|null, loading: boolean, loadingLabel?: string, error?: string, degraded?: boolean, stale?: boolean }}
|
|
*/
|
|
getStats() {
|
|
const stats = {
|
|
count: layerState._count,
|
|
lastUpdate: layerState._lastUpdate,
|
|
loading: layerState._loading,
|
|
};
|
|
if (layerState._loading) {
|
|
stats.loadingLabel =
|
|
layerState._activeCityIds.size > 0
|
|
? `syncing ${layerState._activeCityIds.size} city feeds...`
|
|
: 'scanning nearby systems...';
|
|
}
|
|
// A failed city is only the layer's failure when it left nothing on the
|
|
// map. While other cities still render, the partial failure reads
|
|
// DEGRADED; when every in-range city failed and only previously drawn
|
|
// points remain, they read STALE.
|
|
if (layerState._failedCityIds.size > 0) {
|
|
if (layerState._stationRenderMap.size === 0) {
|
|
stats.error = 'GBFS fetch error';
|
|
} else {
|
|
stats.degraded = true;
|
|
const allFailed = Array.from(layerState._activeCityIds).every(
|
|
(cityId) => layerState._failedCityIds.has(cityId),
|
|
);
|
|
if (allFailed) stats.stale = true;
|
|
}
|
|
}
|
|
return stats;
|
|
},
|
|
};
|
|
|
|
return { methods };
|
|
}
|