country-iso

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

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
country-iso
14122.0.55 years ago5 years agoMinified + gzip package size for country-iso in KB

Readme

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.