ip2location facebbook  ip2location twitter  ip2location google+

Ruby Library

This is a Ruby library that enables the user to find the country, region, city, coordinates, zip code, time zone, ISP, domain name, connection type, area code, weather, MCC, MNC, mobile brand name, elevation and usage type that any IP address or hostname originates from. It has been optimized for speed and memory utilization. Developers can use the API to query all IP2Location™ binary databases for IPv4 and IPv6 address.

Download Download   Source Source


  1. Download the ruby package above.
  2. Decompress the package
    tar xvfz ip2location-ruby-x.x.x.tar.gz
  3. Install ip2location_ruby using RubyGems
    gem install ip2location_ruby
  4. Run the script
    ruby -rubygems example.rb


Sample Codes
require 'ip2location_ruby'

i2l = Ip2location.new.open("./data/IP-COUNTRY-SAMPLE.BIN")
record = i2l.get_all('')

print 'Country Code: ' + record.country_short + "\n"
print 'Country Name: ' + record.country_long + "\n"
print 'Region Name: ' + record.region + "\n"
print 'City Name: ' + record.city + "\n"
print 'Latitude: '
print record.latitude
print "\n"
print 'Longitude: '
print record.longitude
print "\n"
print 'ISP: ' + record.isp + "\n"
print 'Domain: ' + record.domain + "\n"
print 'Net Speed: ' + record.netspeed + "\n"
print 'Area Code: ' + record.areacode + "\n"
print 'IDD Code: ' + record.iddcode + "\n"
print 'Time Zone: ' + record.timezone + "\n"
print 'ZIP Code: ' + record.zipcode + "\n"
print 'Weather Station Code: ' + record.weatherstationname + "\n"
print 'Weather Station Name: ' + record.weatherstationcode + "\n"
print 'MCC: ' + record.mcc + "\n"
print 'MNC: ' + record.mnc + "\n"
print 'Mobile Name: ' + record.mobilebrand + "\n"
print 'Elevation: '
print record.elevation
print "\n"
print 'Usage Type: ' + record.usagetype + "\n"


Sample IP2Location Databases (BIN)

The following evaluation copy of the database file has limited range of IP address information compare to commercial. For evaluation purpose, you can query IP addresses from (IPv4) or 2A04:0:0:0:0:0:0:0-2A04:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF (IPv6).

Sample Packages IPv4 IPv6
IP2Location DB1 Sample Bin File469.88 kB73.62 kB
IP2Location DB2 Sample Bin File38.56 MB98.25 kB
IP2Location DB3 Sample Bin File18.59 MB83.64 kB
IP2Location DB4 Sample Bin File55.23 MB106.02 kB
IP2Location DB5 Sample Bin File29.55 MB89.62 kB
IP2Location DB6 Sample Bin File66.06 MB109.74 kB
IP2Location DB7 Sample Bin File61.18 MB115.26 kB
IP2Location DB8 Sample Bin File72.27 MB119.08 kB
IP2Location DB9 Sample Bin File34.62 MB91.86 kB
IP2Location DB10 Sample Bin File78.32 MB122.97 kB
IP2Location DB11 Sample Bin File35.35 MB92.44 kB
IP2Location DB12 Sample Bin File78.86 MB123.76 kB
IP2Location DB13 Sample Bin File33.92 MB90.82 kB
IP2Location DB14 Sample Bin File80.28 MB124.37 kB
IP2Location DB15 Sample Bin File38.43 MB96.03 kB
IP2Location DB16 Sample Bin File85.19 MB129.27 kB
IP2Location DB17 Sample Bin File41.61 MB97.87 kB
IP2Location DB18 Sample Bin File93.15 MB137.92 kB
IP2Location DB19 Sample Bin File75.10 MB119.78 kB
IP2Location DB20 Sample Bin File95.71 MB139.09 kB
IP2Location DB21 Sample Bin File42.24 MB98.41 kB
IP2Location DB22 Sample Bin File100.27 MB141.85 kB
IP2Location DB23 Sample Bin File75.70 MB120.75 kB
IP2Location DB24 Sample Bin File101.21 MB142.79 kB