Nit-Picking Manager

    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

    1,026

    Version

    2.0.5

    License

    MIT

    Last publish

    Collaborators

    • chq-matteo
    • simonepri