henrywalters / av-ip

A lightweight Ruby wrapper for quick and easy ip geolocation

#AVIP

Summary

AVIP is a lightweight ruby gem for geolocation of ip addresses. The gem is a wrapper built around ipinfo.io. Everything is native ruby and requires no non-standard ruby gems.

Installation

Fairly standard stuff

gem install av-ip

Usage

To initialize an instance of the geolocation tool, simply call

locater = AVIP.new()

The default instance is localhost, '127.0.0.1', yielding every output parameter. If you are unsure about settings it is best to leave the default parameters.

Post initialization, you may pass the locater paramters in hash format. Example:

locater.update({:content => [:ip, :city, :region], :ip => '127.0.0.1
'})

To recieve the data, simply call

locater.search 
	#=> {:ip => '127.0.0.1', :city => 'timbucktoo', :region => 'basement land'}

By default, search looks for the ip stored in the options, but simply adding any ip parameter to search will work such as

locater.search('123.45.67.89')

The following output parameters are:

:ip,
:hostname,
:city,
:region,
:country,
:loc,
:org,
:postal

##Notes The next phase in development is bulk geolocation and google map construction ##Contribute I Would love for y'all to contribute. Fork and hit me up.