Geocoder Implementation using OSM Nominatim

nominatim-geocoder.ts

import fetch from "node-fetch";

interface Location {
  place_id: number;
  licence: string;
  osm_type: string;
  osm_id: number;
  boundingbox: string[];
  lat: string;
  lon: string;
  display_name: string;
  class: string;
  type: string;
  importance: number;
  icon: string;
};

const geosearch = async (q: string, limit: string = "1") => {
  const params = new URLSearchParams({
    q,
    limit,
    format: "json"
  });

  const ENDPOINT = `https://nominatim.openstreetmap.org/search?${params.toString()}`;
  const payload: Location[] = await fetch(ENDPOINT).then(res => res.json());

  if (!payload || !payload.length) {
    throw new Error(`No response for Address: ${q}`);
  }

  return payload;
};

export default geosearch;