geo-reverse
v1.0.13
Published
A node.js module to find the country (and timezone) at specific gps coordinates
Downloads
2,631
Maintainers
Readme
geo-reverse
Description
A simple, local and fast module for node.js that returns in which country a geo-location (latitude, longitude) is.
Most other geo-reversing packages rely on (usually expensive) external resources such as Google. This package only uses local data, at the price of large size. This makes geo-reverse incompatible with browser use, sorry about that.
The module returns an Array of Objects:
[ { timeZone: 'time zone name',
isoAlpha2: '2-letter ISO 3166-1 code',
isoAlpha3: '3-letter ISO 3166-1 code',
name: 'country name in the language of your choice (defaulting to English)'
},
{ ... // additional results in case of uncertainty, territory dispute,
// or if location is exactly on border
}
]
Country codes and country name are set to undefined
if the location is in the ocean.
Also please note that due to the ever-changing nature of borders, it is essential to keep the package regularly updated.
Install
npm install geo-reverse
Detailed usage and examples
const geoRev = require('geo-reverse')
// usage: geoRev.country( latitude, longitude )
// country name will be in English
//
// usage: geoRev.country( latitude, longitude, locale-for-country-name )
// country name will be in the language set by locale
// locales are two-letter codes (ISO 639-1)
geoRev.country( 48.858262, 2.294513 )
// [ { timeZone: 'Europe/Paris', isoAlpha2: 'FR', isoAlpha3: 'FRA', name: 'France' } ]
geoRey.country( 48.858262, 2.294513, "zh" )
// [ { timeZone: 'Europe/Paris', isoAlpha2: 'FR', isoAlpha3: 'FRA', name: '法国' } ]
geoRev.country( 43.839319, 87.526148 )
// [ { timeZone: 'Asia/Urumqi', isoAlpha2: 'CN', isoAlpha3: 'CHN', name: 'China' },
// { timeZone: 'Asia/Shanghai', isoAlpha2: 'CN', isoAlpha3: 'CHN', name: 'China' } ]
geoRev.country(0, 0)
// [ { timeZone: 'Etc/GMT', isoAlpha2: undefined, isoAlpha3: undefined, name: undefined } ]