class Geocoder::Query

def blank?


no URL parameters are specified.
A query is considered blank if its text is nil or empty string AND
Is the Query blank? (ie, should we not bother searching?)
# 
def blank?
  !params_given? and (
    (text.is_a?(Array) and text.compact.size < 2) or
    text.to_s.match(/\A\s*\z/)
  )
end

def coordinates


or nil if none.
Return the latitude/longitude coordinates specified in the query,
# 
def coordinates
  sanitized_text.split(',') if coordinates?
end

def coordinates?


Does the given string look like latitude/longitude coordinates?
# 
def coordinates?
  text.is_a?(Array) or (
    text.is_a?(String) and
    !!text.to_s.match(/\A-?[0-9\.]+, *-?[0-9\.]+\z/)
  )
end

def execute 

def execute
  lookup.search(text, options)
end

def initialize(text, options = {}) 

def initialize(text, options = {})
  self.text = text
  self.options = options
end

def ip_address?


dot-delimited numbers.
Does not check for actual validity, just the appearance of four

Does the Query text look like an IP address?
# 
def ip_address?
  !!text.to_s.match(/\A(::ffff:)?(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})\z/)
end

def lookup


appropriate to the Query text.
Get a Lookup object (which communicates with the remote geocoding API)
# 
def lookup
  if ip_address?
    name = Configuration.ip_lookup || Geocoder::Lookup.ip_services.first
  else
    name = Configuration.lookup || Geocoder::Lookup.street_services.first
  end
  Lookup.get(name)
end

def loopback_ip_address?


Is the Query text a loopback IP address?
# 
def loopback_ip_address?
  !!(self.ip_address? and (text == "0.0.0.0" or text.to_s.match(/\A127/)))
end

def params_given? 

def params_given?
  !!(options[:params].is_a?(Hash) and options[:params].keys.size > 0)
end

def reverse_geocode?


Should reverse geocoding be performed for this query?
# 
def reverse_geocode?
  coordinates?
end

def sanitized_text 

def sanitized_text
  if coordinates?
    text.split(/\s*,\s*/).join(',')
  else
    text
  end
end

def to_s 

def to_s
  text
end

def url 

def url
  lookup.query_url(self)
end