A spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe.
JavaScript 3d-globecesiumflight-trackinggeospatialgeospatial-intelligencegisosintphotogrammetrysatellite-trackingspatial-intelligencewebglworldview
import { readWindBody } from '../../sources/windBody.js';
import { SCALAR_UNAVAILABLE } from './fields.js';
// Imported by src/tools: no i18n here. The texts stay English data and the
// wind layer and layer panel show them translated.
const msg = (text) => text;
/** Create a bounded, cancellable source for the same-origin wind provider. */
export function createWindSource({
fetchImpl = (...args) => globalThis.fetch(...args),
timeoutMs = 45_000,
} = {}) {
return {
async getSnapshot({ signal, model = 'gfs', overlay = 'none' } = {}) {
if (!['gfs', 'ifs'].includes(model))
throw new Error(msg('Unknown wind model'));
if (!['none', 'temperature', 'pressure'].includes(overlay))
throw new Error(msg('Unknown weather overlay'));
const query = `model=${model}${overlay === 'none' ? '' : `&overlay=${overlay}`}`;
const controller = new AbortController();
const abort = () => controller.abort(signal.reason);
signal?.addEventListener('abort', abort, { once: true });
const timer = setTimeout(
() => controller.abort(new Error(msg('Wind request timed out'))),
timeoutMs,
);
const active = controller.signal;
try {
signal?.throwIfAborted();
const response = await fetchImpl(`/api/wind/manifest?${query}`, {
signal: active,
cache: 'no-store',
redirect: 'error',
});
if (!response.ok) throw new Error(`Wind HTTP ${response.status}`);
const manifest = JSON.parse(
new TextDecoder().decode(
await readWindBody(response, 16_384, active),
),
);
if (manifest?.unavailable) return manifest;
const grid = manifest?.grid;
const scalar = manifest?.scalar;
const scalarError = manifest?.scalarError;
const optionalUnavailable =
overlay !== 'none' &&
scalar === undefined &&
scalarError === SCALAR_UNAVAILABLE[overlay];
const scalarValid =
overlay === 'none'
? scalar === undefined && scalarError === undefined
: optionalUnavailable ||
(scalarError === undefined &&
scalar?.kind === overlay &&
scalar.units === (overlay === 'temperature' ? '°C' : 'hPa') &&
scalar.level ===
(overlay === 'temperature'
? '2 m above ground'
: 'mean sea level'));
if (
manifest?.model !== model ||
(manifest.overlay ?? 'none') !== overlay ||
!scalarValid ||
!grid ||
!Number.isInteger(grid.nx) ||
!Number.isInteger(grid.ny) ||
grid.nx < 1 ||
grid.ny < 1 ||
grid.nx * grid.ny > 1_000_000 ||
![grid.lo1, grid.la1, grid.dx, grid.dy].every(Number.isFinite) ||
grid.dx <= 0 ||
grid.dy <= 0 ||
Math.abs(grid.nx * grid.dx - 360) > 0.01 ||
!new RegExp(
`^/api/wind/grid/${model}-[\\w.-]+\\.bin\\?${query}$`,
).test(manifest.gridUrl)
)
throw new Error(msg('Malformed wind manifest'));
const count = grid.nx * grid.ny;
const expectedBytes = count * (scalar ? 12 : 8);
const gridResponse = await fetchImpl(manifest.gridUrl, {
signal: active,
redirect: 'error',
});
if (!gridResponse.ok)
throw new Error(`Wind HTTP ${gridResponse.status}`);
const bytes = await readWindBody(gridResponse, expectedBytes, active);
if (bytes.byteLength !== expectedBytes)
throw new Error(msg('Malformed wind grid'));
const values = new Float32Array(bytes.buffer);
if (!values.every(Number.isFinite))
throw new Error(msg('Malformed wind grid'));
return {
...manifest,
u: values.slice(0, count),
v: values.slice(count, count * 2),
...(scalar
? { scalar: { ...scalar, values: values.slice(count * 2) } }
: {}),
};
} finally {
clearTimeout(timer);
signal?.removeEventListener('abort', abort);
}
},
};
}