ip2location_ruby 7.0.0 → 8.1.1

data/ip2location_ruby.gemspec

@@ -1,79 +1,87 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-# stub: ip2location_ruby 7.0.0 ruby lib
-
-Gem::Specification.new do |s|
-  s.name = "ip2location_ruby"
-  s.version = "7.0.0"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.require_paths = ["lib"]
-  s.authors = ["Vincent.Z"]
-  s.date = "2014-08-13"
-  s.description = "the ip2location ruby library"
-  s.email = "zhu1230@gmail.com"
-  s.extra_rdoc_files = [
-    "LICENSE.txt",
-    "README.rdoc"
-  ]
-  s.files = [
-    ".document",
-    ".rspec",
-    "Gemfile",
-    "Gemfile.lock",
-    "LICENSE.txt",
-    "README.rdoc",
-    "Rakefile",
-    "VERSION",
-    "ip2location_ruby.gemspec",
-    "lib/ip2location_ruby.rb",
-    "lib/ip2location_ruby/database_config.rb",
-    "lib/ip2location_ruby/i2l_float_data.rb",
-    "lib/ip2location_ruby/i2l_ip_data.rb",
-    "lib/ip2location_ruby/i2l_string_data.rb",
-    "lib/ip2location_ruby/ip2location_config.rb",
-    "lib/ip2location_ruby/ip2location_record.rb",
-    "spec/assets/DB24.DEMO4.BIN",
-    "spec/assets/DB24.DEMO6.BIN",
-    "spec/assets/IP-COUNTRY-SAMPLE.BIN",
-    "spec/ip2location_ruby_spec.rb",
-    "spec/spec_helper.rb"
-  ]
-  s.homepage = "http://github.com/zhu1230/ip2location"
-  s.licenses = ["MIT"]
-  s.rubygems_version = "2.4.1"
-  s.summary = "the ip2location ruby library"
-
-  if s.respond_to? :specification_version then
-    s.specification_version = 4
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<bindata>, [">= 0"])
-      s.add_development_dependency(%q<awesome_print>, [">= 0"])
-      s.add_development_dependency(%q<rspec>, ["~> 2.8.0"])
-      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
-      s.add_development_dependency(%q<bundler>, [">= 1.2.0"])
-      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
-      s.add_development_dependency(%q<simplecov>, [">= 0"])
-    else
-      s.add_dependency(%q<bindata>, [">= 0"])
-      s.add_dependency(%q<awesome_print>, [">= 0"])
-      s.add_dependency(%q<rspec>, ["~> 2.8.0"])
-      s.add_dependency(%q<rdoc>, ["~> 3.12"])
-      s.add_dependency(%q<bundler>, [">= 1.2.0"])
-      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
-      s.add_dependency(%q<simplecov>, [">= 0"])
-    end
-  else
-    s.add_dependency(%q<bindata>, [">= 0"])
-    s.add_dependency(%q<awesome_print>, [">= 0"])
-    s.add_dependency(%q<rspec>, ["~> 2.8.0"])
-    s.add_dependency(%q<rdoc>, ["~> 3.12"])
-    s.add_dependency(%q<bundler>, [">= 1.2.0"])
-    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
-    s.add_dependency(%q<simplecov>, [">= 0"])
-  end
-end
-
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "ip2location_ruby"
+  s.version = "8.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
+  s.authors       = ["ip2location"]
+  s.email         = ["support@ip2location.com"]
+  s.description = "The official IP2Location Ruby library to geolocate an IP address. You can lookup for country, region, city, latitude, longitude, zip code, time zone, ISP, domain, area code, usage type, mobile data, weather data and elevation from an IP address. Supported both IPv4 and IPv6 lookup."
+  s.email = "support@ip2location.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "Rakefile",
+    "VERSION",
+    "ip2location_ruby.gemspec",
+    "example.rb",
+    "lib/ip2location_ruby.rb",
+    "lib/ip2location_ruby/database_config.rb",
+    "lib/ip2location_ruby/i2l_float_data.rb",
+    "lib/ip2location_ruby/i2l_ip_data.rb",
+    "lib/ip2location_ruby/i2l_string_data.rb",
+    "lib/ip2location_ruby/ip2location_config.rb",
+    "lib/ip2location_ruby/ip2location_record.rb",
+    "spec/assets/DB24.DEMO4.BIN",
+    "spec/assets/DB24.DEMO6.BIN",
+    "spec/assets/IP-COUNTRY-SAMPLE.BIN",
+    "spec/ip2location_ruby_spec.rb",
+    "spec/spec_helper.rb",
+    "rb/data/IP2LOCATION-LITE-DB1.IPV6.BIN"
+  ]
+  s.homepage = "https://github.com/ip2location/ip2location-ruby"
+  s.licenses = ["MIT"]
+  s.summary = "the ip2location ruby library"
+
+  if s.respond_to?(:metadata=)
+    s.metadata = {
+      "bug_tracker_uri" => "https://github.com/ip2location/ip2location-ruby/issues",
+      "documentation_uri" => "https://www.rubydoc.info/gems/ip2location_ruby",
+      "homepage_uri" => "https://www.ip2location.com",
+      "source_code_uri" => "https://github.com/ip2location/ip2location-ruby",
+    }
+  end
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<bindata>, [">= 0"])
+      s.add_development_dependency(%q<awesome_print>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.8.0"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, [">= 1.2.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+    else
+      s.add_dependency(%q<bindata>, [">= 0"])
+      s.add_dependency(%q<awesome_print>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.8.0"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, [">= 1.2.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<bindata>, [">= 0"])
+    s.add_dependency(%q<awesome_print>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.8.0"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, [">= 1.2.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+  end
+end
+

data/lib/ip2location_ruby.rb

@@ -1,74 +1,539 @@
-# encoding: utf-8
-require 'bindata'
-require 'ipaddr'
-require 'ip2location_ruby/ip2location_config'
-require 'ip2location_ruby/database_config'
-require 'ip2location_ruby/i2l_float_data'
-require 'ip2location_ruby/i2l_string_data'
-require 'ip2location_ruby/i2l_ip_data'
-require 'ip2location_ruby/ip2location_record'
-
-class Ip2location
-  attr_accessor :record_class, :v4, :file, :db_index, :count, :base_addr, :ipno, :count, :record, :database, :columns, :ip_version, :ipv4databasecount, :ipv4databaseaddr, :ipv6databasecount, :ipv6databaseaddr
-  
-  def open(url)
-    self.file = File.open(File.expand_path url, 'rb')
-    i2l = Ip2locationConfig.read(file)
-    self.db_index = i2l.databasetype
-    self.columns = i2l.databasecolumn + 0
-    self.database = DbConfig.setup_database(self.db_index)
-    self.ipv4databasecount = i2l.ipv4databasecount
-    self.ipv4databaseaddr = i2l.ipv4databaseaddr
-    self.ipv6databasecount = i2l.ipv6databasecount
-    self.ipv6databaseaddr = i2l.ipv6databaseaddr
-    self
-  end
-  
-  def get_all(ip)
-    ipno = IPAddr.new(ip, Socket::AF_UNSPEC)
-    self.ip_version = ipno.ipv4? ? 4 : 6
-    self.v4 = ipno.ipv4?
-    self.count = ipno.ipv4? ? self.ipv4databasecount + 0 : self.ipv6databasecount + 0
-    self.base_addr = (ipno.ipv4? ? self.ipv4databaseaddr - 1 : self.ipv6databaseaddr - 1)
-    self.record_class = (Ip2LocationRecord.init database, self.ip_version)
-    
-    ipnum = ipno.to_i + 0
-    col_length = columns * 4
-
-    return self.record = bsearch(0, self.count, ipnum, self.base_addr, col_length)
-  end
-  
-  def get_from_to(mid, base_addr, col_length)
-    from_base = ( base_addr + mid * (col_length + (v4 ? 0 : 12)))
-    file.seek(from_base)
-    ip_from =  v4 ? BinData::Uint32le.read(file) : BinData::Uint128le.read(file)
-    file.seek(from_base + col_length + (v4 ? 0 : 12))
-    ip_to = v4 ? BinData::Uint32le.read(file) : BinData::Uint128le.read(file)
-    [ip_from, ip_to]
-  end
-  
-  def bsearch(low, high, ipnum, base_addr, col_length) 
-    mid = (high + low)/2
-    return nil if low == mid
-    ip_from, ip_to = get_from_to(mid, base_addr, col_length)
-    if ipnum < ip_from
-      low = low
-      high = mid
-      return bsearch(low, high, ipnum, base_addr, col_length)
-    elsif ipnum >= ip_to
-      low = mid
-      high = high
-      return bsearch(low, high, ipnum, base_addr, col_length) 
-    else
-      from_base = ( base_addr + mid * (col_length + (self.v4 ? 0 : 12)))
-      file.seek(from_base)  
-      return self.record_class.read(file)
-    end
-  end
-    
-end
-
-
-
-
-
+# encoding: utf-8
+require 'bindata'
+require 'ipaddr'
+require 'ip2location_ruby/ip2location_config'
+require 'ip2location_ruby/database_config'
+require 'ip2location_ruby/i2l_float_data'
+require 'ip2location_ruby/i2l_string_data'
+require 'ip2location_ruby/i2l_ip_data'
+require 'ip2location_ruby/ip2location_record'
+
+class Ip2location
+  attr_accessor :record_class4, :record_class6, :v4, :file, :db_index, :count, :base_addr, :ipno, :count, :record, :database, :columns, :ip_version, :ipv4databasecount, :ipv4databaseaddr, :ipv4indexbaseaddr, :ipv6databasecount, :ipv6databaseaddr, :ipv6indexbaseaddr
+
+  FIELD_NOT_SUPPORTED = 'NOT SUPPORTED'
+  INVALID_IP_ADDRESS = 'INVALID IP ADDRESS'
+
+  def open(url)
+    self.file = File.open(File.expand_path url, 'rb')
+    i2l = Ip2locationConfig.read(file)
+    self.db_index = i2l.databasetype
+    self.columns = i2l.databasecolumn + 0
+    self.database = DbConfig.setup_database(self.db_index)
+    self.ipv4databasecount = i2l.ipv4databasecount
+    self.ipv4databaseaddr = i2l.ipv4databaseaddr
+    self.ipv6databasecount = i2l.ipv6databasecount
+    self.ipv6databaseaddr = i2l.ipv6databaseaddr
+    self.ipv4indexbaseaddr = i2l.ipv4indexbaseaddr
+    self.ipv6indexbaseaddr = i2l.ipv6indexbaseaddr
+    self.record_class4 = (Ip2LocationRecord.init database, 4)
+    self.record_class6 = (Ip2LocationRecord.init database, 6)
+    self
+  end
+
+  def close()
+    self.file.close
+  end
+
+  def get_record(ip)
+    ipno = IPAddr.new(ip, Socket::AF_UNSPEC)
+    self.ip_version, ipnum = validateip(ipno)
+    self.v4 = ip_version == 4 ? true : false
+    self.count = v4 ? self.ipv4databasecount + 0 : self.ipv6databasecount + 0
+    self.base_addr = (v4 ? self.ipv4databaseaddr - 1 : self.ipv6databaseaddr - 1)
+    col_length = columns * 4
+    if ipv4indexbaseaddr > 0 || ipv6indexbaseaddr > 0
+        indexpos = 0
+        case ip_version
+        when 4
+            indexpos = ipv4indexbaseaddr + ((ipnum >> 16) << 3)
+            realipno = ipnum
+            # if ipnum reach MAX_IPV4_RANGE
+            if realipno == 4294967295
+                ipnum = realipno - 1
+            end
+        when 6
+            indexpos = ipv6indexbaseaddr + ((ipnum >> 112) << 3)
+            realipno = ipnum
+            # if ipnum reach MAX_IPV6_RANGE
+            if realipno == 340282366920938463463374607431768211455
+                ipnum = realipno - 1
+            end
+        end
+        low = read32(indexpos)
+        high = read32(indexpos + 4)
+        return self.record = bsearch(low, high, ipnum, self.base_addr, col_length)
+    else
+        return self.record = bsearch(0, self.count, ipnum, self.base_addr, col_length)
+    end
+  end
+
+  def get_all(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            country_short = (defined?(rec.country_short) && rec.country_short != '') ? rec.country_short : FIELD_NOT_SUPPORTED
+            country_long = (defined?(rec.country_long) && rec.country_long != '') ? rec.country_long : FIELD_NOT_SUPPORTED
+            region = (defined?(rec.region) && rec.region != '') ? rec.region : FIELD_NOT_SUPPORTED
+            city = (defined?(rec.city) && rec.city != '') ? rec.city : FIELD_NOT_SUPPORTED
+            latitude = (defined?(rec.latitude) && rec.latitude != '') ? rec.latitude : FIELD_NOT_SUPPORTED
+            longitude = (defined?(rec.longitude) && rec.longitude != '') ? rec.longitude : FIELD_NOT_SUPPORTED
+            isp = (defined?(rec.isp) && rec.isp != '') ? rec.isp : FIELD_NOT_SUPPORTED
+            domain = (defined?(rec.domain) && rec.domain != '') ? rec.domain : FIELD_NOT_SUPPORTED
+            netspeed = (defined?(rec.netspeed) && rec.netspeed != '') ? rec.netspeed : FIELD_NOT_SUPPORTED
+            areacode = (defined?(rec.areacode) && rec.areacode != '') ? rec.areacode : FIELD_NOT_SUPPORTED
+            iddcode = (defined?(rec.iddcode) && rec.iddcode != '') ? rec.iddcode : FIELD_NOT_SUPPORTED
+            timezone = (defined?(rec.timezone) && rec.timezone != '') ? rec.timezone : FIELD_NOT_SUPPORTED
+            zipcode = (defined?(rec.zipcode) && rec.zipcode != '') ? rec.zipcode : FIELD_NOT_SUPPORTED
+            weatherstationname = (defined?(rec.weatherstationname) && rec.weatherstationname != '') ? rec.weatherstationname : FIELD_NOT_SUPPORTED
+            weatherstationcode = (defined?(rec.weatherstationcode) && rec.weatherstationcode != '') ? rec.weatherstationcode : FIELD_NOT_SUPPORTED
+            mcc = (defined?(rec.mcc) && rec.mcc != '') ? rec.mcc : FIELD_NOT_SUPPORTED
+            mnc = (defined?(rec.mnc) && rec.mnc != '') ? rec.mnc : FIELD_NOT_SUPPORTED
+            mobilebrand = (defined?(rec.mobilebrand) && rec.mobilebrand != '') ? rec.mobilebrand : FIELD_NOT_SUPPORTED
+            elevation = (defined?(rec.elevation) && rec.elevation != '') ? rec.elevation : FIELD_NOT_SUPPORTED
+            usagetype = (defined?(rec.usagetype) && rec.usagetype != '') ? rec.usagetype : FIELD_NOT_SUPPORTED
+        else
+            country_short = INVALID_IP_ADDRESS
+            country_long = INVALID_IP_ADDRESS
+            region = INVALID_IP_ADDRESS
+            city = INVALID_IP_ADDRESS
+            latitude = INVALID_IP_ADDRESS
+            longitude = INVALID_IP_ADDRESS
+            isp = INVALID_IP_ADDRESS
+            domain = INVALID_IP_ADDRESS
+            netspeed = INVALID_IP_ADDRESS
+            areacode = INVALID_IP_ADDRESS
+            iddcode = INVALID_IP_ADDRESS
+            timezone = INVALID_IP_ADDRESS
+            zipcode = INVALID_IP_ADDRESS
+            weatherstationname = INVALID_IP_ADDRESS
+            weatherstationcode = INVALID_IP_ADDRESS
+            mcc = INVALID_IP_ADDRESS
+            mnc = INVALID_IP_ADDRESS
+            mobilebrand = INVALID_IP_ADDRESS
+            elevation = INVALID_IP_ADDRESS
+            usagetype = INVALID_IP_ADDRESS
+        end
+    else
+        country_short = INVALID_IP_ADDRESS
+        country_long = INVALID_IP_ADDRESS
+        region = INVALID_IP_ADDRESS
+        city = INVALID_IP_ADDRESS
+        latitude = INVALID_IP_ADDRESS
+        longitude = INVALID_IP_ADDRESS
+        isp = INVALID_IP_ADDRESS
+        domain = INVALID_IP_ADDRESS
+        netspeed = INVALID_IP_ADDRESS
+        areacode = INVALID_IP_ADDRESS
+        iddcode = INVALID_IP_ADDRESS
+        timezone = INVALID_IP_ADDRESS
+        zipcode = INVALID_IP_ADDRESS
+        weatherstationname = INVALID_IP_ADDRESS
+        weatherstationcode = INVALID_IP_ADDRESS
+        mcc = INVALID_IP_ADDRESS
+        mnc = INVALID_IP_ADDRESS
+        mobilebrand = INVALID_IP_ADDRESS
+        elevation = INVALID_IP_ADDRESS
+        usagetype = INVALID_IP_ADDRESS
+    end
+    results = {}
+    results['country_short'] = country_short
+    results['country_long'] = country_long
+    results['region'] = region
+    results['city'] = city
+    results['latitude'] = latitude
+    results['longitude'] = longitude
+    results['isp'] = isp
+    results['domain'] = domain
+    results['netspeed'] = netspeed
+    results['areacode'] = areacode
+    results['iddcode'] = iddcode
+    results['timezone'] = timezone
+    results['zipcode'] = zipcode
+    results['weatherstationname'] = weatherstationname
+    results['weatherstationcode'] = weatherstationcode
+    results['mcc'] = mcc
+    results['mnc'] = mnc
+    results['mobilebrand'] = mobilebrand
+    results['elevation'] = elevation
+    results['usagetype'] = usagetype
+    return results
+  end
+
+  def get_country_short(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            country_short = (defined?(rec.country_short) && rec.country_short != '') ? rec.country_short : FIELD_NOT_SUPPORTED
+        else
+            country_short = INVALID_IP_ADDRESS
+        end
+    else
+        country_short = INVALID_IP_ADDRESS
+    end
+    return country_short
+  end
+
+  def get_country_long(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            country_long = (defined?(rec.country_long) && rec.country_long != '') ? rec.country_long : FIELD_NOT_SUPPORTED
+        else
+            country_long = INVALID_IP_ADDRESS
+        end
+    else
+        country_long = INVALID_IP_ADDRESS
+    end
+    return country_long
+  end
+
+  def get_region(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            region = (defined?(rec.region) && rec.region != '') ? rec.region : FIELD_NOT_SUPPORTED
+        else
+            region = INVALID_IP_ADDRESS
+        end
+    else
+        region = INVALID_IP_ADDRESS
+    end
+    return region
+  end
+
+  def get_city(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            city = (defined?(rec.city) && rec.city != '') ? rec.city : FIELD_NOT_SUPPORTED
+        else
+            city = INVALID_IP_ADDRESS
+        end
+    else
+        city = INVALID_IP_ADDRESS
+    end
+    return city
+  end
+
+  def get_latitude(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            latitude = (defined?(rec.latitude) && rec.latitude != '') ? rec.latitude : FIELD_NOT_SUPPORTED
+        else
+            latitude = INVALID_IP_ADDRESS
+        end
+    else
+        latitude = INVALID_IP_ADDRESS
+    end
+    return latitude
+  end
+
+  def get_longitude(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            longitude = (defined?(rec.longitude) && rec.longitude != '') ? rec.longitude : FIELD_NOT_SUPPORTED
+        else
+            longitude = INVALID_IP_ADDRESS
+        end
+    else
+        longitude = INVALID_IP_ADDRESS
+    end
+    return longitude
+  end
+
+  def get_isp(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            isp = (defined?(rec.isp) && rec.isp != '') ? rec.isp : FIELD_NOT_SUPPORTED
+        else
+            isp = INVALID_IP_ADDRESS
+        end
+    else
+        isp = INVALID_IP_ADDRESS
+    end
+    return isp
+  end
+
+  def get_domain(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            domain = (defined?(rec.domain) && rec.domain != '') ? rec.domain : FIELD_NOT_SUPPORTED
+        else
+            domain = INVALID_IP_ADDRESS
+        end
+    else
+        domain = INVALID_IP_ADDRESS
+    end
+    return domain
+  end
+
+  def get_zipcode(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            zipcode = (defined?(rec.zipcode) && rec.zipcode != '') ? rec.zipcode : FIELD_NOT_SUPPORTED
+        else
+            zipcode = INVALID_IP_ADDRESS
+        end
+    else
+        zipcode = INVALID_IP_ADDRESS
+    end
+    return zipcode
+  end
+
+  def get_timezone(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            timezone = (defined?(rec.timezone) && rec.timezone != '') ? rec.timezone : FIELD_NOT_SUPPORTED
+        else
+            timezone = INVALID_IP_ADDRESS
+        end
+    else
+        timezone = INVALID_IP_ADDRESS
+    end
+    return timezone
+  end
+
+  def get_netspeed(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            netspeed = (defined?(rec.netspeed) && rec.netspeed != '') ? rec.netspeed : FIELD_NOT_SUPPORTED
+        else
+            netspeed = INVALID_IP_ADDRESS
+        end
+    else
+        netspeed = INVALID_IP_ADDRESS
+    end
+    return netspeed
+  end
+
+  def get_iddcode(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            iddcode = (defined?(rec.iddcode) && rec.iddcode != '') ? rec.iddcode : FIELD_NOT_SUPPORTED
+        else
+            iddcode = INVALID_IP_ADDRESS
+        end
+    else
+        iddcode = INVALID_IP_ADDRESS
+    end
+    return iddcode
+  end
+
+  def get_areacode(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            areacode = (defined?(rec.areacode) && rec.areacode != '') ? rec.areacode : FIELD_NOT_SUPPORTED
+        else
+            areacode = INVALID_IP_ADDRESS
+        end
+    else
+        areacode = INVALID_IP_ADDRESS
+    end
+    return areacode
+  end
+
+  def get_weatherstationcode(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            weatherstationcode = (defined?(rec.weatherstationcode) && rec.weatherstationcode != '') ? rec.weatherstationcode : FIELD_NOT_SUPPORTED
+        else
+            weatherstationcode = INVALID_IP_ADDRESS
+        end
+    else
+        weatherstationcode = INVALID_IP_ADDRESS
+    end
+    return weatherstationcode
+  end
+
+  def get_weatherstationname(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            weatherstationname = (defined?(rec.weatherstationname) && rec.weatherstationname != '') ? rec.weatherstationname : FIELD_NOT_SUPPORTED
+        else
+            weatherstationname = INVALID_IP_ADDRESS
+        end
+    else
+        weatherstationname = INVALID_IP_ADDRESS
+    end
+    return weatherstationname
+  end
+
+  def get_mcc(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            mcc = (defined?(rec.mcc) && rec.mcc != '') ? rec.mcc : FIELD_NOT_SUPPORTED
+        else
+            mcc = INVALID_IP_ADDRESS
+        end
+    else
+        mcc = INVALID_IP_ADDRESS
+    end
+    return mcc
+  end
+
+  def get_mnc(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            mnc = (defined?(mnc) && rec.mnc != '') ? rec.mnc : FIELD_NOT_SUPPORTED
+        else
+            mnc = INVALID_IP_ADDRESS
+        end
+    else
+        mnc = INVALID_IP_ADDRESS
+    end
+    return mnc
+  end
+
+  def get_mobilebrand(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            mobilebrand = (defined?(rec.mobilebrand) && rec.mobilebrand != '') ? rec.mobilebrand : FIELD_NOT_SUPPORTED
+        else
+            mobilebrand = INVALID_IP_ADDRESS
+        end
+    else
+        mobilebrand = INVALID_IP_ADDRESS
+    end
+    return mobilebrand
+  end
+
+  def get_elevation(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            elevation = (defined?(rec.elevation) && rec.elevation != '') ? rec.elevation : FIELD_NOT_SUPPORTED
+        else
+            elevation = INVALID_IP_ADDRESS
+        end
+    else
+        elevation = INVALID_IP_ADDRESS
+    end
+    return elevation
+  end
+
+  def get_usagetype(ip)
+    valid = !(IPAddr.new(ip) rescue nil).nil?
+    if valid
+        rec = get_record(ip)
+        if !(rec.nil?)
+            usagetype = (defined?(rec.usagetype) && rec.usagetype != '') ? rec.usagetype : FIELD_NOT_SUPPORTED
+        else
+            usagetype = INVALID_IP_ADDRESS
+        end
+    else
+        usagetype = INVALID_IP_ADDRESS
+    end
+    return usagetype
+  end
+
+  def bsearch(low, high, ipnum, base_addr, col_length)
+    while low <= high do
+        mid = (low + high) >> 1
+        ip_from, ip_to = get_from_to(mid, base_addr, col_length)
+        if ipnum >= ip_from && ipnum < ip_to
+            from_base = ( base_addr + mid * (col_length + (self.v4 ? 0 : 12)))
+            file.seek(from_base)
+            if v4
+                return self.record_class4.read(file)
+            else
+                return self.record_class6.read(file)
+            end
+        else
+            if ipnum < ip_from
+                high = mid - 1
+            else
+                low = mid + 1
+            end
+        end
+    end    
+  end
+
+  def get_from_to(mid, base_addr, col_length)
+    from_base = ( base_addr + mid * (col_length + (v4 ? 0 : 12)))
+    file.seek(from_base)
+    ip_from = v4 ? file.read(4).unpack('V').first : readipv6(file)
+    file.seek(from_base + col_length + (v4 ? 0 : 12))
+    ip_to = v4 ? file.read(4).unpack('V').first : readipv6(file)
+    [ip_from, ip_to]
+  end
+
+  def validateip(ip)
+    if ip.ipv4?
+        ipv = 4
+        ipnum = ip.to_i + 0
+    else
+        ipv = 6
+        ipnum = ip.to_i + 0
+        #reformat ipv4 address in ipv6 
+        if ipnum >= 281470681743360 && ipnum <= 281474976710655
+            ipv = 4
+            ipnum = ipnum - 281470681743360
+        end
+        #reformat 6to4 address to ipv4 address 2002:: to 2002:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF
+        if ipnum >= 42545680458834377588178886921629466624 && ipnum <= 42550872755692912415807417417958686719
+            ipv = 4
+            #bitshift right 80 bits
+            ipnum = ipnum >> 80
+            #bitwise modulus to get the last 32 bit
+            ipnum = ipnum % 4294967296
+        end
+        #reformat Teredo address to ipv4 address 2001:0000:: to 2001:0000:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:
+        if ipnum >= 42540488161975842760550356425300246528 && ipnum <= 42540488241204005274814694018844196863
+            ipv = 4
+            #bitwise not to invert binary
+            ipnum = ~ipnum
+            #bitwise modulus to get the last 32 bit
+            ipnum = ipnum % 4294967296
+        end
+    end
+    [ipv, ipnum]
+  end
+
+  def read32(indexp)
+    file.seek(indexp - 1)
+    return file.read(4).unpack('V').first
+  end
+
+  def readipv6(filer)
+    parts = filer.read(16).unpack('V*')
+    return parts[0] + parts[1] * 4294967296 + parts[2] * 4294967296**2 + parts[3] * 4294967296**3
+  end
+
+  private :get_record, :bsearch, :get_from_to, :read32, :readipv6
+
+end