google-geo 2.1 → 2.3

data/CHANGELOG

@@ -1,6 +1,9 @@
-= 2.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.
-= 1.0 Initial Release
+v2.3. Fixed a bug with parsing accuracy. Thanks to David Vrensk!
+
+v2.2. Added reverse locate and optional street view embed features. Thanks to Fernando Barajas and Peter Gassner!
+
+v2.1. Added a LICENSE and RubyForge publishing support. Fixed Rakefile.
+
+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,18 @@
+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) 2008 Seth Thomas Rasmussen
+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,81 @@
+CHANGELOG
+LICENSE
+Manifest
+README.textile
+Rakefile
+google-geo.gemspec
+lib/google/geo.rb
+lib/google/geo/address.rb
+lib/google/geo/address/street_view.rb
+lib/google/geo/params.rb
+lib/google/geo/parser.rb
+lib/google/geo/response.rb
+script/test_street_view.rb
+test/fixtures/invalid_map_key.xml
+test/fixtures/missing_address.xml
+test/fixtures/reverse_locate_602.xml
+test/fixtures/reverse_locate_success.xml
+test/fixtures/server_error.xml
+test/fixtures/streetview_success.xml
+test/fixtures/success.xml
+test/fixtures/success_english.xml
+test/fixtures/success_german.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
+test/reverse_locate_test.rb
+test/test_helper.rb
+vendor/mocha-0.4.0/COPYING
+vendor/mocha-0.4.0/MIT-LICENSE
+vendor/mocha-0.4.0/README
+vendor/mocha-0.4.0/RELEASE
+vendor/mocha-0.4.0/Rakefile
+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.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_standalone.rb
+vendor/mocha-0.4.0/lib/stubba.rb
+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

data/README.textile

@@ -0,0 +1,57 @@
+h1. 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!
+
+h2. 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
+  address.coordinates  # [-122.084143, 37.421972, 0.0]
+
+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']
+
+You can reverse geocode:
+
+  address = geo.locate(33.998671, -118.075926).first
+  address.city          # => Pico Rivera
+  address.state         # => CA
+  address.zip           # => 90660
+  address.country       # => US
+  address.full_address  # => 4952-4958 Tobias Ave, Pico Rivera, CA 90660, USA
+
+You can optionally enable the ability to get street view embed HTML for an Address:
+
+  require "google/geo/address/street_view"
+  address.street_view_html :id => :street_view, :style => "width:640px; height:480px"
+
+h2. Options
+
+If you need to get the results in another language, you can set it like so:
+
+  geo = Google::Geo.new API_KEY, "de"
+  geo.language = "en"
+
+The language code can be anything listed on "http://spreadsheets.google.com/pub?key=p9pdwsai2hDMsLkXsoM05KQ&gid=1":http://spreadsheets.google.com/pub?key=p9pdwsai2hDMsLkXsoM05KQ&gid=1.
+
+h2. Contributors
+
+* Seth Thomas Rasmussen - "http://greatseth.com":http://greatseth.com
+* Fernando Barajas      - "http://fernyb.net":http://fernyb.net
+* Peter Gassner         - "http://www.naehrstoff.ch":http://www.naehrstoff.ch
+
+h2. License
+
+(c) 2007-2009 Seth Thomas Rasmussen and released under the WTFPL. See the LICENSE file for details.

data/Rakefile

@@ -0,0 +1,32 @@
+README = File.readlines "#{File.dirname __FILE__}/README.textile"
+
+require "echoe"
+
+class Echoe
+  def honor_gitignore!
+    self.ignore_pattern = \
+      Dir["**/.gitignore"].inject([]) do |pattern,gitignore| 
+        pattern.concat \
+          File.readlines(gitignore).
+            map    { |line| line.strip }.
+            reject { |line| "" == line }.
+            map    { |glob| 
+              d = File.dirname(gitignore)
+              d == "." ? glob : File.join(d, glob)
+            }
+      end.flatten.uniq
+  end
+end
+
+SPEC = 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]
+  p.honor_gitignore!
+end
+
+task :debug_spec do
+  require 'yaml'
+  y SPEC.to_yaml
+end

data/google-geo.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{google-geo}
+  s.version = "2.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Seth Thomas Rasmussen"]
+  s.date = %q{2009-11-19}
+  s.description = %q{A simple, elegant library for getting geocoding information from Google Maps. Very much inspired by the google-geocode gem, but completely dependency free!
+}
+  s.email = %q{sethrasmussen@gmail.com}
+  s.extra_rdoc_files = ["CHANGELOG", "LICENSE", "README.textile", "lib/google/geo.rb", "lib/google/geo/address.rb", "lib/google/geo/address/street_view.rb", "lib/google/geo/params.rb", "lib/google/geo/parser.rb", "lib/google/geo/response.rb"]
+  s.files = ["CHANGELOG", "LICENSE", "Manifest", "README.textile", "Rakefile", "google-geo.gemspec", "lib/google/geo.rb", "lib/google/geo/address.rb", "lib/google/geo/address/street_view.rb", "lib/google/geo/params.rb", "lib/google/geo/parser.rb", "lib/google/geo/response.rb", "script/test_street_view.rb", "test/fixtures/invalid_map_key.xml", "test/fixtures/missing_address.xml", "test/fixtures/reverse_locate_602.xml", "test/fixtures/reverse_locate_success.xml", "test/fixtures/server_error.xml", "test/fixtures/streetview_success.xml", "test/fixtures/success.xml", "test/fixtures/success_english.xml", "test/fixtures/success_german.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", "test/reverse_locate_test.rb", "test/test_helper.rb", "vendor/mocha-0.4.0/COPYING", "vendor/mocha-0.4.0/MIT-LICENSE", "vendor/mocha-0.4.0/README", "vendor/mocha-0.4.0/RELEASE", "vendor/mocha-0.4.0/Rakefile", "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.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_standalone.rb", "vendor/mocha-0.4.0/lib/stubba.rb", "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"]
+  s.homepage = %q{http://github.com/greatseth/google-geo}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Google-geo", "--main", "README.textile"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{google-geo}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{A simple, elegant library for getting geocoding information from Google Maps. Very much inspired by the google-geocode gem, but completely dependency free!}
+  s.test_files = ["test/geo_test.rb", "test/reverse_locate_test.rb", "test/test_helper.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/google/geo.rb

@@ -1,183 +1,48 @@
-require 'open-uri'
+require "open-uri"
+require "google/geo/params"
+require "google/geo/response"
+require "google/geo/address"
 
 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://sethrasmussen.com - sethrasmussen@gmail.com
-class  Geo    
+# Please see README for usage examples.
+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
+  attr_accessor :key, :language
   
-  # 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
+  # The last response received after a :locate call
+  attr_reader :last_response
+
+  # Google's XML files state that they are utf-8 encoded which is not true.
+  # Because they state this explicitly, I see no need to let users set
+  # another charset.
+  CHARSET = "utf-8"
+  def charset; CHARSET; end
   
-  ###
+  DEFAULT_LANGUAGE = "en"
   
-  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
+  def initialize(key, language = DEFAULT_LANGUAGE)
+    @key      = key
+    @language = language
   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
+  #   >> geo.locate "1600 Pennsylvania Ave"
+  # 
+  #   # reverse locate
+  #   >> geo.locate 33.998671, -118.075926
+  # 
+  # Returns an array of Address objects, 
+  # each with accessors for all the components of a location.
+  def locate(*params)
+    @last_response = Response.new(self, Params.new(self, *params))
+    @last_response.addresses
   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 ServerError     < Error; end
+  class BadRequestError < Error; end
     
   class AddressError < Error; end
   class MissingAddressError     < AddressError; end

data/lib/google/geo/address.rb

@@ -0,0 +1,75 @@
+require "google/geo/parser"
+
+module Google
+class  Geo
+# 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, geo) #:nodoc
+    @geo   = geo
+    @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
+end
+end

data/lib/google/geo/address/street_view.rb

@@ -0,0 +1,28 @@
+require "google/geo"
+
+module Google
+class  Geo
+class  Address
+  # This is a shady method which relies on an unofficial Google API.
+  # Use at your own risk!
+  def street_view_html(options = {})
+%{<embed id="#{options[:id] or 'google-geo-streetview'}"
+  style="#{options[:style]}"
+  src="http://maps.google.com/mapfiles/cb/googlepano.066.swf"
+  quality="high" wmode="opaque" swliveconnect="false"
+  allowscriptaccess="always" type="application/x-shockwave-flash"
+  pluginspage="http://www.macromedia.com/go/getflashplayer" 
+  scale="noscale" salign="lt"
+  flashvars="panoId=#{street_view_pano_id}&amp;directionMap=N:N,W:W,S:S,E:E,NW:NW,NE:NE,SW:SW,SE:SE&amp;yaw=0&amp;zoom=0&amp;browser=3&amp;pitch=5&amp;viewerId=1&amp;context=api&amp;animateOnLoad=false&amp;useSsl=false"
+></embed>}.gsub("\n", "").squeeze(" ")
+  end
+  
+private
+  def street_view_pano_id
+    url = "http://maps.google.com/cbk?output=xml&oe=utf-8&cb_client=api&ll=#{lat},#{lng}"
+    # "&callback=_xdc_._0fqdyf9p2"
+    open(url).read.slice(/pano_id="([^"]+)"/, 1)
+  end
+end
+end
+end

data/lib/google/geo/params.rb

@@ -0,0 +1,44 @@
+module Google
+class  Geo
+class  Params < Hash
+  def initialize(geo, *args)
+    @geo = geo
+    
+    params = { :key => @geo.key, :output => "xml", :hl => @geo.language, :oe => "utf-8" }
+    
+    query = case args.size
+    when 1
+      case args
+      when String then args
+      when Array  then args.join(",")
+      end
+    when 2
+      args.join(",")
+    else
+      raise ArgumentError, "dunno what to do with #{args.inspect}"
+    end
+    
+    params[:q] = query
+    
+    replace params
+  end
+  
+  def to_uri
+    uri = "http://maps.google.com/maps/geo?" <<
+      map { |k,v| "#{k}=#{URI.escape v.to_s}" }.join("&")
+    # puts uri
+    uri
+  end
+  
+  def extract_dimensions!
+    if size = delete(:size)
+      size.split("x")
+    elsif self[:width] and self[:height]
+      [delete(:width), delete(:height)]
+    else
+      [500, 300]
+    end
+  end
+end
+end
+end

data/lib/google/geo/parser.rb

@@ -0,0 +1,19 @@
+#:stopdoc:
+module Google
+class  Geo
+
+module Parser
+  # Fetch contents of an XML element of the response.
+  def fetch(element)
+    @xml.slice(%r{<#{element}>(.+?)</#{element}>}, 1)
+  end
+  
+  # Like fetch, but for the only piece of data locked away in an attribute.
+  def fetch_accuracy
+    @xml.slice(%r{Accuracy="([^"]+)"}, 1).to_i
+  end
+end
+
+end
+end
+#:startdoc:

data/lib/google/geo/response.rb

@@ -0,0 +1,43 @@
+require "google/geo/parser"
+
+#:stopdoc:
+module Google
+class  Geo
+
+class Response #:nodoc:
+  include Parser
+  
+  attr_reader :geo, :params, :xml, :query, :status
+  
+  def initialize(geo, params) #:nodoc
+    @geo = geo
+    
+    @params = params
+    @xml = open(params.to_uri).read
+    
+    @query  = fetch(:name)
+    @status = fetch(:code).to_i
+    
+    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}"
+      when 400 then raise BadRequestError, "Bad request: #{@status}"
+      else          raise UnknownError, "Unknown error: #{@status}"
+    end
+    
+    @placemarks = @xml.scan %r{<Placemark(?: id="p\d+")?>.+?</Placemark>}m
+  end
+  
+  def addresses
+    @placemarks.map { |p| Address.new p, @query, @geo }
+  end
+end
+
+end
+end
+#:startdoc:

data/script/test_street_view.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+
+load File.dirname(__FILE__) + "/../.irbrc"
+enable_street_view
+
+g = new_geo
+a = g.locate(*ARGV).first
+
+require "tempfile"
+
+p = File.expand_path "google-geo-streetview.html"
+
+File.open(p, "w") do |f|
+  html = a.street_view_html(
+    :id    => "TEST",
+    :style => "width:640px; height:480px"
+  )
+  f.puts html
+end
+
+raise "wtf" and exit unless File.exist? p
+
+require "rubygems"
+require "launchy"
+Launchy::Browser.run "file://#{p}"
+
+puts "created test file at #{p}"

data/test/fixtures/reverse_locate_602.xml

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

data/test/fixtures/reverse_locate_success.xml

@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<kml xmlns="http://earth.google.com/kml/2.0"><Response>
+  <name>33.998671,-118.075926</name>
+  <Status>
+    <code>200</code>
+    <request>geocode</request>
+  </Status>
+  <Placemark id="p1">
+    <address>4952-4958 Tobias Ave, Pico Rivera, CA 90660, USA</address>
+    <AddressDetails Accuracy="8" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"><Country><CountryNameCode>US</CountryNameCode><CountryName>USA</CountryName><AdministrativeArea><AdministrativeAreaName>CA</AdministrativeAreaName><Locality><LocalityName>Pico Rivera</LocalityName><Thoroughfare><ThoroughfareName>4952-4958 Tobias Ave</ThoroughfareName></Thoroughfare><PostalCode><PostalCodeNumber>90660</PostalCodeNumber></PostalCode></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox north="34.0018448" south="33.9955496" east="-118.0728908" west="-118.0791860" />
+    </ExtendedData>
+    <Point><coordinates>-118.0760384,33.9986972,0</coordinates></Point>
+  </Placemark>
+  <Placemark id="p2">
+    <address>Pico Rivera, CA 90660, USA</address>
+    <AddressDetails Accuracy="5" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"><Country><CountryNameCode>US</CountryNameCode><CountryName>USA</CountryName><AdministrativeArea><AdministrativeAreaName>CA</AdministrativeAreaName><Locality><LocalityName>Pico Rivera</LocalityName><PostalCode><PostalCodeNumber>90660</PostalCodeNumber></PostalCode></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox north="34.0230350" south="33.9502470" east="-118.0515550" west="-118.1211040" />
+    </ExtendedData>
+    <Point><coordinates>-118.0947106,33.9870228,0</coordinates></Point>
+  </Placemark>
+  <Placemark id="p3">
+    <address>Pico Rivera, CA, USA</address>
+    <AddressDetails Accuracy="4" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"><Country><CountryNameCode>US</CountryNameCode><CountryName>USA</CountryName><AdministrativeArea><AdministrativeAreaName>CA</AdministrativeAreaName><Locality><LocalityName>Pico Rivera</LocalityName></Locality></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox north="34.0303260" south="33.9504570" east="-118.0386930" west="-118.1230050" />
+    </ExtendedData>
+    <Point><coordinates>-118.0838360,34.0014100,0</coordinates></Point>
+  </Placemark>
+  <Placemark id="p4">
+    <address>Whittier, California, USA</address>
+    <AddressDetails Accuracy="4" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"><Country><CountryNameCode>US</CountryNameCode><CountryName>USA</CountryName><AdministrativeArea><AdministrativeAreaName>CA</AdministrativeAreaName><AddressLine>Whittier</AddressLine></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox north="34.0338340" south="33.8733970" east="-117.9152740" west="-118.1227020" />
+    </ExtendedData>
+    <Point><coordinates>-118.0420282,33.9743790,0</coordinates></Point>
+  </Placemark>
+  <Placemark id="p5">
+    <address>Los Angeles, California, USA</address>
+    <AddressDetails Accuracy="3" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"><Country><CountryNameCode>US</CountryNameCode><CountryName>USA</CountryName><AdministrativeArea><AdministrativeAreaName>CA</AdministrativeAreaName><AddressLine>Los Angeles</AddressLine></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox north="34.8232710" south="32.7500400" east="-117.6457480" west="-118.9517210" />
+    </ExtendedData>
+    <Point><coordinates>-118.1122679,34.3871821,0</coordinates></Point>
+  </Placemark>
+  <Placemark id="p6">
+    <address>California, USA</address>
+    <AddressDetails Accuracy="2" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"><Country><CountryNameCode>US</CountryNameCode><CountryName>USA</CountryName><AdministrativeArea><AdministrativeAreaName>CA</AdministrativeAreaName></AdministrativeArea></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox north="42.0095190" south="32.5288320" east="-114.1312120" west="-124.4820030" />
+    </ExtendedData>
+    <Point><coordinates>-119.4179324,36.7782610,0</coordinates></Point>
+  </Placemark>
+  <Placemark id="p7">
+    <address>United States</address>
+    <AddressDetails Accuracy="1" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"><Country><CountryNameCode>US</CountryNameCode><CountryName>USA</CountryName></Country></AddressDetails>
+    <ExtendedData>
+      <LatLonBox north="71.4343570" south="17.8315100" east="-65.1685040" west="172.3478480" />
+    </ExtendedData>
+    <Point><coordinates>-95.7128910,37.0902400,0</coordinates></Point>
+  </Placemark>
+</Response></kml>

data/test/fixtures/streetview_success.xml

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8" ?><panorama><data_properties image_width="3328" image_height="1664" tile_width="512" tile_height="512" pano_id="R-9UTGfykhiRU89z1P466Q" num_zoom_levels="3" lat="34.154961" lng="-118.255140" ><copyright>© 2009 Google</copyright><text>N Brand Blvd</text><street_range>605</street_range><region>Glendale, CA</region><country>United States</country></data_properties><projection_properties projection_type="spherical" pano_yaw_deg="178.54" tilt_yaw_deg="22.31" tilt_pitch_deg="1.75" /><annotation_properties ><link yaw_deg="353.56" pano_id="tMLR2xMOaxaZbTifZ9VWyw" road_argb="0x80fffa73" ><link_text>N Brand Blvd</link_text></link><link yaw_deg="173.56" pano_id="WPiYdHCB20PymRorUYeWIQ" road_argb="0x80fffa73" ><link_text>N Brand Blvd</link_text></link></annotation_properties></panorama>

data/test/fixtures/success.xml

@@ -8,7 +8,7 @@
     </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">
+      <AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0" Accuracy="8" foo="bar">
         <Country>
           <CountryNameCode>US</CountryNameCode>
           <AdministrativeArea>

data/test/fixtures/success_english.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<kml xmlns="http://earth.google.com/kml/2.0">
+  <Response>
+    <name>Zürich, Schweiz</name>
+    <Status>
+      <code>200</code>
+      <request>geocode</request>
+    </Status>
+    <Placemark id="p1">
+      <address>Zürich, Switzerland</address>
+      <AddressDetails Accuracy="4" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">
+        <Country>
+          <CountryNameCode>CH</CountryNameCode>
+          <CountryName>Switzerland</CountryName>
+          <AdministrativeArea>
+            <AdministrativeAreaName>Zurich</AdministrativeAreaName>
+            <SubAdministrativeArea>
+              <SubAdministrativeAreaName>Zurich</SubAdministrativeAreaName>
+              <Locality>
+                <LocalityName>Zürich</LocalityName>
+              </Locality>
+            </SubAdministrativeArea>
+          </AdministrativeArea>
+        </Country>
+      </AddressDetails>
+      <ExtendedData>
+        <LatLonBox north="47.4347210" south="47.3201830" east="8.6254420" west="8.4480810" />
+      </ExtendedData>
+      <Point>
+        <coordinates>8.5380326,47.3690239,0</coordinates>
+      </Point>
+    </Placemark>
+  </Response>
+</kml>

data/test/fixtures/success_german.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<kml xmlns="http://earth.google.com/kml/2.0">
+  <Response>
+    <name>Zürich, Schweiz</name>
+    <Status>
+      <code>200</code>
+      <request>geocode</request>
+    </Status>
+    <Placemark id="p1">
+      <address>Zürich, Schweiz</address>
+      <AddressDetails Accuracy="4" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">
+        <Country>
+          <CountryNameCode>CH</CountryNameCode>
+          <CountryName>Schweiz</CountryName>
+          <AdministrativeArea>
+            <AdministrativeAreaName>Zürich</AdministrativeAreaName>
+            <SubAdministrativeArea>
+              <SubAdministrativeAreaName>Zürich</SubAdministrativeAreaName>
+              <Locality>
+                <LocalityName>Zürich</LocalityName>
+              </Locality>
+            </SubAdministrativeArea>
+          </AdministrativeArea>
+        </Country>
+      </AddressDetails>
+      <ExtendedData>
+        <LatLonBox north="47.4347210" south="47.3201830" east="8.6254420" west="8.4480810" />
+      </ExtendedData>
+      <Point>
+        <coordinates>8.5380326,47.3690239,0</coordinates>
+      </Point>
+    </Placemark>
+  </Response>
+</kml>

data/test/geo_test.rb

@@ -1,18 +1,14 @@
-require 'test/unit'
-$:.unshift "#{File.dirname __FILE__}/../vendor/mocha-0.4.0/lib"
-require 'mocha'
-require "#{File.dirname __FILE__}/../lib/google/geo"
+require "test_helper"
 
-class Google::GeoTest < Test::Unit::TestCase  
+class GeoTest < Test::Unit::TestCase  
   def setup    
     @geo = Google::Geo.new 'API_KEY'
   end
 
   def test_success
-    @geo.expects(:open).
+    stub_response! :success
          # show that query is escaped
-         with("http://maps.google.com/maps/geo?q=1600%20Amphitheatre%20Parkway,%20Mountain%20View,%20CA&key=API_KEY&output=xml").
-         returns(response(:success))
+         # with("http://maps.google.com/maps/geo?q=1600%20Amphitheatre%20Parkway,%20Mountain%20View,%20CA&key=API_KEY&output=xml&hl=en&oe=utf-8").
     
     query = '1600 Amphitheatre Parkway, Mountain View, CA'
     
@@ -53,7 +49,7 @@ class Google::GeoTest < Test::Unit::TestCase
   end
   
   def test_success_with_multiple_addresses
-    @geo.expects(:open).returns(response(:success_with_multiple_addresses))
+    stub_response! :success_with_multiple_addresses
     
     heavens = @geo.locate('heaven')
     
@@ -64,39 +60,55 @@ class Google::GeoTest < Test::Unit::TestCase
     
     heavens.each { |h| assert_kind_of Google::Geo::Address, h }
   end
-
+  
+  def test_has_an_accessible_language_attribute_defaulting_to_english
+    assert_equal 'en', @geo.language
+    @geo.language = 'de'
+    assert_equal 'de', @geo.language
+  end
+  
+  def test_can_get_results_in_german
+    stub_response! :success_german
+         # with("http://maps.google.com/maps/geo?q=Z%C3%BCrich,%20Schweiz&key=API_KEY&output=xml&hl=de&oe=utf-8").
+    @geo.language = 'de'
+    address = @geo.locate('Zürich, Schweiz').first
+    assert_equal 'Zürich, Schweiz', address.full_address
+  end
+  
+  def test_gets_english_results_by_default
+    stub_response! :success_english
+         # with("http://maps.google.com/maps/geo?q=Z%C3%BCrich,%20Schweiz&key=API_KEY&output=xml&hl=en&oe=utf-8").
+    address = @geo.locate('Zürich, Schweiz').first
+    assert_equal 'Zürich, Switzerland', address.full_address
+  end
+  
   def test_invalid_map_key
-    @geo.expects(:open).returns(response(:invalid_map_key))
+    stub_response! :invalid_map_key
     assert_raises(Google::Geo::InvalidMapKeyError) { @geo.locate 'foo' }
   end
 
   def test_missing_address
-    @geo.expects(:open).returns(response(:missing_address))
+    stub_response! :missing_address
     assert_raises(Google::Geo::MissingAddressError) { @geo.locate 'foo' }
   end
 
   def test_server_error
-    @geo.expects(:open).returns(response(:server_error))
+    stub_response! :server_error
     assert_raises(Google::Geo::ServerError) { @geo.locate 'foo' }
   end
 
   def test_too_many_queries
-    @geo.expects(:open).returns(response(:too_many_queries))    
+    stub_response! :too_many_queries    
     assert_raises(Google::Geo::TooManyQueriesError) { @geo.locate 'foo' }
   end
 
   def test_unavailable_address
-    @geo.expects(:open).returns(response(:unavailable_address))
+    stub_response! :unavailable_address
     assert_raises(Google::Geo::UnavailableAddressError) { @geo.locate 'foo' }
   end
 
   def test_unknown_address
-    @geo.expects(:open).returns(response(:unknown_address))
+    stub_response! :unknown_address
     assert_raises(Google::Geo::UnknownAddressError) { @geo.locate 'foo' }
   end
-  
-private
-  def response(filename)
-    File.new "#{File.dirname __FILE__}/fixtures/#{filename}.xml"
-  end
 end

data/test/reverse_locate_test.rb

@@ -0,0 +1,64 @@
+require "test_helper"
+
+class ReverseLocateTest < Test::Unit::TestCase  
+  def setup    
+    @geo = Google::Geo.new 'API_KEY'
+  end
+  
+  def test_should_locate_with_latlon
+    stub_response! :reverse_locate_success
+    # with("http://maps.google.com/maps/geo?ll=33.998671,-118.075926&key=API_KEY&output=xml&hl=en&oe=utf-8").
+    
+    location = @geo.locate(33.998671, -118.075926)
+
+    address = location.first
+    
+    assert_equal 33.9986972, address.latitude
+    assert_equal -118.0760384, address.longitude
+    
+    assert_equal address.longitude, address.lng
+    assert_equal address.latitude, address.lat
+  end
+  
+  def test_should_have_city
+    stub_response! :reverse_locate_success
+    location = @geo.locate(33.998671, -118.075926)
+    address = location.first
+    assert_equal "Pico Rivera", address.city
+  end  
+  
+  def test_should_have_two_letter_state
+    stub_response! :reverse_locate_success
+    location = @geo.locate(33.998671, -118.075926)
+    address = location.first
+    assert_equal "CA", address.state
+  end
+  
+  def test_should_have_zipcode
+    stub_response! :reverse_locate_success
+    location = @geo.locate(33.998671, -118.075926)
+    address = location.first
+    assert_equal "90660", address.zip
+  end
+  
+  def test_should_have_country
+    stub_response! :reverse_locate_success
+    location = @geo.locate(33.998671, -118.075926)
+    address = location.first
+    assert_equal "US", address.country 
+  end
+  
+  def test_should_have_full_address
+    stub_response! :reverse_locate_success
+    location = @geo.locate(33.998671, -118.075926)
+    address = location.first
+    assert_equal "4952-4958 Tobias Ave, Pico Rivera, CA 90660, USA", address.full_address
+  end
+  
+  def test_should_raise_error_when_unknown_address
+    stub_response! :reverse_locate_602
+    assert_raise Google::Geo::UnknownAddressError do
+      @geo.locate(0, 0)
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,23 @@
+here = File.dirname __FILE__
+
+["vendor/mocha-0.4.0/lib", "lib"].each do |path|
+  p = "#{here}/../#{path}"
+  $:.unshift p unless $:.include? p
+end
+
+require "test/unit"
+require "mocha"
+require "google/geo"
+
+begin; require "rubygems"; require "redgreen"; rescue LoadError; end
+
+class Test::Unit::TestCase
+  def response(filename)
+    File.open "#{File.dirname __FILE__}/fixtures/#{filename}.xml"
+  end
+  
+  def stub_response!(name)
+    Google::Geo::Response.any_instance.
+      expects(:open).returns(response(name))
+  end
+end

metadata

@@ -1,50 +1,75 @@
 --- !ruby/object:Gem::Specification 
 name: google-geo
 version: !ruby/object:Gem::Version 
-  version: "2.1"
+  version: "2.3"
 platform: ruby
 authors: 
-- |
-  
-
+- Seth Thomas Rasmussen
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2008-02-11 00:00:00 -08:00
+date: 2009-11-19 00:00:00 -05:00
 default_executable: 
 dependencies: []
 
-description: 
-email: 
+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: 
-- README
 - CHANGELOG
+- LICENSE
+- README.textile
+- lib/google/geo.rb
+- lib/google/geo/address.rb
+- lib/google/geo/address/street_view.rb
+- lib/google/geo/params.rb
+- lib/google/geo/parser.rb
+- lib/google/geo/response.rb
 files: 
-- lib/google
+- CHANGELOG
+- LICENSE
+- Manifest
+- README.textile
+- Rakefile
+- google-geo.gemspec
 - lib/google/geo.rb
-- test/fixtures
+- lib/google/geo/address.rb
+- lib/google/geo/address/street_view.rb
+- lib/google/geo/params.rb
+- lib/google/geo/parser.rb
+- lib/google/geo/response.rb
+- script/test_street_view.rb
 - test/fixtures/invalid_map_key.xml
 - test/fixtures/missing_address.xml
+- test/fixtures/reverse_locate_602.xml
+- test/fixtures/reverse_locate_success.xml
 - test/fixtures/server_error.xml
+- test/fixtures/streetview_success.xml
 - test/fixtures/success.xml
+- test/fixtures/success_english.xml
+- test/fixtures/success_german.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
+- test/reverse_locate_test.rb
+- test/test_helper.rb
 - vendor/mocha-0.4.0/COPYING
-- vendor/mocha-0.4.0/examples
+- vendor/mocha-0.4.0/MIT-LICENSE
+- vendor/mocha-0.4.0/README
+- vendor/mocha-0.4.0/RELEASE
+- vendor/mocha-0.4.0/Rakefile
 - 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
-- vendor/mocha-0.4.0/lib/mocha
+- vendor/mocha-0.4.0/lib/mocha.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
@@ -62,19 +87,12 @@ files:
 - 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
 - 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
 - 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
@@ -95,13 +113,18 @@ files:
 - 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
-- README
-- CHANGELOG
 has_rdoc: true
-homepage: 
-post_install_message: 
-rdoc_options: []
+homepage: http://github.com/greatseth/google-geo
+licenses: []
 
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Google-geo
+- --main
+- README.textile
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -114,14 +137,16 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      version: "0"
+      version: "1.2"
   version: 
 requirements: []
 
-rubyforge_project: 
-rubygems_version: 1.0.1
+rubyforge_project: google-geo
+rubygems_version: 1.3.5
 signing_key: 
-specification_version: 2
+specification_version: 3
 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
+- test/reverse_locate_test.rb
+- test/test_helper.rb

data/README

@@ -1,35 +0,0 @@
-= 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://sethrasmussen.com - sethrasmussen@gmail.com
-
-== License
-
-See LICENSE file.