geo-from-ip

Get geolocation 🌐 information about an IP 📲

Features

• No frills install 🚀
• Downloads GeoLite2 databases automatically during installation 🔋
• Run npm install to upgrade databases which means automatic updates on deployments 💎

How to use

• Include package in your project

1npm install --save geo-from-ip
2# or, if you are using yarn
3yarn add --save geo-from-ip

• Set MAXMIND_LICENSE_KEY=<your_maxmind_license_key> in your environment variables. Read more about this change on MaxMind's blog.

• Use package to get geo data from IP

1const geoip = require('geo-from-ip')
2console.log(geoip.allData('199.188.195.120'))

• And the complete response will be returned

1{
2  "code": {
3    "state": "CA",
4    "country": "US",
5    "registeredCountry": "US",
6    "continent": "NA"
7  },
8  "geonameId": {
9    "city": 5391959,
10    "state": 5332921,
11    "country": 6252001,
12    "registeredCountry": 6252001,
13    "continent": 6255149
14  },
15  "city": "San Francisco",
16  "state": "California",
17  "country": "United States",
18  "registeredCountry": "United States",
19  "continent": "North America",
20  "postal": "94107",
21  "location": {
22    "accuracy_radius": 5,
23    "latitude": 37.7642,
24    "longitude": -122.3993,
25    "metro_code": 807,
26    "time_zone": "America/Los_Angeles"
27  }
28}

• Update database

Database will get automatically updated every time deployment happens. But if you would like to force an update, just run:

1npm install
2# or, if you are using yarn
3yarn

Remember that you will need to have MAXMIND_LICENSE_KEY set in your environment variables.

Debugging / Developing

Run your code using geo-from-ip as debug flag. Look into pacakge.json for example.

Credits

Database: Max-Mind

This product includes GeoLite2 data created by MaxMind, available from https://www.maxmind.com