Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pi0/maxmind-databases
Maxmind / Geolite2 databases for node-maxmind
https://github.com/pi0/maxmind-databases
geoip geoiplite geolite2 geolite2-asn geolite2-city geolite2-country lookup maxmind node
Last synced: 2 months ago
JSON representation
Maxmind / Geolite2 databases for node-maxmind
- Host: GitHub
- URL: https://github.com/pi0/maxmind-databases
- Owner: pi0
- Created: 2018-10-30T23:25:41.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T20:21:00.000Z (about 1 year ago)
- Last Synced: 2024-10-19T19:45:53.529Z (2 months ago)
- Topics: geoip, geoiplite, geolite2, geolite2-asn, geolite2-city, geolite2-country, lookup, maxmind, node
- Language: Shell
- Size: 33.2 KB
- Stars: 6
- Watchers: 3
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Maxmind Databases
> Maxmind / Geolite2 databases for [node-maxmind](https://github.com/runk/node-maxmind)
[](https://circleci.com/gh/pi0/maxmind-databases)
**IMPORTANT:** Please read about [license changes](https://blog.maxmind.com/2019/12/18/significant-changes-to-accessing-and-using-geolite2-databases/) which are effective starting by **December 30, 2019**
## Packages
All packages will be auto updated and published every monday.
Package | Latest | Size
--------|---------|---------
[maxmind-country](https://www.npmjs.com/package/maxmind-country) | [](https://badge.fury.io/js/maxmind-country) | [](https://packagephobia.now.sh/result?p=maxmind-country)
[maxmind-asn](https://www.npmjs.com/package/maxmind-asn)| [](https://badge.fury.io/js/maxmind-asn) | [](https://packagephobia.now.sh/result?p=maxmind-asn)
[maxmind-city](https://www.npmjs.com/package/maxmind-city) | [](https://badge.fury.io/js/maxmind-city) | [](https://packagephobia.now.sh/result?p=maxmind-city)
## Usage
Require maxmind:
```js
const maxmind = require('maxmind')
```
Load either `max-city`, `max-country` or `max-asn` packages:
```js
// City Lookup
const lookupCity = maxmind.openSync(require('maxmind-city'))
const city = lookupCity.get('8.8.8.8')
// Country Lookup
const lookupCountry = maxmind.openSync(require('maxmind-country'))
const country = lookupCountry.get('8.8.8.8')
// ASN Lookup
const lookupASN = maxmind.openSync(require('maxmind-asn'))
const asn = lookupASN.get('8.8.8.8')
```
## Example results
**ASN**
```json
{
"autonomous_system_number": 15169,
"autonomous_system_organization": "Google LLC"
}
```
**Country**
```json
{
"continent": {
"code": "NA",
"geoname_id": 6255149,
"names": {
"de": "Nordamerika",
"en": "North America",
"es": "Norteamérica",
"fr": "Amérique du Nord",
"ja": "北アメリカ",
"pt-BR": "América do Norte",
"ru": "Северная Америка",
"zh-CN": "北美洲"
}
},
"country": {
"geoname_id": 6252001,
"iso_code": "US",
"names": {
"de": "USA",
"en": "United States",
"es": "Estados Unidos",
"fr": "États-Unis",
"ja": "アメリカ合衆国",
"pt-BR": "Estados Unidos",
"ru": "США",
"zh-CN": "美国"
}
},
"registered_country": {
"geoname_id": 6252001,
"iso_code": "US",
"names": {
"de": "USA",
"en": "United States",
"es": "Estados Unidos",
"fr": "États-Unis",
"ja": "アメリカ合衆国",
"pt-BR": "Estados Unidos",
"ru": "США",
"zh-CN": "美国"
}
}
}
```
**City**
**NOTE:** Latitude and longitude are not precise and should not be used to identify a particular street address or household.
```json
{
"continent": {
"code": "NA",
"geoname_id": 6255149,
"names": {
"de": "Nordamerika",
"en": "North America",
"es": "Norteamérica",
"fr": "Amérique du Nord",
"ja": "北アメリカ",
"pt-BR": "América do Norte",
"ru": "Северная Америка",
"zh-CN": "北美洲"
}
},
"country": {
"geoname_id": 6252001,
"iso_code": "US",
"names": {
"de": "USA",
"en": "United States",
"es": "Estados Unidos",
"fr": "États-Unis",
"ja": "アメリカ合衆国",
"pt-BR": "Estados Unidos",
"ru": "США",
"zh-CN": "美国"
}
},
"location": {
"accuracy_radius": 1000,
"latitude": 37.751,
"longitude": -97.822
},
"registered_country": {
"geoname_id": 6252001,
"iso_code": "US",
"names": {
"de": "USA",
"en": "United States",
"es": "Estados Unidos",
"fr": "États-Unis",
"ja": "アメリカ合衆国",
"pt-BR": "Estados Unidos",
"ru": "США",
"zh-CN": "美国"
}
}
}
```
## Development
Run `./scripts/fetch` and `./scripts/update` to fetch latest databases.
## License
This product includes GeoLite2 data created by MaxMind, available from [http://www.maxmind.com](http://www.maxmind.com)
Packages published under MIT