class Geocoder::Lookup::Base
def cache
The working Cache object.
#
def cache Geocoder.cache end
def coordinates?(value)
Does the given string look like latitude/longitude coordinates?
#
def coordinates?(value) !!value.to_s.match(/^[0-9\.\-]+, *[0-9\.\-]+$/) end
def fetch_data(query, reverse = false)
Returns a parsed search result (Ruby hash).
#
def fetch_data(query, reverse = false) begin parse_raw_data fetch_raw_data(query, reverse) rescue SocketError warn "Geocoding API connection cannot be established." rescue TimeoutError warn "Geocoding API not responding fast enough " + "(see Geocoder::Configuration.timeout to set limit)." end end
def fetch_raw_data(query, reverse = false)
Fetches a raw search result (JSON string).
#
def fetch_raw_data(query, reverse = false) timeout(Geocoder::Configuration.timeout) do url = query_url(query, reverse) unless cache and response = cache[url] response = Net::HTTP.get_response(URI.parse(url)).body if cache cache[url] = response end end response end end
def hash_to_query(hash)
Removes any keys with nil value.
Simulate ActiveSupport's Object#to_query.
#
def hash_to_query(hash) require 'cgi' unless defined?(CGI) && defined?(CGI.escape) hash.collect{ |p| p[1].nil? ? nil : p.map{ |i| CGI.escape i.to_s } * '=' }.compact.sort * '&' end
def loopback_address?(ip)
Is the given string a loopback IP address?
#
def loopback_address?(ip) !!(ip == "0.0.0.0" or ip.to_s.match(/^127/)) end
def parse_raw_data(raw_data)
Parses a raw search result (returns hash or array).
#
def parse_raw_data(raw_data) if defined?(ActiveSupport::JSON) ActiveSupport::JSON.decode(raw_data) else begin JSON.parse(raw_data) rescue warn "Geocoding API's response was not valid JSON." end end end
def protocol
Set in configuration but not available for every service.
Protocol to use for communication with geocoding services.
#
def protocol "http" + (Geocoder::Configuration.use_https ? "s" : "") end
def query_url(query, reverse = false)
URL to use for querying the geocoding engine.
#
def query_url(query, reverse = false) fail end
def result_class
Class of the result objects
#
def result_class eval("Geocoder::Result::#{self.class.to_s.split(":").last}") end
def results(query, reverse = false)
Geocoder::Result object or nil on timeout or other error.
#
def results(query, reverse = false) fail end
def search(query, *args)
for reverse geocoding. Returns an array of Geocoder::Results.
"205.128.54.202") for geocoding, or coordinates (latitude, longitude)
Takes a search string (eg: "Mississippi Coast Coliseumf, Biloxi, MS",
Returns +nil+ on timeout or error.
Query the geocoding API and return a Geocoder::Result object.
#
def search(query, *args) # convert coordinates as separate arguments to an array if query.is_a?(Numeric) and args.first.is_a?(Numeric) warn "DEPRECATION WARNING: Instead of passing latitude/longitude as separate arguments to the search method, please pass an array: [#{query},#{args.first}]. The old argument format will not be supported in Geocoder v.1.0." query = [query, args.first] end # if coordinates given as string, turn into array query = query.split(/\s*,\s*/) if coordinates?(query) if query.is_a?(Array) reverse = true query = query.join(',') else reverse = false end results(query, reverse).map{ |r| result_class.new(r) } end