Skip to content

A spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe.

2.7 KB
Raw Blame
/** WGS84 coordinate pair in longitude/latitude order. */
export function validCoordinate(pair) {
  return (
    Array.isArray(pair) &&
    pair.length >= 2 &&
    Number.isFinite(pair[0]) &&
    Math.abs(pair[0]) <= 180 &&
    Number.isFinite(pair[1]) &&
    Math.abs(pair[1]) <= 90
  );
}

/** Compose independent geospatial operations; unsupported operations stay explicit. */
export function createGeospatialServices({
  providers = {},
  signal: lifetime,
} = {}) {
  const capabilities = Object.freeze(
    Object.fromEntries(
      ['reverseGeocode', 'textSearch', 'nearby', 'route'].map((name) => [
        name,
        typeof providers[name] === 'function',
      ]),
    ),
  );
  async function invoke(name, args, options = {}) {
    const signal = AbortSignal.any(
      [
        lifetime,
        options.signal,
        AbortSignal.timeout(name === 'route' ? 13_000 : 5_000),
      ].filter(Boolean),
    );
    signal.throwIfAborted();
    if (!capabilities[name]) return null;
    const result = await providers[name](...args, { ...options, signal });
    signal.throwIfAborted();
    return result;
  }
  return {
    capabilities,
    signal: lifetime,
    attribution: Object.freeze({ ...providers.attribution }),
    reverseGeocode(latitude, longitude, options) {
      if (!validCoordinate([longitude, latitude])) return Promise.resolve(null);
      return invoke('reverseGeocode', [latitude, longitude], options);
    },
    async textSearch(query, point, options) {
      if (
        !String(query || '').trim() ||
        !validCoordinate([point?.longitude, point?.latitude])
      )
        return [];
      return (
        (await invoke('textSearch', [String(query).trim(), point], options)) ||
        []
      );
    },
    async nearby(point, options) {
      if (!validCoordinate([point?.longitude, point?.latitude])) return [];
      return (await invoke('nearby', [point], options)) || [];
    },
    async route(coordinates, profile = 'foot', options) {
      if (
        !Array.isArray(coordinates) ||
        coordinates.length < 2 ||
        coordinates.length > 12 ||
        !coordinates.every(validCoordinate)
      )
        return null;
      const profiles = providers.routeProfiles || ['foot', 'car', 'bike'];
      if (!profiles.includes(profile)) return null;
      const result = await invoke('route', [coordinates, profile], options);
      if (
        !result ||
        !Array.isArray(result.geometry) ||
        result.geometry.length < 2 ||
        !result.geometry.every(validCoordinate) ||
        !Number.isFinite(result.distanceM) ||
        result.distanceM < 0 ||
        !Number.isFinite(result.durationS) ||
        result.durationS < 0
      )
        return null;
      return { ...result, ok: true, profile };
    },
  };
}