A Node.js module to query geolocation information for an IP or domain, based on database by ipip.net.
Install the module:
npm install ipip
Database is provided by ipip.net.
You can download the 17monip.dat and manually put it the library directory, or simply use npm run installdb to download it.
var ipip = require('ipip');
var ip = new ipip.IPIP();
// lookup an ip
console.log(ip.ip('202.195.161.30', 'dict'));
If you are a paid user, you can assign an alternative database file path.
var ipip = require('ipip');
var ip = new ipip.IPIP('/path/to/your/17monip.datx');
query(ip [, format])
ip
IP address that you want to query. e.g. 8.8.8.8
format
Format of the information, shoule be array or dict.
By default it will use the free version.
When set to dict you'll get an object that consists of four keys: country, province, city, organization. e.g.:
{
country: '中国',
province: '江苏',
city: '镇江',
organization: '江苏大学'
}
Otherwise, it returns an array as following format: ['country', 'province', 'city', 'organization'].
For paid users (data file should have the "datx" extension), there are more fields: ['isp', 'latitude', 'longitude', 'timezone', 'timezone2', 'governcode']
If installed globally, you can use ipip command in your shell to query IP information.
➜ ~ ipip 8.8.8.8 202.195.161.30
Information for 8.8.8.8:
country: GOOGLE
province: GOOGLE
city: N/A
organization: N/A
Information for 202.195.161.30:
country: 中国
province: 江苏
city: 镇江
organization: 江苏大学
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Use make to run unit test.
(C) Copyright 2015 ChiChou. Licensed under the MIT license.