country-iso

🗺 Get ISO 3166-1 alpha-3 country code for geographic coordinates.

Click on the map for a live preview.

Install

$ npm install --save country-iso

Usage

You can query any (lat,lng) pair on the earth. It also works for territorial waters and disputed countries.

const countryIso = require('country-iso');
 
// Query a point in Italy.
countryIso.get(41.9028, 12.4964);
// => ['ITA']
 
// Query a disputed country.
countryIso.get(24, -14);
// => ['ESH', 'MAR']
 
// Query a point somewhere in Atlantic Ocean.
countryIso.get(40, -40);
// => []

The package internally uses @geo-maps/countries-maritime map with 10m resolution.

The accuracy of the map has been tested with 23785 cities.

API

get(lat, lng) ⇒ Array.<string>

Searches for every country which contains the point (lat, lng).

Returns: Array.<string> - Array of ISO 3166 alpha-3 country code for the geographic coordinates.

Param	Type	Description
lat	number	The latitude of the point.
lng	number	The longitude of the point.

Authors

• Matteo Chen - chq-matteo
• Simone Primarosa - simonepri

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details.