Skip to content
Yet Another Geolocation Library
JavaScript Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.yardoc
doc
lib
spec
.gemtest
.gitignore
.rspec
Gemfile
HISTORY.md
LICENSE.md
README.md
Rakefile
geolocater.gemspec

README.md

Geolocater

Yet Another IP Geolocation Gem for Fun and Profit!

Installation

gem install geolocater

Usage

Pass any properly formatted IPv4 address string to a new instance of Geolocater like so.

Geolocater.geolocate_ip(IP_ADDRESS_STRING)

and get back a JSON Hash of the results

=> {"city"=>"CITY", "region_code"=>"ST", "region_name"=>"Region Name", "metrocode"=>"999", "zipcode"=>"98765", "longitude"=>"-92.23", "country_name"=>"United States", "country_code"=>"US", "ip"=>"IP_ADDRESS", "latitude"=>"27.54"}

Details

  • This library uses the free (and very good) freegeoip.net REST API.
  • Results are returned in JSON format. For friendlier Ruby object-like results (and better nil handling), pipe the result hash into a new Hashie::Mash like so:

Hashie::Mash.new(Geolocater.ip_lookup(IP_ADDRESS_STRING))

Future Features

  • Add multiple geolocation services in the event the freegeoip service goes down

How You Can Help

  • Suggest additional tests/refactoring
  • Submit a pull request

Thanks!

Something went wrong with that request. Please try again.