simonepri/country-iso

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

country-iso

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

Click on the map to see a live preview.

Synopsis

Given the latitude and longitude coordinates this package returns the country code of the country in which the coordinates fall into.

The package internally uses @geo-maps/countries-maritime map with 10m resolution to give you the right country code. The accuracy of the map has been tested with 23785 cities but the demo allows you to actually test it manually by just clicking on the map to see what it returns.

Do you believe that this is useful? If so, support us with a ⭐️!

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);
// => []

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.

Related

• is-sea: 🌊 Check whether a geographic coordinate is in the sea or not on the earth.

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.

country-iso's Issues

Provide iso alpha 2 as well

Sources:

• https://github.com/moimikey/iso3166-1/blob/master/data/countries.json
• https://github.com/pde-rent/country_denomination/blob/master/country_denomination.json

Test.js

• replace mkdirSync with ensureFolder (fs-extra package)
• ./test/out' shold be in a variable
• replace writeFileSync with writeJson (fs-extra)
• console.log with test.log
• rename failed-get-country to failed.geo.json
• rename out folder to report
• rename bad var to failed
• fix wrong file path in log message

extent for cities?

This looks very nice! Will try it in a project soon!

I was wondering: how difficult is it to extent this for cities? So results will be land & city (if any)?

Bir Tawil disputed area 21°52′9″N 33°44′52″E

Bir Tawil disputed area

Wiki - Bir Tawil

Currently Returns nothing should return "Terra Nullius"

Demo shows invalid coordinates if you keep rotating the map for a while.

Index.js

• Rename package from get-country to country-codes
• Rename getCountryCodes to get
• Change get external interface to get(lat, lng)
• Remove worldGeojson initialization
• Improve JSDoc for get
• Improve JSDoc for use
• Add license file for cities.json
• Remove cities.json license notice from readme
• Add API section to readme
• Add usage section to readme
• Add author section to readme
• Add yourself as author
• Remove utils and tools from .npmignore
• add renane test.js to test in .npmignore (file to folder)