@procedures/geo 0.2.3 → 0.4.0

package/dist/distance.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The great-circle distance between two points: the haversine formula on a sphere with the mean
+ * radius of the Earth. It uses no network.
+ */
+import type { Point } from "./geo.js";
+/** The mean radius of the Earth, in kilometres (IUGG). */
+export declare const EARTH_RADIUS_KM = 6371;
+/**
+ * This function gives the great-circle distance between two points, in kilometres, without
+ * rounding. The formula is the haversine formula on a sphere of `EARTH_RADIUS_KM`. The road
+ * distance is longer.
+ */
+export declare const greatCircleKm: (a: Point, b: Point) => number;
+//# sourceMappingURL=distance.d.ts.map

package/dist/distance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance.d.ts","sourceRoot":"","sources":["../src/distance.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,0DAA0D;AAC1D,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,aAAa,MAAO,KAAK,KAAK,KAAK,KAAG,MAOlD,CAAC"}

package/dist/distance.js

@@ -0,0 +1,20 @@
+/**
+ * The great-circle distance between two points: the haversine formula on a sphere with the mean
+ * radius of the Earth. It uses no network.
+ */
+/** The mean radius of the Earth, in kilometres (IUGG). */
+export const EARTH_RADIUS_KM = 6371;
+/**
+ * This function gives the great-circle distance between two points, in kilometres, without
+ * rounding. The formula is the haversine formula on a sphere of `EARTH_RADIUS_KM`. The road
+ * distance is longer.
+ */
+export const greatCircleKm = (a, b) => {
+    const toRad = (deg) => (deg * Math.PI) / 180;
+    const dLat = toRad(b.lat - a.lat);
+    const dLon = toRad(b.lon - a.lon);
+    const h = Math.sin(dLat / 2) ** 2 + Math.cos(toRad(a.lat)) * Math.cos(toRad(b.lat)) * Math.sin(dLon / 2) ** 2;
+    // For two antipodal points, a rounding error can make h a little more than 1, and asin of that is NaN
+    return 2 * EARTH_RADIUS_KM * Math.asin(Math.min(1, Math.sqrt(h)));
+};
+//# sourceMappingURL=distance.js.map

package/dist/distance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance.js","sourceRoot":"","sources":["../src/distance.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAQ,EAAE,CAAQ,EAAU,EAAE;IAC1D,MAAM,KAAK,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9G,sGAAsG;IACtG,OAAO,CAAC,GAAG,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC,CAAC"}

package/dist/geo.d.ts

@@ -18,11 +18,24 @@ export interface RouteResult {
 export declare const NOMINATIM_URL = "https://nominatim.openstreetmap.org";
 /** The public OSRM demonstration server. It has a fair-use limit. A self-hosted OSRM has the same API. */
 export declare const OSRM_URL = "https://router.project-osrm.org";
+/**
+ * The part of `fetch` that this package uses. A host or a test can give its own function, for
+ * example a fetch with a cache or a recorder. The default is the global `fetch`.
+ */
+export type FetchJson = (url: string, init: {
+    headers: Record<string, string>;
+    signal: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+}>;
 /** This function gets a JSON document, with a time limit and the signal of the call. */
 export declare function getJson(url: string, options: {
     timeoutMs: number;
     signal?: AbortSignal | undefined;
     headers?: Record<string, string>;
+    fetch?: FetchJson | undefined;
 }, service: string): Promise<unknown>;
 /**
  * This function gives the coordinates of an address or a place name, or undefined when Nominatim
@@ -34,11 +47,13 @@ export declare function geocode(query: string, options: {
     baseUrl?: string | undefined;
     timeoutMs: number;
     signal?: AbortSignal | undefined;
+    fetch?: FetchJson | undefined;
 }): Promise<GeocodeResult | undefined>;
 /** This function gives the time and the distance of a drive from one point to another. */
 export declare function drivingRoute(from: Point, to: Point, options: {
     baseUrl?: string | undefined;
     timeoutMs: number;
     signal?: AbortSignal | undefined;
+    fetch?: FetchJson | undefined;
 }): Promise<RouteResult>;
 //# sourceMappingURL=geo.d.ts.map

package/dist/geo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geo.d.ts","sourceRoot":"","sources":["../src/geo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sCAAsC;AACtC,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,6HAA6H;AAC7H,eAAO,MAAM,aAAa,wCAAwC,CAAC;AAEnE,0GAA0G;AAC1G,eAAO,MAAM,QAAQ,oCAAoC,CAAC;AAE1D,wFAAwF;AACxF,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EAClG,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClC,GACA,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAapC;AAED,0FAA0F;AAC1F,wBAAsB,YAAY,CAChC,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,KAAK,EACT,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,GAC7F,OAAO,CAAC,WAAW,CAAC,CActB"}
+{"version":3,"file":"geo.d.ts","sourceRoot":"","sources":["../src/geo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sCAAsC;AACtC,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,6HAA6H;AAC7H,eAAO,MAAM,aAAa,wCAAwC,CAAC;AAEnE,0GAA0G;AAC1G,eAAO,MAAM,QAAQ,oCAAoC,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,KAC3D,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AAExE,wFAAwF;AACxF,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B,EACD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B,GACA,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAapC;AAED,0FAA0F;AAC1F,wBAAsB,YAAY,CAChC,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,KAAK,EACT,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,GAC5H,OAAO,CAAC,WAAW,CAAC,CActB"}

package/dist/geo.js

@@ -9,13 +9,14 @@ export const OSRM_URL = "https://router.project-osrm.org";
 /** This function gets a JSON document, with a time limit and the signal of the call. */
 export async function getJson(url, options, service) {
     const signals = [AbortSignal.timeout(options.timeoutMs), ...(options.signal ? [options.signal] : [])];
+    const fetchJson = options.fetch ?? fetch;
     let response;
     try {
-        response = await fetch(url, { signal: AbortSignal.any(signals), headers: { accept: "application/json", ...options.headers } });
+        response = await fetchJson(url, { signal: AbortSignal.any(signals), headers: { accept: "application/json", ...options.headers } });
     }
     catch (error) {
         const reason = error.name === "TimeoutError" ? `no answer in ${options.timeoutMs} ms` : "the request failed";
-        throw new Error(`${service} did not answer: ${reason}`);
+        throw new Error(`${service} did not answer: ${reason}`, { cause: error });
     }
     if (!response.ok)
         throw new Error(`${service} gave HTTP ${response.status}`);
@@ -29,7 +30,7 @@ export async function geocode(query, options) {
     const params = new URLSearchParams({ format: "jsonv2", limit: "1", q: query });
     if (options.countryCodes !== undefined)
         params.set("countrycodes", options.countryCodes);
-    const rows = (await getJson(`${options.baseUrl ?? NOMINATIM_URL}/search?${params.toString()}`, { timeoutMs: options.timeoutMs, signal: options.signal, headers: { "user-agent": options.userAgent } }, "Nominatim"));
+    const rows = (await getJson(`${options.baseUrl ?? NOMINATIM_URL}/search?${params.toString()}`, { timeoutMs: options.timeoutMs, signal: options.signal, headers: { "user-agent": options.userAgent }, fetch: options.fetch }, "Nominatim"));
     const first = Array.isArray(rows) ? rows[0] : undefined;
     const lat = Number(first?.lat);
     const lon = Number(first?.lon);
@@ -39,7 +40,7 @@ export async function geocode(query, options) {
 }
 /** This function gives the time and the distance of a drive from one point to another. */
 export async function drivingRoute(from, to, options) {
-    const body = (await getJson(`${options.baseUrl ?? OSRM_URL}/route/v1/driving/${from.lon},${from.lat};${to.lon},${to.lat}?overview=false`, { timeoutMs: options.timeoutMs, signal: options.signal }, "OSRM"));
+    const body = (await getJson(`${options.baseUrl ?? OSRM_URL}/route/v1/driving/${from.lon},${from.lat};${to.lon},${to.lat}?overview=false`, { timeoutMs: options.timeoutMs, signal: options.signal, fetch: options.fetch }, "OSRM"));
     const route = body.routes?.[0];
     if (body.code !== "Ok" || route?.duration === undefined || route.distance === undefined) {
         throw new Error(`OSRM found no route (${body.code ?? "no code"})`);

package/dist/geo.js.map

@@ -1 +1 @@
-{"version":3,"file":"geo.js","sourceRoot":"","sources":["../src/geo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"geo.js","sourceRoot":"","sources":["../src/geo.ts"],"names":[],"mappings":"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"}

package/dist/geohash.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The geohash of a point, and the cell of a geohash. A geohash interleaves the bits of the
+ * longitude and the latitude, and writes five bits as one character of a base-32 alphabet.
+ */
+import type { Point } from "./geo.js";
+/** The base-32 alphabet of the geohash. It has no `a`, `i`, `l` or `o`. */
+export declare const GEOHASH_ALPHABET = "0123456789bcdefghjkmnpqrstuvwxyz";
+/** The precision (number of characters) when the caller gives none. At the equator, a cell of 7 characters is approximately 153 m by 153 m. */
+export declare const DEFAULT_GEOHASH_PRECISION = 7;
+/** The maximum precision. A cell of 12 characters is smaller than 4 cm by 4 cm. */
+export declare const MAX_GEOHASH_PRECISION = 12;
+/** The cell of a geohash: its edges, in degrees, and its center. */
+export interface GeohashCell {
+    readonly south: number;
+    readonly west: number;
+    readonly north: number;
+    readonly east: number;
+    readonly center: Point;
+}
+/**
+ * This function gives the geohash of a point. The first bit is the longitude. A coordinate on
+ * the middle of a range goes to the upper half.
+ */
+export declare const geohash: (point: Point, precision?: number) => string;
+/**
+ * This function gives the cell of a geohash: its edges and its center. Upper case letters are
+ * correct. It throws a `RangeError` for a character that is not in the alphabet.
+ */
+export declare const decodeGeohash: (hash: string) => GeohashCell;
+//# sourceMappingURL=geohash.d.ts.map

package/dist/geohash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geohash.d.ts","sourceRoot":"","sources":["../src/geohash.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,qCAAqC,CAAC;AAEnE,+IAA+I;AAC/I,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;CACxB;AAOD;;;GAGG;AACH,eAAO,MAAM,OAAO,UAAW,KAAK,cAAa,MAAM,KAA+B,MA+BrF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,SAAU,MAAM,KAAG,WAyB5C,CAAC"}

package/dist/geohash.js

@@ -0,0 +1,87 @@
+/**
+ * The geohash of a point, and the cell of a geohash. A geohash interleaves the bits of the
+ * longitude and the latitude, and writes five bits as one character of a base-32 alphabet.
+ */
+/** The base-32 alphabet of the geohash. It has no `a`, `i`, `l` or `o`. */
+export const GEOHASH_ALPHABET = "0123456789bcdefghjkmnpqrstuvwxyz";
+/** The precision (number of characters) when the caller gives none. At the equator, a cell of 7 characters is approximately 153 m by 153 m. */
+export const DEFAULT_GEOHASH_PRECISION = 7;
+/** The maximum precision. A cell of 12 characters is smaller than 4 cm by 4 cm. */
+export const MAX_GEOHASH_PRECISION = 12;
+const checkPoint = (point) => {
+    if (!Number.isFinite(point.lat) || point.lat < -90 || point.lat > 90)
+        throw new RangeError(`The latitude ${point.lat} is not from -90 to 90`);
+    if (!Number.isFinite(point.lon) || point.lon < -180 || point.lon > 180)
+        throw new RangeError(`The longitude ${point.lon} is not from -180 to 180`);
+};
+/**
+ * This function gives the geohash of a point. The first bit is the longitude. A coordinate on
+ * the middle of a range goes to the upper half.
+ */
+export const geohash = (point, precision = DEFAULT_GEOHASH_PRECISION) => {
+    checkPoint(point);
+    if (!Number.isInteger(precision) || precision < 1 || precision > MAX_GEOHASH_PRECISION) {
+        throw new RangeError(`The precision ${precision} is not an integer from 1 to ${MAX_GEOHASH_PRECISION}`);
+    }
+    const latRange = [-90, 90];
+    const lonRange = [-180, 180];
+    let hash = "";
+    let bits = 0;
+    let value = 0;
+    let evenBit = true;
+    while (hash.length < precision) {
+        const range = evenBit ? lonRange : latRange;
+        const coordinate = evenBit ? point.lon : point.lat;
+        const mid = (range[0] + range[1]) / 2;
+        if (coordinate >= mid) {
+            value = (value << 1) | 1;
+            range[0] = mid;
+        }
+        else {
+            value <<= 1;
+            range[1] = mid;
+        }
+        evenBit = !evenBit;
+        bits += 1;
+        if (bits === 5) {
+            hash += GEOHASH_ALPHABET[value];
+            bits = 0;
+            value = 0;
+        }
+    }
+    return hash;
+};
+/**
+ * This function gives the cell of a geohash: its edges and its center. Upper case letters are
+ * correct. It throws a `RangeError` for a character that is not in the alphabet.
+ */
+export const decodeGeohash = (hash) => {
+    if (hash.length === 0 || hash.length > MAX_GEOHASH_PRECISION) {
+        throw new RangeError(`A geohash has 1 to ${MAX_GEOHASH_PRECISION} characters`);
+    }
+    const lat = [-90, 90];
+    const lon = [-180, 180];
+    let evenBit = true;
+    for (const char of hash.toLowerCase()) {
+        const value = GEOHASH_ALPHABET.indexOf(char);
+        if (value === -1)
+            throw new RangeError(`"${char}" is not a character of a geohash`);
+        for (let bit = 4; bit >= 0; bit -= 1) {
+            const range = evenBit ? lon : lat;
+            const mid = (range[0] + range[1]) / 2;
+            if ((value >> bit) & 1)
+                range[0] = mid;
+            else
+                range[1] = mid;
+            evenBit = !evenBit;
+        }
+    }
+    return {
+        south: lat[0],
+        west: lon[0],
+        north: lat[1],
+        east: lon[1],
+        center: { lat: (lat[0] + lat[1]) / 2, lon: (lon[0] + lon[1]) / 2 },
+    };
+};
+//# sourceMappingURL=geohash.js.map

package/dist/geohash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geohash.js","sourceRoot":"","sources":["../src/geohash.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 export * from "./module.js";
 export * from "./procedures.js";
 export * from "./geo.js";
+export * from "./distance.js";
+export * from "./geohash.js";
+export * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -2,4 +2,7 @@
 export * from "./module.js";
 export * from "./procedures.js";
 export * from "./geo.js";
+export * from "./distance.js";
+export * from "./geohash.js";
+export * from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/procedures/geo/distance.d.ts

@@ -0,0 +1,12 @@
+/**
+ * geo.distance procedure
+ *
+ * Give the great-circle distance between two points
+ */
+import type { GeoDistanceInput, GeoDistanceOutput } from "../../types.js";
+/**
+ * This function gives the great-circle distance between two points, in kilometres. It changes
+ * nothing.
+ */
+export declare function geoDistance(input: GeoDistanceInput): Promise<GeoDistanceOutput>;
+//# sourceMappingURL=distance.d.ts.map

package/dist/procedures/geo/distance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance.d.ts","sourceRoot":"","sources":["../../../src/procedures/geo/distance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE1E;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAErF"}

package/dist/procedures/geo/distance.js

@@ -0,0 +1,14 @@
+/**
+ * geo.distance procedure
+ *
+ * Give the great-circle distance between two points
+ */
+import { greatCircleKm } from "../../distance.js";
+/**
+ * This function gives the great-circle distance between two points, in kilometres. It changes
+ * nothing.
+ */
+export async function geoDistance(input) {
+    return { km: greatCircleKm(input.from, input.to) };
+}
+//# sourceMappingURL=distance.js.map

package/dist/procedures/geo/distance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance.js","sourceRoot":"","sources":["../../../src/procedures/geo/distance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAuB;IACvD,OAAO,EAAE,EAAE,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AACrD,CAAC"}

package/dist/procedures/geo/geohash.d.ts

@@ -0,0 +1,11 @@
+/**
+ * geo.geohash procedure
+ *
+ * Give the geohash of a point
+ */
+import type { GeoGeohashInput, GeoGeohashOutput } from "../../types.js";
+/**
+ * This function gives the geohash of a point and the cell of that geohash. It changes nothing.
+ */
+export declare function geoGeohash(input: GeoGeohashInput): Promise<GeoGeohashOutput>;
+//# sourceMappingURL=geohash.d.ts.map

package/dist/procedures/geo/geohash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geohash.d.ts","sourceRoot":"","sources":["../../../src/procedures/geo/geohash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExE;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGlF"}

package/dist/procedures/geo/geohash.js

@@ -0,0 +1,14 @@
+/**
+ * geo.geohash procedure
+ *
+ * Give the geohash of a point
+ */
+import { decodeGeohash, geohash } from "../../geohash.js";
+/**
+ * This function gives the geohash of a point and the cell of that geohash. It changes nothing.
+ */
+export async function geoGeohash(input) {
+    const hash = geohash(input.point, input.precision);
+    return { hash, cell: decodeGeohash(hash) };
+}
+//# sourceMappingURL=geohash.js.map

package/dist/procedures/geo/geohash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geohash.js","sourceRoot":"","sources":["../../../src/procedures/geo/geohash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsB;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACnD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;AAC7C,CAAC"}

package/dist/procedures/geo/index.d.ts

@@ -0,0 +1,3 @@
+export { geoDistance } from "./distance.js";
+export { geoGeohash } from "./geohash.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/procedures/geo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/procedures/geo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/procedures/geo/index.js

@@ -0,0 +1,3 @@
+export { geoDistance } from "./distance.js";
+export { geoGeohash } from "./geohash.js";
+//# sourceMappingURL=index.js.map

package/dist/procedures/geo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/procedures/geo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/procedures.d.ts

@@ -1,8 +1,10 @@
 /**
- * The procedures of `@procedures/geo`: `geo.geocode` and `geo.route`.
+ * The procedures of `@procedures/geo`: `geo.geocode`, `geo.route`, `geo.distance` and `geo.geohash`.
  */
 import { type AnyProcedure } from "@procedures/client";
 export declare const geoGeocodeProcedure: AnyProcedure;
 export declare const geoRouteProcedure: AnyProcedure;
+export declare const geoDistanceProcedure: AnyProcedure;
+export declare const geoGeohashProcedure: AnyProcedure;
 export declare const geoProcedures: AnyProcedure[];
 //# sourceMappingURL=procedures.d.ts.map

package/dist/procedures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../src/procedures.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAA+B,KAAK,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AAiC3G,eAAO,MAAM,mBAAmB,EAAE,YAcR,CAAC;AAe3B,eAAO,MAAM,iBAAiB,EAAE,YAaN,CAAC;AAE3B,eAAO,MAAM,aAAa,EAAE,YAAY,EAA6C,CAAC"}
+{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../src/procedures.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAA+B,KAAK,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AA8C3G,eAAO,MAAM,mBAAmB,EAAE,YAcR,CAAC;AAe3B,eAAO,MAAM,iBAAiB,EAAE,YAaN,CAAC;AAM3B,eAAO,MAAM,oBAAoB,EAAE,YAUT,CAAC;AAM3B,eAAO,MAAM,mBAAmB,EAAE,YAUR,CAAC;AAE3B,eAAO,MAAM,aAAa,EAAE,YAAY,EAAwF,CAAC"}

package/dist/procedures.js

@@ -1,10 +1,14 @@
 /**
- * The procedures of `@procedures/geo`: `geo.geocode` and `geo.route`.
+ * The procedures of `@procedures/geo`: `geo.geocode`, `geo.route`, `geo.distance` and `geo.geohash`.
  */
 import { createProcedure, zodAdapter } from "@procedures/client";
 import { z } from "zod";
 import { drivingRoute, geocode } from "./geo.js";
+import { geoDistance } from "./procedures/geo/distance.js";
+import { geoGeohash } from "./procedures/geo/geohash.js";
+import { GeoDistanceInputSchema, GeoDistanceOutputSchema, GeoGeohashInputSchema, GeoGeohashOutputSchema, } from "./types.js";
 const NETWORK_READ = { reads: ["network"], writes: [] };
+const PURE = { reads: [], writes: [] };
 const point = z.object({ lat: z.number().min(-90).max(90), lon: z.number().min(-180).max(180) });
 const timeoutMs = z.number().int().positive().max(120_000).default(20_000).describe("The time limit, in milliseconds (default: 20000)");
 // =============================================================================
@@ -60,5 +64,33 @@ export const geoRouteProcedure = createProcedure()
 })
     .handler(async (input, ctx) => drivingRoute(input.from, input.to, { baseUrl: input.baseUrl, timeoutMs: input.timeoutMs, signal: ctx?.signal }))
     .build();
-export const geoProcedures = [geoGeocodeProcedure, geoRouteProcedure];
+// =============================================================================
+// geo.distance
+// =============================================================================
+export const geoDistanceProcedure = createProcedure()
+    .path(["geo", "distance"])
+    .input(zodAdapter(GeoDistanceInputSchema))
+    .output(zodAdapter(GeoDistanceOutputSchema))
+    .meta({
+    description: "Give the great-circle distance between two points in kilometres (haversine), without the network",
+    output: "json",
+    effects: PURE,
+})
+    .handler(async (input) => geoDistance(input))
+    .build();
+// =============================================================================
+// geo.geohash
+// =============================================================================
+export const geoGeohashProcedure = createProcedure()
+    .path(["geo", "geohash"])
+    .input(zodAdapter(GeoGeohashInputSchema))
+    .output(zodAdapter(GeoGeohashOutputSchema))
+    .meta({
+    description: "Give the geohash of a point and the cell of that geohash, without the network",
+    output: "json",
+    effects: PURE,
+})
+    .handler(async (input) => geoGeohash(input))
+    .build();
+export const geoProcedures = [geoGeocodeProcedure, geoRouteProcedure, geoDistanceProcedure, geoGeohashProcedure];
 //# sourceMappingURL=procedures.js.map

package/dist/procedures.js.map

@@ -1 +1 @@
-{"version":3,"file":"procedures.js","sourceRoot":"","sources":["../src/procedures.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"procedures.js","sourceRoot":"","sources":["../src/procedures.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Type definitions of the procedures of this package
+ */
+import { z } from "zod";
+import type { Point } from "./geo.js";
+import type { GeohashCell } from "./geohash.js";
+/** The input of `geo.distance`: two points. */
+export interface GeoDistanceInput {
+    from: Point;
+    to: Point;
+}
+/** The output of `geo.distance`: the great-circle distance in kilometres, without rounding. */
+export interface GeoDistanceOutput {
+    km: number;
+}
+export declare const GeoDistanceInputSchema: z.ZodType<GeoDistanceInput>;
+export declare const GeoDistanceOutputSchema: z.ZodType<GeoDistanceOutput>;
+/** The input of `geo.geohash`: a point and the number of characters. */
+export interface GeoGeohashInput {
+    point: Point;
+    precision: number;
+}
+/** The output of `geo.geohash`: the geohash and its cell. */
+export interface GeoGeohashOutput {
+    hash: string;
+    cell: GeohashCell;
+}
+export declare const GeoGeohashInputSchema: z.ZodType<GeoGeohashInput, {
+    point: Point;
+    precision?: number | undefined;
+}>;
+export declare const GeoGeohashOutputSchema: z.ZodType<GeoGeohashOutput>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,KAAK,CAAC;CACX;AAED,+FAA+F;AAC/F,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAG7D,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAE/D,CAAC;AAMH,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAG7G,CAAC;AAEH,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAW7D,CAAC"}

package/dist/types.js

@@ -0,0 +1,29 @@
+/**
+ * Type definitions of the procedures of this package
+ */
+import { z } from "zod";
+const point = z.object({ lat: z.number().min(-90).max(90), lon: z.number().min(-180).max(180) });
+export const GeoDistanceInputSchema = z.object({
+    from: point.describe("The first point (degrees)"),
+    to: point.describe("The second point (degrees)"),
+});
+export const GeoDistanceOutputSchema = z.object({
+    km: z.number().describe("The great-circle distance in kilometres (haversine, Earth radius 6371 km), without rounding"),
+});
+export const GeoGeohashInputSchema = z.object({
+    point: point.describe("The point (degrees)"),
+    precision: z.number().int().min(1).max(12).default(7).describe("The number of characters, from 1 to 12 (default: 7)"),
+});
+export const GeoGeohashOutputSchema = z.object({
+    hash: z.string().describe("The geohash"),
+    cell: z
+        .object({
+        south: z.number(),
+        west: z.number(),
+        north: z.number(),
+        east: z.number(),
+        center: z.object({ lat: z.number(), lon: z.number() }),
+    })
+        .describe("The cell of the geohash: its edges and its center (degrees)"),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAiBjG,MAAM,CAAC,MAAM,sBAAsB,GAAgC,CAAC,CAAC,MAAM,CAAC;IAC1E,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACjD,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAiC,CAAC,CAAC,MAAM,CAAC;IAC5E,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6FAA6F,CAAC;CACvH,CAAC,CAAC;AAkBH,MAAM,CAAC,MAAM,qBAAqB,GAAiF,CAAC,CAAC,MAAM,CAAC;IAC1H,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qDAAqD,CAAC;CACtH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAgC,CAAC,CAAC,MAAM,CAAC;IAC1E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACxC,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;KACvD,CAAC;SACD,QAAQ,CAAC,6DAA6D,CAAC;CAC3E,CAAC,CAAC"}

package/package.json

@@ -1,14 +1,16 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/geo",
-  "version": "0.2.3",
-  "description": "Map procedures: the coordinates of an address (OpenStreetMap Nominatim) and the time and distance of a drive (OSRM).",
+  "version": "0.4.0",
+  "description": "Map procedures: the coordinates of an address (OpenStreetMap Nominatim), the time and distance of a drive (OSRM), the great-circle distance and the geohash.",
   "keywords": [
     "geocode",
     "nominatim",
     "openstreetmap",
     "osrm",
     "routing",
+    "haversine",
+    "geohash",
     "procedures"
   ],
   "homepage": "https://mark1russell7.github.io/client/",
@@ -58,7 +60,7 @@
     "provenance": true
   },
   "dependencies": {
-    "@procedures/client": "0.2.3",
+    "@procedures/client": "0.4.0",
     "zod": "^4.6.5"
   },
   "devDependencies": {

package/src/distance.ts

@@ -0,0 +1,23 @@
+/**
+ * The great-circle distance between two points: the haversine formula on a sphere with the mean
+ * radius of the Earth. It uses no network.
+ */
+
+import type { Point } from "./geo.js";
+
+/** The mean radius of the Earth, in kilometres (IUGG). */
+export const EARTH_RADIUS_KM = 6371;
+
+/**
+ * This function gives the great-circle distance between two points, in kilometres, without
+ * rounding. The formula is the haversine formula on a sphere of `EARTH_RADIUS_KM`. The road
+ * distance is longer.
+ */
+export const greatCircleKm = (a: Point, b: Point): number => {
+  const toRad = (deg: number): number => (deg * Math.PI) / 180;
+  const dLat = toRad(b.lat - a.lat);
+  const dLon = toRad(b.lon - a.lon);
+  const h = Math.sin(dLat / 2) ** 2 + Math.cos(toRad(a.lat)) * Math.cos(toRad(b.lat)) * Math.sin(dLon / 2) ** 2;
+  // For two antipodal points, a rounding error can make h a little more than 1, and asin of that is NaN
+  return 2 * EARTH_RADIUS_KM * Math.asin(Math.min(1, Math.sqrt(h)));
+};