Class: GoogleMapsGeocoder

Inherits:
Object
  • Object
show all
Defined in:
lib/google_maps_geocoder/version.rb,
lib/google_maps_geocoder/google_maps_geocoder.rb

Overview

A simple PORO wrapper for geocoding with Google Maps.

Examples:

chez_barack = GoogleMapsGeocoder.new '1600 Pennsylvania DC'
chez_barack.formatted_address
  => "1600 Pennsylvania Avenue Northwest, President's Park,
      Washington, DC 20500, USA"

Defined Under Namespace

Classes: GeocodingError

Constant Summary collapse

VERSION = 
'0.7'.freeze
GOOGLE_ADDRESS_SEGMENTS = 
%i[
  city country_long_name country_short_name county lat lng postal_code
  state_long_name state_short_name
].freeze
GOOGLE_MAPS_API = 
'https://maps.googleapis.com/maps/api/geocode/json'.freeze
ALL_ADDRESS_SEGMENTS = 
(
  GOOGLE_ADDRESS_SEGMENTS + %i[formatted_address formatted_street_address]
).freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(address) ⇒ GoogleMapsGeocoder

Geocodes the specified address and wraps the results in a GoogleMapsGeocoder object.

Examples:

chez_barack = GoogleMapsGeocoder.new '1600 Pennsylvania DC'

Parameters:

  • address (String) —

    a geocodable address

Raises:

  • (RuntimeError) 


66
67
68
69
70
71
72
73
74
75
76
 
# File 'lib/google_maps_geocoder/google_maps_geocoder.rb', line 66

def initialize(address)
  @json = address.is_a?(String) ? google_maps_response(address) : address
  status = @json && @json['status']
  raise RuntimeError if status == 'OVER_QUERY_LIMIT'
  raise GeocodingError, @json if @json.blank? || status != 'OK'

  set_attributes_from_json
  Logger.new(STDERR).info('GoogleMapsGeocoder') do
    "Geocoded \"#{address}\" => \"#{formatted_address}\""
  end
end

Instance Attribute Details

#formatted_address ⇒ String (readonly) Also known as: address

Returns the complete formatted address with standardized abbreviations.

Examples:

chez_barack.formatted_address
  => "1600 Pennsylvania Avenue Northwest, President's Park,
      Washington, DC 20500, USA"

Returns:

  • (String) —

    the complete formatted address



31
32
33
 
# File 'lib/google_maps_geocoder/google_maps_geocoder.rb', line 31

def formatted_address
  @formatted_address
end

#formatted_street_address ⇒ String (readonly)

Returns the formatted street address with standardized abbreviations.

Examples:

chez_barack.formatted_street_address
  => "1600 Pennsylvania Avenue Northwest"

Returns:

  • (String) —

    the formatted street address



39
40
41
 
# File 'lib/google_maps_geocoder/google_maps_geocoder.rb', line 39

def formatted_street_address
  @formatted_street_address
end

Instance Method Details

#coordinates ⇒ Object

Returns the address’ coordinates as an array of floats.



79
80
81
 
# File 'lib/google_maps_geocoder/google_maps_geocoder.rb', line 79

def coordinates
  [lat, lng]
end

#exact_match? ⇒ boolean

Returns true if the address Google returns is an exact match.

Examples:

chez_barack.exact_match?
  => true

Returns:

  • (boolean) —

    whether the Google Maps result is an exact match



89
90
91
 
# File 'lib/google_maps_geocoder/google_maps_geocoder.rb', line 89

def exact_match?
  !partial_match?
end

#partial_match? ⇒ boolean

Returns true if the address Google returns isn’t an exact match.

Examples:

GoogleMapsGeocoder.new('1600 Pennsylvania DC').partial_match?
  => true

Returns:

  • (boolean) —

    whether the Google Maps result is a partial match



99
100
101
 
# File 'lib/google_maps_geocoder/google_maps_geocoder.rb', line 99

def partial_match?
  @json['results'][0]['partial_match'] == true
end