greatseth-google-geo 2.0

data/CHANGELOG

@@ -0,0 +1,3 @@
+v2.0. Multiple Addresses (and tests you can actually run!); Not insignificant API change: *** Google::Geo#locate ALWAYS RETURNS AN ARRAY ***; There are now some nice examples in the README; Updated to include the fixtures and vendor dependencies for tests, yeknow, so you can actually run them; No namby pamby point releases. This is serious, folks.
+
+v1.0. Initial Release

data/LICENSE

@@ -0,0 +1,19 @@
+This program is free software. It comes without any warranty, to
+the extent permitted by applicable law. You can redistribute it
+and/or modify it under the terms of the Do What The Fuck You Want
+To Public License, Version 2, as published by Sam Hocevar. See
+http://sam.zoy.org/wtfpl/COPYING for more details.
+
+           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                   Version 2, December 2004
+
+Copyright (C) 2004 Sam Hocevar
+ 14 rue de Plaisance, 75014 Paris, France
+Everyone is permitted to copy and distribute verbatim or modified
+copies of this license document, and changing it is allowed as long
+as the name is changed.
+
+           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+  TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. You just DO WHAT THE FUCK YOU WANT TO.

data/Manifest

@@ -0,0 +1,67 @@
+CHANGELOG
+lib/google/geo.rb
+LICENSE
+Rakefile
+README
+test/fixtures/invalid_map_key.xml
+test/fixtures/missing_address.xml
+test/fixtures/server_error.xml
+test/fixtures/success.xml
+test/fixtures/success_with_multiple_addresses.xml
+test/fixtures/too_many_queries.xml
+test/fixtures/unavailable_address.xml
+test/fixtures/unknown_address.xml
+test/geo_test.rb
+vendor/mocha-0.4.0/COPYING
+vendor/mocha-0.4.0/examples/misc.rb
+vendor/mocha-0.4.0/examples/mocha.rb
+vendor/mocha-0.4.0/examples/stubba.rb
+vendor/mocha-0.4.0/lib/mocha/any_instance_method.rb
+vendor/mocha-0.4.0/lib/mocha/auto_verify.rb
+vendor/mocha-0.4.0/lib/mocha/central.rb
+vendor/mocha-0.4.0/lib/mocha/class_method.rb
+vendor/mocha-0.4.0/lib/mocha/expectation.rb
+vendor/mocha-0.4.0/lib/mocha/expectation_error.rb
+vendor/mocha-0.4.0/lib/mocha/infinite_range.rb
+vendor/mocha-0.4.0/lib/mocha/inspect.rb
+vendor/mocha-0.4.0/lib/mocha/instance_method.rb
+vendor/mocha-0.4.0/lib/mocha/metaclass.rb
+vendor/mocha-0.4.0/lib/mocha/mock.rb
+vendor/mocha-0.4.0/lib/mocha/mock_methods.rb
+vendor/mocha-0.4.0/lib/mocha/object.rb
+vendor/mocha-0.4.0/lib/mocha/pretty_parameters.rb
+vendor/mocha-0.4.0/lib/mocha/setup_and_teardown.rb
+vendor/mocha-0.4.0/lib/mocha/standalone.rb
+vendor/mocha-0.4.0/lib/mocha/test_case_adapter.rb
+vendor/mocha-0.4.0/lib/mocha.rb
+vendor/mocha-0.4.0/lib/mocha_standalone.rb
+vendor/mocha-0.4.0/lib/stubba.rb
+vendor/mocha-0.4.0/MIT-LICENSE
+vendor/mocha-0.4.0/Rakefile
+vendor/mocha-0.4.0/README
+vendor/mocha-0.4.0/RELEASE
+vendor/mocha-0.4.0/test/active_record_test_case.rb
+vendor/mocha-0.4.0/test/all_tests.rb
+vendor/mocha-0.4.0/test/execution_point.rb
+vendor/mocha-0.4.0/test/method_definer.rb
+vendor/mocha-0.4.0/test/mocha/any_instance_method_test.rb
+vendor/mocha-0.4.0/test/mocha/auto_verify_test.rb
+vendor/mocha-0.4.0/test/mocha/central_test.rb
+vendor/mocha-0.4.0/test/mocha/class_method_test.rb
+vendor/mocha-0.4.0/test/mocha/expectation_test.rb
+vendor/mocha-0.4.0/test/mocha/infinite_range_test.rb
+vendor/mocha-0.4.0/test/mocha/inspect_test.rb
+vendor/mocha-0.4.0/test/mocha/metaclass_test.rb
+vendor/mocha-0.4.0/test/mocha/mock_methods_test.rb
+vendor/mocha-0.4.0/test/mocha/mock_test.rb
+vendor/mocha-0.4.0/test/mocha/object_test.rb
+vendor/mocha-0.4.0/test/mocha/pretty_parameters_test.rb
+vendor/mocha-0.4.0/test/mocha/setup_and_teardown_test.rb
+vendor/mocha-0.4.0/test/mocha_acceptance_test.rb
+vendor/mocha-0.4.0/test/mocha_test_result_integration_test.rb
+vendor/mocha-0.4.0/test/standalone_acceptance_test.rb
+vendor/mocha-0.4.0/test/stubba_acceptance_test.rb
+vendor/mocha-0.4.0/test/stubba_integration_test.rb
+vendor/mocha-0.4.0/test/stubba_test_result_integration_test.rb
+vendor/mocha-0.4.0/test/test_helper.rb
+Manifest

data/README

@@ -0,0 +1,35 @@
+= Google::Geo
+
+A simple, elegant library for getting geocoding information from Google Maps. Very much inspired by the google-geocode gem, but completely dependency free!
+
+== Examples
+
+  geo = Google::Geo.new API_KEY
+
+  addresses = geo.locate '1600 Amphitheatre Parkway, Mountain View, CA'
+  
+  addresses.size # 1, :locate always returns an Array
+  
+  address = addresses.first
+
+  address.country      # 'US'
+  address.city         # 'Mountain View'
+  address.full_address # '1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA'
+
+  address.query        # '1600 Amphitheatre Parkway, Mountain View, CA'
+  address.accuracy     # 8
+
+In the case of sufficiently vague queries, Google::Geo will return more than one:
+
+  addresses = geo.locate 'hell'
+
+  addresses.size                # 2
+  addresses.map { |a| a.state } # ['PA', 'NC']
+
+== Contributors
+
+Seth Thomas Rasmussen - http://greatseth.com - sethrasmussen@gmail.com
+
+== License
+
+(c) 2007-2008 Seth Thomas Rasmussen and released under the WTFPL. See the LICENSE file for details.

data/Rakefile

@@ -0,0 +1,10 @@
+README = File.readlines "#{File.dirname __FILE__}/README"
+
+require "echoe"
+
+Echoe.new "google-geo" do |p|
+  p.author = "Seth Thomas Rasmussen"
+  p.email = "sethrasmussen@gmail.com"
+  p.url = "http://github.com/greatseth/google-geo"
+  p.summary = README[2]
+end

data/google-geo.gemspec

@@ -0,0 +1,139 @@
+
+# Gem::Specification for Google-geo-2.0
+# Originally generated by Echoe
+
+--- !ruby/object:Gem::Specification 
+name: google-geo
+version: !ruby/object:Gem::Version 
+  version: "2.0"
+platform: ruby
+authors: 
+- Seth Thomas Rasmussen
+autorequire: 
+bindir: bin
+
+date: 2008-08-06 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: A simple, elegant library for getting geocoding information from Google Maps. Very much inspired by the google-geocode gem, but completely dependency free!
+email: sethrasmussen@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- lib/google/geo.rb
+- LICENSE
+- README
+files: 
+- CHANGELOG
+- lib/google/geo.rb
+- LICENSE
+- Rakefile
+- README
+- test/fixtures/invalid_map_key.xml
+- test/fixtures/missing_address.xml
+- test/fixtures/server_error.xml
+- test/fixtures/success.xml
+- test/fixtures/success_with_multiple_addresses.xml
+- test/fixtures/too_many_queries.xml
+- test/fixtures/unavailable_address.xml
+- test/fixtures/unknown_address.xml
+- test/geo_test.rb
+- vendor/mocha-0.4.0/COPYING
+- vendor/mocha-0.4.0/examples/misc.rb
+- vendor/mocha-0.4.0/examples/mocha.rb
+- vendor/mocha-0.4.0/examples/stubba.rb
+- vendor/mocha-0.4.0/lib/mocha/any_instance_method.rb
+- vendor/mocha-0.4.0/lib/mocha/auto_verify.rb
+- vendor/mocha-0.4.0/lib/mocha/central.rb
+- vendor/mocha-0.4.0/lib/mocha/class_method.rb
+- vendor/mocha-0.4.0/lib/mocha/expectation.rb
+- vendor/mocha-0.4.0/lib/mocha/expectation_error.rb
+- vendor/mocha-0.4.0/lib/mocha/infinite_range.rb
+- vendor/mocha-0.4.0/lib/mocha/inspect.rb
+- vendor/mocha-0.4.0/lib/mocha/instance_method.rb
+- vendor/mocha-0.4.0/lib/mocha/metaclass.rb
+- vendor/mocha-0.4.0/lib/mocha/mock.rb
+- vendor/mocha-0.4.0/lib/mocha/mock_methods.rb
+- vendor/mocha-0.4.0/lib/mocha/object.rb
+- vendor/mocha-0.4.0/lib/mocha/pretty_parameters.rb
+- vendor/mocha-0.4.0/lib/mocha/setup_and_teardown.rb
+- vendor/mocha-0.4.0/lib/mocha/standalone.rb
+- vendor/mocha-0.4.0/lib/mocha/test_case_adapter.rb
+- vendor/mocha-0.4.0/lib/mocha.rb
+- vendor/mocha-0.4.0/lib/mocha_standalone.rb
+- vendor/mocha-0.4.0/lib/stubba.rb
+- vendor/mocha-0.4.0/MIT-LICENSE
+- vendor/mocha-0.4.0/Rakefile
+- vendor/mocha-0.4.0/README
+- vendor/mocha-0.4.0/RELEASE
+- vendor/mocha-0.4.0/test/active_record_test_case.rb
+- vendor/mocha-0.4.0/test/all_tests.rb
+- vendor/mocha-0.4.0/test/execution_point.rb
+- vendor/mocha-0.4.0/test/method_definer.rb
+- vendor/mocha-0.4.0/test/mocha/any_instance_method_test.rb
+- vendor/mocha-0.4.0/test/mocha/auto_verify_test.rb
+- vendor/mocha-0.4.0/test/mocha/central_test.rb
+- vendor/mocha-0.4.0/test/mocha/class_method_test.rb
+- vendor/mocha-0.4.0/test/mocha/expectation_test.rb
+- vendor/mocha-0.4.0/test/mocha/infinite_range_test.rb
+- vendor/mocha-0.4.0/test/mocha/inspect_test.rb
+- vendor/mocha-0.4.0/test/mocha/metaclass_test.rb
+- vendor/mocha-0.4.0/test/mocha/mock_methods_test.rb
+- vendor/mocha-0.4.0/test/mocha/mock_test.rb
+- vendor/mocha-0.4.0/test/mocha/object_test.rb
+- vendor/mocha-0.4.0/test/mocha/pretty_parameters_test.rb
+- vendor/mocha-0.4.0/test/mocha/setup_and_teardown_test.rb
+- vendor/mocha-0.4.0/test/mocha_acceptance_test.rb
+- vendor/mocha-0.4.0/test/mocha_test_result_integration_test.rb
+- vendor/mocha-0.4.0/test/standalone_acceptance_test.rb
+- vendor/mocha-0.4.0/test/stubba_acceptance_test.rb
+- vendor/mocha-0.4.0/test/stubba_integration_test.rb
+- vendor/mocha-0.4.0/test/stubba_test_result_integration_test.rb
+- vendor/mocha-0.4.0/test/test_helper.rb
+- Manifest
+- google-geo.gemspec
+has_rdoc: true
+homepage: http://github.com/greatseth/google-geo
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Google-geo
+- --main
+- README
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - "="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: google-geo
+rubygems_version: 1.2.0
+specification_version: 2
+summary: A simple, elegant library for getting geocoding information from Google Maps. Very much inspired by the google-geocode gem, but completely dependency free!
+test_files: 
+- test/geo_test.rb

data/lib/google/geo.rb

@@ -0,0 +1,194 @@
+require 'open-uri'
+
+module Google
+
+# = Google::Geo
+# 
+# A simple, elegant library for getting geocoding information from Google Maps. Very much inspired by the google-geocode gem, but completely dependency free!
+# 
+# == Examples
+# 
+#   geo = Google::Geo.new API_KEY
+# 
+#   addresses = geo.locate '1600 Amphitheatre Parkway, Mountain View, CA'
+#   
+#   addresses.size # 1, :locate always returns an Array
+#   
+#   address = addresses.first
+# 
+#   address.country      # 'US'
+#   address.city         # 'Mountain View'
+#   address.full_address # '1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA'
+# 
+#   address.query        # '1600 Amphitheatre Parkway, Mountain View, CA'
+#   address.accuracy     # 8
+# 
+# In the case of sufficiently vague queries, Google will return more than one address:
+# 
+#   addresses = geo.locate 'heaven'
+# 
+#   addresses.size                  # 2
+#   addresses.map { |a| a.state } # ['PA', 'NC']
+# 
+# == Contributors
+# 
+# Seth Thomas Rasmussen - http://greatseth.com - sethrasmussen@gmail.com
+class  Geo    
+  # API key provided by Google allowing access to the Geocode API
+  attr_accessor :key
+  
+  def initialize(key)
+    @key = key
+  end
+  
+  # Returns an array of Address objects, each with accessors for all the components of a location. 
+  # The query argument should be a string.
+  def locate(query)
+    xml = open(uri(query)).read
+    res = Response.new(xml, key)
+    
+    res.placemarks.map { |place| Address.new place, res.query }
+  end
+  
+  # Generate a request URI from a given search string.
+  def uri(address) #:nodoc:
+    "http://maps.google.com/maps/geo?q=#{URI.escape address}&key=#{key}&output=xml"
+  end
+  private :uri
+  
+  ###
+  
+  module Parser #:nodoc:
+    # Fetch contents of an XML element of the response.
+    def fetch(element) #:nodoc:
+      @xml.slice %r{<#{element}>(.+?)</#{element}>}, 1
+    end
+    
+    # Like fetch, but for the only piece of data locked away in an attribute.
+    def fetch_accuracy #:nodoc:
+      @xml.slice(%r{Accuracy="([^"]+)">}, 1).to_i
+    end
+  end
+  
+  ###
+  
+  # Represents locations returned in response to geocoding queries.
+  class Address
+    include Parser
+    
+    attr_reader :street
+    alias :thoroughfare :street
+    
+    attr_reader :city
+    alias :locality :city
+    
+    attr_reader :zip
+    alias :postal_code :zip
+    
+    attr_reader :county
+    alias :subadministrative_area :county
+    
+    attr_reader :state
+    alias :administrative_area :state
+    
+    attr_reader :country
+    alias :country_code :country
+    
+    # An array containing the standard three elements of a coordinate triple: latitude, longitude, elevation.
+    attr_reader :coordinates
+    
+    # A float, the standard first element of a coordinate triple.
+    attr_reader :longitude
+    alias :lng :longitude
+    
+    # A float, the standard second element of a coordinate triple.
+    attr_reader :latitude
+    alias :lat :latitude
+    
+    # A float, the standard third element of a coordinate triple.
+    attr_reader :elevation
+    
+    # An integer, Google's rating of the accuracy of the supplied address.
+    attr_reader :accuracy
+    
+    # All address attributes as one string, formatted by the service.
+    attr_reader :full_address
+    alias :to_s :full_address
+    
+    # The address query sent to the service. i.e. The user input.
+    attr_reader :query
+    
+    def initialize(placemark, query) #:nodoc
+      @xml   = placemark
+      @query = query
+      
+      {
+        :@street       => :ThoroughfareName,
+        :@city         => :LocalityName,
+        :@zip          => :PostalCodeNumber,
+        :@county       => :SubAdministrativeAreaName,
+        :@state        => :AdministrativeAreaName,
+        :@country      => :CountryNameCode,
+        
+        :@full_address => :address
+      }.each do |attribute, element|
+        instance_variable_set(attribute, (fetch(element) rescue nil))
+      end
+      
+      @longitude, @latitude, @elevation = @coordinates = fetch(:coordinates).split(',').map { |x| x.to_f }
+      
+      @accuracy = fetch_accuracy
+    end
+  end
+  
+  ###
+  
+  class Response #:nodoc:
+    include Parser
+    
+    attr_reader :query, :status, :placemarks
+    
+    def initialize(xml, geo_key) #:nodoc
+      @xml, @geo_key = xml, geo_key
+      
+      @query  = fetch(:name)
+      @status = fetch(:code).to_i
+      
+      check_for_errors
+      
+      @placemarks = @xml.scan %r{<Placemark(?: id="p\d+")?>.+?</Placemark>}m
+    end
+    
+    def check_for_errors #:nodoc:
+      case status
+        when 200 then # Success
+        when 500 then raise ServerError, "Unknown error from Google's server"
+        when 601 then raise MissingAddressError, "Missing address"
+        when 602 then raise UnknownAddressError, "Unknown address: #{@query}"
+        when 603 then raise UnavailableAddressError, "Unavailable address: #{@query}"
+        when 610 then raise InvalidMapKeyError, "Invalid map key: #{@geo_key}"
+        when 620 then raise TooManyQueriesError, "Too many queries for map key: #{@geo_key}"
+        else          raise UnknownError, "Unknown error: #{@status}"
+      end
+    end
+  end
+  
+  ###    
+  
+  class Error < Exception; end
+    
+  class ServerError  < Error; end
+    
+  class AddressError < Error; end
+  class MissingAddressError     < AddressError; end
+  class UnknownAddressError     < AddressError; end
+  class UnavailableAddressError < AddressError; end
+    
+  class MapKeyError < Error; end
+  class InvalidMapKeyError  < MapKeyError; end
+  class TooManyQueriesError < MapKeyError; end
+  
+  class UnknownError < Error; end
+end
+
+end

data/test/fixtures/invalid_map_key.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<kml xmlns="http://earth.google.com/kml/2.0">
+  <Response>
+    <name>1600 Amphitheater Pkwy, Mountain View, CA</name>
+    <Status>
+      <code>610</code>
+      <request>geocode</request>
+    </Status>
+  </Response>
+</kml>

data/test/fixtures/missing_address.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<kml xmlns="http://earth.google.com/kml/2.0">
+  <Response>
+    <name>1600</name>
+    <Status>
+      <code>601</code>
+      <request>geocode</request>
+    </Status>
+  </Response>
+</kml>

data/test/fixtures/server_error.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<kml xmlns="http://earth.google.com/kml/2.0">
+  <Response>
+    <name>1600 Amphitheater Pkwy, Mountain View, CA</name>
+    <Status>
+      <code>500</code>
+      <request>geocode</request>
+    </Status>
+  </Response>
+</kml>

data/test/fixtures/success.xml

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<kml xmlns="http://earth.google.com/kml/2.1">
+  <Response>
+    <name>1600 Amphitheatre Parkway, Mountain View, CA</name>
+    <Status>
+      <code>200</code>
+      <request>geocode</request>
+    </Status>
+    <Placemark>
+      <address>1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA</address>
+      <AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0" Accuracy="8">
+        <Country>
+          <CountryNameCode>US</CountryNameCode>
+          <AdministrativeArea>
+            <AdministrativeAreaName>CA</AdministrativeAreaName>
+            <SubAdministrativeArea>
+              <SubAdministrativeAreaName>Santa Clara</SubAdministrativeAreaName>
+              <Locality>
+                <LocalityName>Mountain View</LocalityName>
+                <Thoroughfare>
+                  <ThoroughfareName>1600 Amphitheatre Pkwy</ThoroughfareName>
+                </Thoroughfare>
+                <PostalCode>
+                  <PostalCodeNumber>94043</PostalCodeNumber>
+                </PostalCode>
+              </Locality>
+            </SubAdministrativeArea>
+          </AdministrativeArea>
+        </Country>
+      </AddressDetails>
+      <Point>
+        <coordinates>-122.083739,37.423021,0</coordinates>
+      </Point>
+    </Placemark>
+  </Response>
+</kml>

data/test/fixtures/success_with_multiple_addresses.xml

@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<kml xmlns="http://earth.google.com/kml/2.0">
+  <Response>
+    <name>heaven</name>
+    <Status>
+      <code>200</code>
+      <request>geocode</request>
+    </Status>
+    <Placemark id="p1">
+      <address>Heaven, Pottsville, PA 17901, USA</address>
+      <AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0" Accuracy="6">
+        <Country>
+          <CountryNameCode>US</CountryNameCode>
+          <AdministrativeArea>
+            <AdministrativeAreaName>PA</AdministrativeAreaName>
+            <SubAdministrativeArea>
+              <SubAdministrativeAreaName>Schuylkill</SubAdministrativeAreaName>
+              <Locality>
+                <LocalityName>Pottsville</LocalityName>
+                <Thoroughfare>
+                  <ThoroughfareName>Heaven</ThoroughfareName>
+                </Thoroughfare>
+                <PostalCode>
+                  <PostalCodeNumber>17901</PostalCodeNumber>
+                </PostalCode>
+              </Locality>
+            </SubAdministrativeArea>
+          </AdministrativeArea>
+        </Country>
+      </AddressDetails>
+      <Point>
+        <coordinates>-76.169968,40.650970,0</coordinates>
+      </Point>
+    </Placemark>
+    <Placemark id="p2">
+      <address>Heaven, Oakboro, NC 28129, USA</address>
+      <AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0" Accuracy="6">
+        <Country>
+          <CountryNameCode>US</CountryNameCode>
+          <AdministrativeArea>
+            <AdministrativeAreaName>NC</AdministrativeAreaName>
+            <SubAdministrativeArea>
+              <SubAdministrativeAreaName>Stanly</SubAdministrativeAreaName>
+              <Locality>
+                <LocalityName>Oakboro</LocalityName>
+                <Thoroughfare>
+                  <ThoroughfareName>Heaven</ThoroughfareName>
+                </Thoroughfare>
+                <PostalCode>
+                  <PostalCodeNumber>28129</PostalCodeNumber>
+                </PostalCode>
+              </Locality>
+            </SubAdministrativeArea>
+          </AdministrativeArea>
+        </Country>
+      </AddressDetails>
+      <Point>
+        <coordinates>-80.330399,35.254227,0</coordinates>
+      </Point>
+    </Placemark>
+  </Response>
+</kml>

data/test/fixtures/too_many_queries.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<kml xmlns="http://earth.google.com/kml/2.0">
+  <Response>
+    <name>1600 Amphitheater Pkwy, Mountain View, CA</name>
+    <Status>
+      <code>620</code>
+      <request>geocode</request>
+    </Status>
+  </Response>
+</kml>

data/test/fixtures/unavailable_address.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<kml xmlns="http://earth.google.com/kml/2.0">
+  <Response>
+    <name>42-44 Hanway Street, London</name>
+    <Status>
+      <code>603</code>
+      <request>geocode</request>
+    </Status>
+  </Response>
+</kml>

data/test/fixtures/unknown_address.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<kml xmlns="http://earth.google.com/kml/2.0">
+  <Response>
+    <name>1600</name>
+    <Status>
+      <code>602</code>
+      <request>geocode</request>
+    </Status>
+  </Response>
+</kml>