Learn about our RFC process, Open RFC meetings & more.Join in the discussion! »

country-iso

2.0.5 • Public • Published

country-iso

Travis CI Codecov npm npm version npm dependencies npm dev dependencies

🗺 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

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.

Install

npm i country-iso

DownloadsWeekly Downloads

866

Version

2.0.5

License

MIT

Last publish

Collaborators

  • avatar
  • avatar