News
Now with node >= 0.11 support
Requirements
This package is currently designed to build and run only on *nix (tested only on Linux). It should be technically possible to adapt it for Windows as well. The package includes and builds the libmaxminddb library from source. To to so, it needs the autotools toolchain. More specificly - autoconf, libtool, automake. Also, it needs node-gyp installed: npm install -g node-gyp
Usage
var geo = require('mmgeodb');
geo.load('path/to/database/file');
var info = geo.lookupIp('1.2.3.4');
console.log(JSON.stringify(info));
// {"ccode":"AU","continent":"OC"}
info = geo.lookupIp('2001:1388:b47:df34:5ddf:cecb:4213:cf37');
console.log(JSON.stringify(info));
// {"ccode":"PE","continent":"SA"}
Currently the returned object contains only two properties:
ccode: The 2-letter country code
continent: The continent code where the country is located.
This is a two-letter code, as follows:
AF – Africa
AS – Asia
EU – Europe
NA – North America
OC – Oceania
SA – South America
When done with the database, call
geo.unload()
to free memory.
Notes on libmaxminddb
Libmaxminddb is built by this package as a static lib, and linked into the node module shared object (.node file). This means that you can't update the version used without rebuilding the module.
The version of libmaxminddb, included with this package has a slightly modified build system. It doesn't build the 't' subdirectory, containing tests, because it has a dependency on libtap. Also, it adds the -fPIC flag (in common.mk) because the generated code, even though of a static lib, is later linked into a shared object, so the code must be position-independent.