MaxMindDB.cr

Pure Crystal MaxMind DB reader, including the GeoIP2, which doesn't require libmaxminddb.

Installation

Add this to your application's shard.yml:

dependencies:
  maxminddb:
    github: delef/maxminddb.cr

Usage

GeoIP2

require "maxminddb"

mmdb = MaxMindDB::GeoIP2.new("#{__DIR__}/../data/GeoLite2-City.mmdb")
result = mmdb.get("1.1.1.1")

result.city.geoname_id # => 2151718
result.city.name # => "Research"
result.city.name "en" # => "Research"
result.city.name "ru" # => nil
result.city.names # => {"en" => "Research"}

result.continent.code # => "OC"
result.continent.geoname_id # => 6255151
result.continent.name # => "Oceania"
result.continent.name "de" # => "Ozeanien"
result.continent.names # => {"de" => "Ozeanien", "en" => "Oceania", ...}

result.country.iso_code # => "AU"
result.country.geoname_id # => 2077456
result.country.name # => "Australia"
result.country.name "de" # => "Australien"
result.country.names # => {"de" => "Australien", "en" => "Australia", ...}

result.location.accuracy_radius # => 1000
result.location.latitude # => -37.7
result.location.longitude # => 145.1833
result.location.time_zone # => "Australia/Melbourne"

result.postal.code # => "3095"

result.registered_country.iso_code # => "AU"
result.registered_country.geoname_id # => 2077456
result.registered_country.name # => "Australia"
result.registered_country.name "de" # => "Australien"
result.registered_country.names # => {"de" => "Australien", "en" => "Australia", ...}

result.subdivisions[0].iso_code # => "VIC"
result.subdivisions[0].geoname_id # => 2145234
result.subdivisions[0].name # => "Victoria"
result.subdivisions[0].name "ru" # => "Виктория"
result.subdivisions[0].names # => {"en" => "Victoria", "pt-BR" => "Vitória", "ru" => "Виктория"}

any other MaxMind Database

require "maxminddb"

mmdb = MaxMindDB.new("#{__DIR__}/../data/GeoLite2-City.mmdb")
result = mmdb.get("1.1.1.1")

result["city"]["geoname_id"].as_i # => 2151718
result["city"]["names"]["en"].as_s # => "Research"

result["continent"]["code"].as_s # => "OC"
result["continent"]["geoname_id"].as_i # => 6255151
result["continent"]["names"]["en"].as_s # => "Oceania"

result["country"]["iso_code"].as_s # => "AU"
result["country"]["geoname_id"].as_i # => 2077456
result["country"]["names"]["en"].as_s # => "Australia"

result["location"]["accuracy_radius"].as_i # => 1000
result["location"]["latitude"].as_f # => -37.7
result["location"]["longitude"].as_f # => 145.1833
result["location"]["time_zone"].as_s # => "Australia/Melbourne"

result["postal"]["code"].as_s # => "3095"

result["registered_country"]["iso_code"].as_s # => "AU"
result["registered_country"]["geoname_id"].as_i # => 2077456
result["registered_country"]["names"]["en"].as_s # => "Australia"

result["subdivisions"][0]["iso_code"].as_s # => "VIC"
result["subdivisions"][0]["geoname_id"].as_i # => 2145234
result["subdivisions"][0]["names"]["en"].as_s # => "Victoria"

Links

• MaxMind DB file format specification http://maxmind.github.io/MaxMind-DB/
• MaxMind test/sample DB files https://github.com/maxmind/MaxMind-DB
• GeoLite2 Free Downloadable Databases http://dev.maxmind.com/geoip/geoip2/geolite2/

Contributing

1. Fork it ( https://github.com/delef/maxminddb.cr/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Contributors

• delef - creator, maintainer