/**
 * Adapter for OpenStreetMap Nominatim geocoding.
 *
 * Usage policy (https://operations.osmfoundation.org/policies/nominatim/):
 * max 1 request/second, descriptive User-Agent, cache results. All three
 * are enforced here — tools must never call fetch themselves.
 */
/** Shrink the request interval (tests only — never call in production code). */
export declare function setMinIntervalMs(ms: number): void;
export interface LocationCandidate {
    display_name: string;
    lat: number;
    lng: number;
    osm_type: string;
    /**
     * Relative rank derived from Nominatim's `importance` score (0–1).
     * Comparable between candidates of the same query only.
     */
    confidence: number;
}
/**
 * Geocode a free-text query, biased to Ireland. Results are cached on disk;
 * `fetchImpl` is injectable for tests.
 */
export declare function searchLocation(query: string, limit: number, fetchImpl?: typeof fetch): Promise<LocationCandidate[]>;
export declare const NOMINATIM_META: {
    readonly source: "OpenStreetMap Nominatim";
    readonly source_url: "https://nominatim.openstreetmap.org/";
    readonly licence: "ODbL 1.0 (OpenStreetMap contributors)";
    readonly data_vintage: "OpenStreetMap is continuously edited; coverage of Irish addresses varies by area";
};