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.is_a?(String) and !!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 = http_client.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 http_client
Object used to make HTTP requests.
#
def http_client protocol = "http#{'s' if Geocoder::Configuration.use_https}" proxy_name = "#{protocol}_proxy" if proxy = Geocoder::Configuration.send(proxy_name) proxy_url = protocol + '://' + proxy begin uri = URI.parse(proxy_url) rescue URI::InvalidURIError raise ConfigurationError, "Error parsing #{protocol.upcase} proxy URL: '#{proxy_url}'" end Net::HTTP::Proxy(uri.host, uri.port, uri.user, uri.password) else Net::HTTP end 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 map_link_url(coordinates)
also provide maps.
Not necessarily implemented by all subclasses as only some lookups
Return the URL for a map of the given coordinates.
#
def map_link_url(coordinates) nil 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)
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) # 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