mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 08:12:24 +00:00
121 lines
3.9 KiB
JavaScript
121 lines
3.9 KiB
JavaScript
import {
|
|
nominatimToGeocodeResult,
|
|
nominatimViewboxFromBounds,
|
|
} from '../nominatimGeocode.js';
|
|
import { validCoordinate } from '../search/geospatial.js';
|
|
import { normalizeRegionalPlace } from '../data/regionalModel.js';
|
|
import { readResponseJsonCapped } from './httpBody.js';
|
|
|
|
/** Retain the established framing/type rules for JSON and JSONv2 results. */
|
|
export function normalizeNominatimResult(hit) {
|
|
return nominatimToGeocodeResult(
|
|
hit && { ...hit, class: hit.class || hit.category },
|
|
);
|
|
}
|
|
|
|
export function normalizeNominatimReverse(hit) {
|
|
const result = normalizeNominatimResult(hit);
|
|
const region = normalizeRegionalPlace(hit);
|
|
if (!result || !region) return null;
|
|
const clean = (value) =>
|
|
String(value || '')
|
|
.replace(/[\x00-\x1f\x7f]/g, ' ')
|
|
.replace(/\s+/g, ' ')
|
|
.trim()
|
|
.slice(0, 120);
|
|
const street = clean(hit.address?.road || hit.address?.pedestrian);
|
|
return {
|
|
formattedAddress: result.formatted_address,
|
|
locality: region.locality,
|
|
region: region.region,
|
|
country: region.country,
|
|
types: result.types,
|
|
labels: [clean(result.formatted_address)].filter(Boolean),
|
|
streetLabels: street ? [street] : [],
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Nominatim JSONv2 transport for explicitly configured endpoints. Callers own
|
|
* scheduling and request headers; this does not select a public instance.
|
|
*/
|
|
export function createNominatimClient({
|
|
searchEndpoint,
|
|
reverseEndpoint,
|
|
fetchImpl = (...args) => fetch(...args),
|
|
} = {}) {
|
|
for (const endpoint of [searchEndpoint, reverseEndpoint]) {
|
|
if (endpoint == null) continue;
|
|
if (typeof endpoint !== 'string' || !endpoint || /[?#]/.test(endpoint))
|
|
throw new TypeError('A query-free Nominatim endpoint is required');
|
|
const url = new URL(endpoint, 'http://localhost');
|
|
if (
|
|
!['http:', 'https:'].includes(url.protocol) ||
|
|
url.username ||
|
|
url.password ||
|
|
!(
|
|
(endpoint.startsWith('/') && !endpoint.startsWith('//')) ||
|
|
/^https?:\/\//.test(endpoint)
|
|
)
|
|
)
|
|
throw new TypeError('Invalid Nominatim endpoint');
|
|
}
|
|
async function request(endpoint, params, signal) {
|
|
signal?.throwIfAborted();
|
|
const response = await fetchImpl(
|
|
`${endpoint}?${new URLSearchParams({
|
|
format: 'jsonv2',
|
|
addressdetails: '1',
|
|
...params,
|
|
})}`,
|
|
{ signal, redirect: 'error' },
|
|
);
|
|
signal?.throwIfAborted();
|
|
if (!response.ok) {
|
|
await response.body?.cancel?.().catch(() => {});
|
|
throw new Error('Geocoding service unavailable');
|
|
}
|
|
return readResponseJsonCapped(response, 512 * 1024, signal);
|
|
}
|
|
return {
|
|
...(searchEndpoint
|
|
? {
|
|
async search(query, { bias, signal } = {}) {
|
|
const viewbox = nominatimViewboxFromBounds(bias);
|
|
const rows = await request(
|
|
searchEndpoint,
|
|
{
|
|
q: query,
|
|
limit: '1',
|
|
...(viewbox ? { viewbox, bounded: '0' } : {}),
|
|
},
|
|
signal,
|
|
);
|
|
if (!Array.isArray(rows))
|
|
throw new Error('Invalid geocoding response');
|
|
if (rows.length && !normalizeNominatimResult(rows[0]))
|
|
throw new Error('Invalid geocoding result');
|
|
return rows;
|
|
},
|
|
}
|
|
: {}),
|
|
...(reverseEndpoint
|
|
? {
|
|
async reverse(latitude, longitude, { signal } = {}) {
|
|
if (!validCoordinate([longitude, latitude])) return null;
|
|
const row = await request(
|
|
reverseEndpoint,
|
|
{ lat: latitude, lon: longitude },
|
|
signal,
|
|
);
|
|
// A successful, explicit no-result response is distinct from malformed data.
|
|
if (row?.error === 'Unable to geocode') return null;
|
|
if (!normalizeNominatimReverse(row))
|
|
throw new Error('Invalid reverse geocoding result');
|
|
return row;
|
|
},
|
|
}
|
|
: {}),
|
|
};
|
|
}
|