All projects

QC2C

Quick Coordinates To Country (QC2C)

Released

Version
1.0.1
License
MIT

Offline lookup from latitude and longitude to an ISO 3166-1 alpha-3 country code. It works without an API key, a network connection or a GIS library, because the simplified world borders ship inside the package.

Gallery

Example

$ npm i qc2c
import { coordinatesToCountry } from "qc2c";
import { LatLng } from "leaflet";

const coordinates: LatLng = new LatLng(48.8566, 2.3522); // Paris

coordinatesToCountry(
  coordinates,
  {
    manifest: "https://www.levialabs.net/assets/qc2c/world_sectors.json",
    sectors: "https://www.levialabs.net/assets/qc2c",
  })
  .then((countryCode: string | null) => {
    if (countryCode) {
      console.log("Country code:", countryCode); // FR
    } else {
      console.log("No country found for these coordinates");
    }
  })
  .catch((error) => {
    console.error("Error fetching country:", error);
  });