google-geo 2.1 → 2.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (24) hide show
  1. data/CHANGELOG +9 -6
  2. data/LICENSE +18 -0
  3. data/Manifest +81 -0
  4. data/README.textile +57 -0
  5. data/Rakefile +32 -0
  6. data/google-geo.gemspec +32 -0
  7. data/lib/google/geo.rb +31 -166
  8. data/lib/google/geo/address.rb +75 -0
  9. data/lib/google/geo/address/street_view.rb +28 -0
  10. data/lib/google/geo/params.rb +44 -0
  11. data/lib/google/geo/parser.rb +19 -0
  12. data/lib/google/geo/response.rb +43 -0
  13. data/script/test_street_view.rb +27 -0
  14. data/test/fixtures/reverse_locate_602.xml +10 -0
  15. data/test/fixtures/reverse_locate_success.xml +64 -0
  16. data/test/fixtures/streetview_success.xml +1 -0
  17. data/test/fixtures/success.xml +1 -1
  18. data/test/fixtures/success_english.xml +34 -0
  19. data/test/fixtures/success_german.xml +34 -0
  20. data/test/geo_test.rb +33 -21
  21. data/test/reverse_locate_test.rb +64 -0
  22. data/test/test_helper.rb +23 -0
  23. metadata +55 -30
  24. data/README +0 -35
data/CHANGELOG CHANGED
@@ -1,6 +1,9 @@
1
- = 2.0 Multiple Addresses (and tests you can actually run!)
2
- - Not insignificant API change: *** Google::Geo#locate ALWAYS RETURNS AN ARRAY ***
3
- - There are now some nice examples in the README.
4
- - Updated to include the fixtures and vendor dependencies for tests, yeknow, so you can actually run them.
5
- - No namby pamby point releases. This is serious, folks.
6
- = 1.0 Initial Release
1
+ v2.3. Fixed a bug with parsing accuracy. Thanks to David Vrensk!
2
+
3
+ v2.2. Added reverse locate and optional street view embed features. Thanks to Fernando Barajas and Peter Gassner!
4
+
5
+ v2.1. Added a LICENSE and RubyForge publishing support. Fixed Rakefile.
6
+
7
+ 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.
8
+
9
+ v1.0. Initial Release
data/LICENSE ADDED
@@ -0,0 +1,18 @@
1
+ This program is free software. It comes without any warranty, to
2
+ the extent permitted by applicable law. You can redistribute it
3
+ and/or modify it under the terms of the Do What The Fuck You Want
4
+ To Public License, Version 2, as published by Sam Hocevar. See
5
+ http://sam.zoy.org/wtfpl/COPYING for more details.
6
+
7
+ DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
8
+ Version 2, December 2004
9
+
10
+ Copyright (C) 2008 Seth Thomas Rasmussen
11
+ Everyone is permitted to copy and distribute verbatim or modified
12
+ copies of this license document, and changing it is allowed as long
13
+ as the name is changed.
14
+
15
+ DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
16
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
17
+
18
+ 0. You just DO WHAT THE FUCK YOU WANT TO.
data/Manifest ADDED
@@ -0,0 +1,81 @@
1
+ CHANGELOG
2
+ LICENSE
3
+ Manifest
4
+ README.textile
5
+ Rakefile
6
+ google-geo.gemspec
7
+ lib/google/geo.rb
8
+ lib/google/geo/address.rb
9
+ lib/google/geo/address/street_view.rb
10
+ lib/google/geo/params.rb
11
+ lib/google/geo/parser.rb
12
+ lib/google/geo/response.rb
13
+ script/test_street_view.rb
14
+ test/fixtures/invalid_map_key.xml
15
+ test/fixtures/missing_address.xml
16
+ test/fixtures/reverse_locate_602.xml
17
+ test/fixtures/reverse_locate_success.xml
18
+ test/fixtures/server_error.xml
19
+ test/fixtures/streetview_success.xml
20
+ test/fixtures/success.xml
21
+ test/fixtures/success_english.xml
22
+ test/fixtures/success_german.xml
23
+ test/fixtures/success_with_multiple_addresses.xml
24
+ test/fixtures/too_many_queries.xml
25
+ test/fixtures/unavailable_address.xml
26
+ test/fixtures/unknown_address.xml
27
+ test/geo_test.rb
28
+ test/reverse_locate_test.rb
29
+ test/test_helper.rb
30
+ vendor/mocha-0.4.0/COPYING
31
+ vendor/mocha-0.4.0/MIT-LICENSE
32
+ vendor/mocha-0.4.0/README
33
+ vendor/mocha-0.4.0/RELEASE
34
+ vendor/mocha-0.4.0/Rakefile
35
+ vendor/mocha-0.4.0/examples/misc.rb
36
+ vendor/mocha-0.4.0/examples/mocha.rb
37
+ vendor/mocha-0.4.0/examples/stubba.rb
38
+ vendor/mocha-0.4.0/lib/mocha.rb
39
+ vendor/mocha-0.4.0/lib/mocha/any_instance_method.rb
40
+ vendor/mocha-0.4.0/lib/mocha/auto_verify.rb
41
+ vendor/mocha-0.4.0/lib/mocha/central.rb
42
+ vendor/mocha-0.4.0/lib/mocha/class_method.rb
43
+ vendor/mocha-0.4.0/lib/mocha/expectation.rb
44
+ vendor/mocha-0.4.0/lib/mocha/expectation_error.rb
45
+ vendor/mocha-0.4.0/lib/mocha/infinite_range.rb
46
+ vendor/mocha-0.4.0/lib/mocha/inspect.rb
47
+ vendor/mocha-0.4.0/lib/mocha/instance_method.rb
48
+ vendor/mocha-0.4.0/lib/mocha/metaclass.rb
49
+ vendor/mocha-0.4.0/lib/mocha/mock.rb
50
+ vendor/mocha-0.4.0/lib/mocha/mock_methods.rb
51
+ vendor/mocha-0.4.0/lib/mocha/object.rb
52
+ vendor/mocha-0.4.0/lib/mocha/pretty_parameters.rb
53
+ vendor/mocha-0.4.0/lib/mocha/setup_and_teardown.rb
54
+ vendor/mocha-0.4.0/lib/mocha/standalone.rb
55
+ vendor/mocha-0.4.0/lib/mocha/test_case_adapter.rb
56
+ vendor/mocha-0.4.0/lib/mocha_standalone.rb
57
+ vendor/mocha-0.4.0/lib/stubba.rb
58
+ vendor/mocha-0.4.0/test/active_record_test_case.rb
59
+ vendor/mocha-0.4.0/test/all_tests.rb
60
+ vendor/mocha-0.4.0/test/execution_point.rb
61
+ vendor/mocha-0.4.0/test/method_definer.rb
62
+ vendor/mocha-0.4.0/test/mocha/any_instance_method_test.rb
63
+ vendor/mocha-0.4.0/test/mocha/auto_verify_test.rb
64
+ vendor/mocha-0.4.0/test/mocha/central_test.rb
65
+ vendor/mocha-0.4.0/test/mocha/class_method_test.rb
66
+ vendor/mocha-0.4.0/test/mocha/expectation_test.rb
67
+ vendor/mocha-0.4.0/test/mocha/infinite_range_test.rb
68
+ vendor/mocha-0.4.0/test/mocha/inspect_test.rb
69
+ vendor/mocha-0.4.0/test/mocha/metaclass_test.rb
70
+ vendor/mocha-0.4.0/test/mocha/mock_methods_test.rb
71
+ vendor/mocha-0.4.0/test/mocha/mock_test.rb
72
+ vendor/mocha-0.4.0/test/mocha/object_test.rb
73
+ vendor/mocha-0.4.0/test/mocha/pretty_parameters_test.rb
74
+ vendor/mocha-0.4.0/test/mocha/setup_and_teardown_test.rb
75
+ vendor/mocha-0.4.0/test/mocha_acceptance_test.rb
76
+ vendor/mocha-0.4.0/test/mocha_test_result_integration_test.rb
77
+ vendor/mocha-0.4.0/test/standalone_acceptance_test.rb
78
+ vendor/mocha-0.4.0/test/stubba_acceptance_test.rb
79
+ vendor/mocha-0.4.0/test/stubba_integration_test.rb
80
+ vendor/mocha-0.4.0/test/stubba_test_result_integration_test.rb
81
+ vendor/mocha-0.4.0/test/test_helper.rb
data/README.textile ADDED
@@ -0,0 +1,57 @@
1
+ h1. Google::Geo
2
+
3
+ A simple, elegant library for getting geocoding information from Google Maps. Very much inspired by the google-geocode gem, but completely dependency free!
4
+
5
+ h2. Examples
6
+
7
+ geo = Google::Geo.new API_KEY
8
+
9
+ addresses = geo.locate '1600 Amphitheatre Parkway, Mountain View, CA'
10
+ addresses.size # 1, :locate always returns an Array
11
+
12
+ address = addresses.first
13
+ address.country # 'US'
14
+ address.city # 'Mountain View'
15
+ address.full_address # '1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA'
16
+ address.query # '1600 Amphitheatre Parkway, Mountain View, CA'
17
+ address.accuracy # 8
18
+ address.coordinates # [-122.084143, 37.421972, 0.0]
19
+
20
+ In the case of sufficiently vague queries, Google::Geo will return more than one:
21
+
22
+ addresses = geo.locate 'hell'
23
+ addresses.size # 2
24
+ addresses.map { |a| a.state } # ['PA', 'NC']
25
+
26
+ You can reverse geocode:
27
+
28
+ address = geo.locate(33.998671, -118.075926).first
29
+ address.city # => Pico Rivera
30
+ address.state # => CA
31
+ address.zip # => 90660
32
+ address.country # => US
33
+ address.full_address # => 4952-4958 Tobias Ave, Pico Rivera, CA 90660, USA
34
+
35
+ You can optionally enable the ability to get street view embed HTML for an Address:
36
+
37
+ require "google/geo/address/street_view"
38
+ address.street_view_html :id => :street_view, :style => "width:640px; height:480px"
39
+
40
+ h2. Options
41
+
42
+ If you need to get the results in another language, you can set it like so:
43
+
44
+ geo = Google::Geo.new API_KEY, "de"
45
+ geo.language = "en"
46
+
47
+ 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.
48
+
49
+ h2. Contributors
50
+
51
+ * Seth Thomas Rasmussen - "http://greatseth.com":http://greatseth.com
52
+ * Fernando Barajas - "http://fernyb.net":http://fernyb.net
53
+ * Peter Gassner - "http://www.naehrstoff.ch":http://www.naehrstoff.ch
54
+
55
+ h2. License
56
+
57
+ (c) 2007-2009 Seth Thomas Rasmussen and released under the WTFPL. See the LICENSE file for details.
data/Rakefile ADDED
@@ -0,0 +1,32 @@
1
+ README = File.readlines "#{File.dirname __FILE__}/README.textile"
2
+
3
+ require "echoe"
4
+
5
+ class Echoe
6
+ def honor_gitignore!
7
+ self.ignore_pattern = \
8
+ Dir["**/.gitignore"].inject([]) do |pattern,gitignore|
9
+ pattern.concat \
10
+ File.readlines(gitignore).
11
+ map { |line| line.strip }.
12
+ reject { |line| "" == line }.
13
+ map { |glob|
14
+ d = File.dirname(gitignore)
15
+ d == "." ? glob : File.join(d, glob)
16
+ }
17
+ end.flatten.uniq
18
+ end
19
+ end
20
+
21
+ SPEC = Echoe.new "google-geo" do |p|
22
+ p.author = "Seth Thomas Rasmussen"
23
+ p.email = "sethrasmussen@gmail.com"
24
+ p.url = "http://github.com/greatseth/google-geo"
25
+ p.summary = README[2]
26
+ p.honor_gitignore!
27
+ end
28
+
29
+ task :debug_spec do
30
+ require 'yaml'
31
+ y SPEC.to_yaml
32
+ end
data/google-geo.gemspec ADDED
@@ -0,0 +1,32 @@
1
+ # -*- encoding: utf-8 -*-
2
+
3
+ Gem::Specification.new do |s|
4
+ s.name = %q{google-geo}
5
+ s.version = "2.3"
6
+
7
+ s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
8
+ s.authors = ["Seth Thomas Rasmussen"]
9
+ s.date = %q{2009-11-19}
10
+ 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!
11
+ }
12
+ s.email = %q{sethrasmussen@gmail.com}
13
+ 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"]
14
+ 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"]
15
+ s.homepage = %q{http://github.com/greatseth/google-geo}
16
+ s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Google-geo", "--main", "README.textile"]
17
+ s.require_paths = ["lib"]
18
+ s.rubyforge_project = %q{google-geo}
19
+ s.rubygems_version = %q{1.3.5}
20
+ 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!}
21
+ s.test_files = ["test/geo_test.rb", "test/reverse_locate_test.rb", "test/test_helper.rb"]
22
+
23
+ if s.respond_to? :specification_version then
24
+ current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
25
+ s.specification_version = 3
26
+
27
+ if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
28
+ else
29
+ end
30
+ else
31
+ end
32
+ end
data/lib/google/geo.rb CHANGED
@@ -1,183 +1,48 @@
1
- require 'open-uri'
1
+ require "open-uri"
2
+ require "google/geo/params"
3
+ require "google/geo/response"
4
+ require "google/geo/address"
2
5
 
3
6
  module Google
4
-
5
- # = Google::Geo
6
- #
7
- # A simple, elegant library for getting geocoding information from Google Maps. Very much inspired by the google-geocode gem, but completely dependency free!
8
- #
9
- # == Examples
10
- #
11
- # geo = Google::Geo.new API_KEY
12
- #
13
- # addresses = geo.locate '1600 Amphitheatre Parkway, Mountain View, CA'
14
- #
15
- # addresses.size # 1, :locate always returns an Array
16
- #
17
- # address = addresses.first
18
- #
19
- # address.country # 'US'
20
- # address.city # 'Mountain View'
21
- # address.full_address # '1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA'
22
- #
23
- # address.query # '1600 Amphitheatre Parkway, Mountain View, CA'
24
- # address.accuracy # 8
25
- #
26
- # In the case of sufficiently vague queries, Google will return more than one address:
27
- #
28
- # addresses = geo.locate 'heaven'
29
- #
30
- # addresses.size # 2
31
- # addresses.map { |a| a.state } # ['PA', 'NC']
32
- #
33
- # == Contributors
34
- #
35
- # Seth Thomas Rasmussen - http://sethrasmussen.com - sethrasmussen@gmail.com
36
- class Geo
7
+ # Please see README for usage examples.
8
+ class Geo
37
9
  # API key provided by Google allowing access to the Geocode API
38
- attr_accessor :key
39
-
40
- def initialize(key)
41
- @key = key
42
- end
43
-
44
- # Returns an array of Address objects, each with accessors for all the components of a location.
45
- # The query argument should be a string.
46
- def locate(query)
47
- xml = open(uri(query)).read
48
- res = Response.new(xml, key)
49
-
50
- res.placemarks.map { |place| Address.new place, res.query }
51
- end
10
+ attr_accessor :key, :language
52
11
 
53
- # Generate a request URI from a given search string.
54
- def uri(address) #:nodoc:
55
- "http://maps.google.com/maps/geo?q=#{URI.escape address}&key=#{key}&output=xml"
56
- end
57
- private :uri
12
+ # The last response received after a :locate call
13
+ attr_reader :last_response
14
+
15
+ # Google's XML files state that they are utf-8 encoded which is not true.
16
+ # Because they state this explicitly, I see no need to let users set
17
+ # another charset.
18
+ CHARSET = "utf-8"
19
+ def charset; CHARSET; end
58
20
 
59
- ###
21
+ DEFAULT_LANGUAGE = "en"
60
22
 
61
- module Parser #:nodoc:
62
- # Fetch contents of an XML element of the response.
63
- def fetch(element) #:nodoc:
64
- @xml.slice %r{<#{element}>(.+?)</#{element}>}, 1
65
- end
66
-
67
- # Like fetch, but for the only piece of data locked away in an attribute.
68
- def fetch_accuracy #:nodoc:
69
- @xml.slice(%r{Accuracy="([^"]+)">}, 1).to_i
70
- end
23
+ def initialize(key, language = DEFAULT_LANGUAGE)
24
+ @key = key
25
+ @language = language
71
26
  end
72
-
73
- ###
74
-
75
- # Represents locations returned in response to geocoding queries.
76
- class Address
77
- include Parser
78
-
79
- attr_reader :street
80
- alias :thoroughfare :street
81
-
82
- attr_reader :city
83
- alias :locality :city
84
-
85
- attr_reader :zip
86
- alias :postal_code :zip
87
27
 
88
- attr_reader :county
89
- alias :subadministrative_area :county
90
-
91
- attr_reader :state
92
- alias :administrative_area :state
93
-
94
- attr_reader :country
95
- alias :country_code :country
96
-
97
- # An array containing the standard three elements of a coordinate triple: latitude, longitude, elevation.
98
- attr_reader :coordinates
99
-
100
- # A float, the standard first element of a coordinate triple.
101
- attr_reader :longitude
102
- alias :lng :longitude
103
-
104
- # A float, the standard second element of a coordinate triple.
105
- attr_reader :latitude
106
- alias :lat :latitude
107
-
108
- # A float, the standard third element of a coordinate triple.
109
- attr_reader :elevation
110
-
111
- # An integer, Google's rating of the accuracy of the supplied address.
112
- attr_reader :accuracy
113
-
114
- # All address attributes as one string, formatted by the service.
115
- attr_reader :full_address
116
- alias :to_s :full_address
117
-
118
- # The address query sent to the service. i.e. The user input.
119
- attr_reader :query
120
-
121
- def initialize(placemark, query) #:nodoc
122
- @xml = placemark
123
- @query = query
124
-
125
- {
126
- :@street => :ThoroughfareName,
127
- :@city => :LocalityName,
128
- :@zip => :PostalCodeNumber,
129
- :@county => :SubAdministrativeAreaName,
130
- :@state => :AdministrativeAreaName,
131
- :@country => :CountryNameCode,
132
-
133
- :@full_address => :address
134
- }.each do |attribute, element|
135
- instance_variable_set(attribute, (fetch(element) rescue nil))
136
- end
137
-
138
- @longitude, @latitude, @elevation = @coordinates = fetch(:coordinates).split(',').map { |x| x.to_f }
139
-
140
- @accuracy = fetch_accuracy
141
- end
28
+ # >> geo.locate "1600 Pennsylvania Ave"
29
+ #
30
+ # # reverse locate
31
+ # >> geo.locate 33.998671, -118.075926
32
+ #
33
+ # Returns an array of Address objects,
34
+ # each with accessors for all the components of a location.
35
+ def locate(*params)
36
+ @last_response = Response.new(self, Params.new(self, *params))
37
+ @last_response.addresses
142
38
  end
143
39
 
144
40
  ###
145
41
 
146
- class Response #:nodoc:
147
- include Parser
148
-
149
- attr_reader :query, :status, :placemarks
150
-
151
- def initialize(xml, geo_key) #:nodoc
152
- @xml, @geo_key = xml, geo_key
153
-
154
- @query = fetch(:name)
155
- @status = fetch(:code).to_i
156
-
157
- check_for_errors
158
-
159
- @placemarks = @xml.scan %r{<Placemark(?: id="p\d+")?>.+?</Placemark>}m
160
- end
161
-
162
- def check_for_errors #:nodoc:
163
- case status
164
- when 200 then # Success
165
- when 500 then raise ServerError, "Unknown error from Google's server"
166
- when 601 then raise MissingAddressError, "Missing address"
167
- when 602 then raise UnknownAddressError, "Unknown address: #{@query}"
168
- when 603 then raise UnavailableAddressError, "Unavailable address: #{@query}"
169
- when 610 then raise InvalidMapKeyError, "Invalid map key: #{@geo_key}"
170
- when 620 then raise TooManyQueriesError, "Too many queries for map key: #{@geo_key}"
171
- else raise UnknownError, "Unknown error: #{@status}"
172
- end
173
- end
174
- end
175
-
176
- ###
177
-
178
42
  class Error < Exception; end
179
43
 
180
- class ServerError < Error; end
44
+ class ServerError < Error; end
45
+ class BadRequestError < Error; end
181
46
 
182
47
  class AddressError < Error; end
183
48
  class MissingAddressError < AddressError; end
data/lib/google/geo/address.rb ADDED
@@ -0,0 +1,75 @@
1
+ require "google/geo/parser"
2
+
3
+ module Google
4
+ class Geo
5
+ # Represents locations returned in response to geocoding queries.
6
+ class Address
7
+ include Parser
8
+
9
+ attr_reader :street
10
+ alias :thoroughfare :street
11
+
12
+ attr_reader :city
13
+ alias :locality :city
14
+
15
+ attr_reader :zip
16
+ alias :postal_code :zip
17
+
18
+ attr_reader :county
19
+ alias :subadministrative_area :county
20
+
21
+ attr_reader :state
22
+ alias :administrative_area :state
23
+
24
+ attr_reader :country
25
+ alias :country_code :country
26
+
27
+ # An array containing the standard three elements of a coordinate triple: latitude, longitude, elevation.
28
+ attr_reader :coordinates
29
+
30
+ # A float, the standard first element of a coordinate triple.
31
+ attr_reader :longitude
32
+ alias :lng :longitude
33
+
34
+ # A float, the standard second element of a coordinate triple.
35
+ attr_reader :latitude
36
+ alias :lat :latitude
37
+
38
+ # A float, the standard third element of a coordinate triple.
39
+ attr_reader :elevation
40
+
41
+ # An integer, Google's rating of the accuracy of the supplied address.
42
+ attr_reader :accuracy
43
+
44
+ # All address attributes as one string, formatted by the service.
45
+ attr_reader :full_address
46
+ alias :to_s :full_address
47
+
48
+ # The address query sent to the service. i.e. The user input.
49
+ attr_reader :query
50
+
51
+ def initialize(placemark, query, geo) #:nodoc
52
+ @geo = geo
53
+ @xml = placemark
54
+ @query = query
55
+
56
+ { :@street => :ThoroughfareName,
57
+ :@city => :LocalityName,
58
+ :@zip => :PostalCodeNumber,
59
+ :@county => :SubAdministrativeAreaName,
60
+ :@state => :AdministrativeAreaName,
61
+ :@country => :CountryNameCode,
62
+
63
+ :@full_address => :address
64
+ }.each do |attribute, element|
65
+ instance_variable_set(attribute, (fetch(element) rescue nil))
66
+ end
67
+
68
+ @longitude, @latitude, @elevation =
69
+ @coordinates = fetch(:coordinates).split(",").map { |x| x.to_f }
70
+
71
+ @accuracy = fetch_accuracy
72
+ end
73
+ end
74
+ end
75
+ end
data/lib/google/geo/address/street_view.rb ADDED
@@ -0,0 +1,28 @@
1
+ require "google/geo"
2
+
3
+ module Google
4
+ class Geo
5
+ class Address
6
+ # This is a shady method which relies on an unofficial Google API.
7
+ # Use at your own risk!
8
+ def street_view_html(options = {})
9
+ %{<embed id="#{options[:id] or 'google-geo-streetview'}"
10
+ style="#{options[:style]}"
11
+ src="http://maps.google.com/mapfiles/cb/googlepano.066.swf"
12
+ quality="high" wmode="opaque" swliveconnect="false"
13
+ allowscriptaccess="always" type="application/x-shockwave-flash"
14
+ pluginspage="http://www.macromedia.com/go/getflashplayer"
15
+ scale="noscale" salign="lt"
16
+ 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"
17
+ ></embed>}.gsub("\n", "").squeeze(" ")
18
+ end
19
+
20
+ private
21
+ def street_view_pano_id
22
+ url = "http://maps.google.com/cbk?output=xml&oe=utf-8&cb_client=api&ll=#{lat},#{lng}"
23
+ # "&callback=_xdc_._0fqdyf9p2"
24
+ open(url).read.slice(/pano_id="([^"]+)"/, 1)
25
+ end
26
+ end
27
+ end
28
+ end
data/lib/google/geo/params.rb ADDED
@@ -0,0 +1,44 @@
1
+ module Google
2
+ class Geo
3
+ class Params < Hash
4
+ def initialize(geo, *args)
5
+ @geo = geo
6
+
7
+ params = { :key => @geo.key, :output => "xml", :hl => @geo.language, :oe => "utf-8" }
8
+
9
+ query = case args.size
10
+ when 1
11
+ case args
12
+ when String then args
13
+ when Array then args.join(",")
14
+ end
15
+ when 2
16
+ args.join(",")
17
+ else
18
+ raise ArgumentError, "dunno what to do with #{args.inspect}"
19
+ end
20
+
21
+ params[:q] = query
22
+
23
+ replace params
24
+ end
25
+
26
+ def to_uri
27
+ uri = "http://maps.google.com/maps/geo?" <<
28
+ map { |k,v| "#{k}=#{URI.escape v.to_s}" }.join("&")
29
+ # puts uri
30
+ uri
31
+ end
32
+
33
+ def extract_dimensions!
34
+ if size = delete(:size)
35
+ size.split("x")
36
+ elsif self[:width] and self[:height]
37
+ [delete(:width), delete(:height)]
38
+ else
39
+ [500, 300]
40
+ end
41
+ end
42
+ end
43
+ end
44
+ end
data/lib/google/geo/parser.rb ADDED
@@ -0,0 +1,19 @@
1
+ #:stopdoc:
2
+ module Google
3
+ class Geo
4
+
5
+ module Parser
6
+ # Fetch contents of an XML element of the response.
7
+ def fetch(element)
8
+ @xml.slice(%r{<#{element}>(.+?)</#{element}>}, 1)
9
+ end
10
+
11
+ # Like fetch, but for the only piece of data locked away in an attribute.
12
+ def fetch_accuracy
13
+ @xml.slice(%r{Accuracy="([^"]+)"}, 1).to_i
14
+ end
15
+ end
16
+
17
+ end
18
+ end
19
+ #:startdoc:
data/lib/google/geo/response.rb ADDED
@@ -0,0 +1,43 @@
1
+ require "google/geo/parser"
2
+
3
+ #:stopdoc:
4
+ module Google
5
+ class Geo
6
+
7
+ class Response #:nodoc:
8
+ include Parser
9
+
10
+ attr_reader :geo, :params, :xml, :query, :status
11
+
12
+ def initialize(geo, params) #:nodoc
13
+ @geo = geo
14
+
15
+ @params = params
16
+ @xml = open(params.to_uri).read
17
+
18
+ @query = fetch(:name)
19
+ @status = fetch(:code).to_i
20
+
21
+ case @status
22
+ when 200 then # Success
23
+ when 500 then raise ServerError, "Unknown error from Google's server"
24
+ when 601 then raise MissingAddressError, "Missing address"
25
+ when 602 then raise UnknownAddressError, "Unknown address: #{@query}"
26
+ when 603 then raise UnavailableAddressError, "Unavailable address: #{@query}"
27
+ when 610 then raise InvalidMapKeyError, "Invalid map key: #{@geo.key}"
28
+ when 620 then raise TooManyQueriesError, "Too many queries for map key: #{@geo.key}"
29
+ when 400 then raise BadRequestError, "Bad request: #{@status}"
30
+ else raise UnknownError, "Unknown error: #{@status}"
31
+ end
32
+
33
+ @placemarks = @xml.scan %r{<Placemark(?: id="p\d+")?>.+?</Placemark>}m
34
+ end
35
+
36
+ def addresses
37
+ @placemarks.map { |p| Address.new p, @query, @geo }
38
+ end
39
+ end
40
+
41
+ end
42
+ end
43
+ #:startdoc:
data/script/test_street_view.rb ADDED
@@ -0,0 +1,27 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ load File.dirname(__FILE__) + "/../.irbrc"
4
+ enable_street_view
5
+
6
+ g = new_geo
7
+ a = g.locate(*ARGV).first
8
+
9
+ require "tempfile"
10
+
11
+ p = File.expand_path "google-geo-streetview.html"
12
+
13
+ File.open(p, "w") do |f|
14
+ html = a.street_view_html(
15
+ :id => "TEST",
16
+ :style => "width:640px; height:480px"
17
+ )
18
+ f.puts html
19
+ end
20
+
21
+ raise "wtf" and exit unless File.exist? p
22
+
23
+ require "rubygems"
24
+ require "launchy"
25
+ Launchy::Browser.run "file://#{p}"
26
+
27
+ puts "created test file at #{p}"
data/test/fixtures/reverse_locate_602.xml ADDED
@@ -0,0 +1,10 @@
1
+ <?xml version="1.0" encoding="UTF-8" ?>
2
+ <kml xmlns="http://earth.google.com/kml/2.0">
3
+ <Response>
4
+ <name>0.000000,0.000000</name>
5
+ <Status>
6
+ <code>602</code>
7
+ <request>geocode</request>
8
+ </Status>
9
+ </Response>
10
+ </kml>
data/test/fixtures/reverse_locate_success.xml ADDED
@@ -0,0 +1,64 @@
1
+ <?xml version="1.0" encoding="UTF-8" ?>
2
+ <kml xmlns="http://earth.google.com/kml/2.0"><Response>
3
+ <name>33.998671,-118.075926</name>
4
+ <Status>
5
+ <code>200</code>
6
+ <request>geocode</request>
7
+ </Status>
8
+ <Placemark id="p1">
9
+ <address>4952-4958 Tobias Ave, Pico Rivera, CA 90660, USA</address>
10
+ <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>
11
+ <ExtendedData>
12
+ <LatLonBox north="34.0018448" south="33.9955496" east="-118.0728908" west="-118.0791860" />
13
+ </ExtendedData>
14
+ <Point><coordinates>-118.0760384,33.9986972,0</coordinates></Point>
15
+ </Placemark>
16
+ <Placemark id="p2">
17
+ <address>Pico Rivera, CA 90660, USA</address>
18
+ <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>
19
+ <ExtendedData>
20
+ <LatLonBox north="34.0230350" south="33.9502470" east="-118.0515550" west="-118.1211040" />
21
+ </ExtendedData>
22
+ <Point><coordinates>-118.0947106,33.9870228,0</coordinates></Point>
23
+ </Placemark>
24
+ <Placemark id="p3">
25
+ <address>Pico Rivera, CA, USA</address>
26
+ <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>
27
+ <ExtendedData>
28
+ <LatLonBox north="34.0303260" south="33.9504570" east="-118.0386930" west="-118.1230050" />
29
+ </ExtendedData>
30
+ <Point><coordinates>-118.0838360,34.0014100,0</coordinates></Point>
31
+ </Placemark>
32
+ <Placemark id="p4">
33
+ <address>Whittier, California, USA</address>
34
+ <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>
35
+ <ExtendedData>
36
+ <LatLonBox north="34.0338340" south="33.8733970" east="-117.9152740" west="-118.1227020" />
37
+ </ExtendedData>
38
+ <Point><coordinates>-118.0420282,33.9743790,0</coordinates></Point>
39
+ </Placemark>
40
+ <Placemark id="p5">
41
+ <address>Los Angeles, California, USA</address>
42
+ <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>
43
+ <ExtendedData>
44
+ <LatLonBox north="34.8232710" south="32.7500400" east="-117.6457480" west="-118.9517210" />
45
+ </ExtendedData>
46
+ <Point><coordinates>-118.1122679,34.3871821,0</coordinates></Point>
47
+ </Placemark>
48
+ <Placemark id="p6">
49
+ <address>California, USA</address>
50
+ <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>
51
+ <ExtendedData>
52
+ <LatLonBox north="42.0095190" south="32.5288320" east="-114.1312120" west="-124.4820030" />
53
+ </ExtendedData>
54
+ <Point><coordinates>-119.4179324,36.7782610,0</coordinates></Point>
55
+ </Placemark>
56
+ <Placemark id="p7">
57
+ <address>United States</address>
58
+ <AddressDetails Accuracy="1" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"><Country><CountryNameCode>US</CountryNameCode><CountryName>USA</CountryName></Country></AddressDetails>
59
+ <ExtendedData>
60
+ <LatLonBox north="71.4343570" south="17.8315100" east="-65.1685040" west="172.3478480" />
61
+ </ExtendedData>
62
+ <Point><coordinates>-95.7128910,37.0902400,0</coordinates></Point>
63
+ </Placemark>
64
+ </Response></kml>
data/test/fixtures/streetview_success.xml ADDED
@@ -0,0 +1 @@
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 CHANGED
@@ -8,7 +8,7 @@
8
8
  </Status>
9
9
  <Placemark>
10
10
  <address>1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA</address>
11
- <AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0" Accuracy="8">
11
+ <AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0" Accuracy="8" foo="bar">
12
12
  <Country>
13
13
  <CountryNameCode>US</CountryNameCode>
14
14
  <AdministrativeArea>
data/test/fixtures/success_english.xml ADDED
@@ -0,0 +1,34 @@
1
+ <?xml version="1.0" encoding="UTF-8" ?>
2
+ <kml xmlns="http://earth.google.com/kml/2.0">
3
+ <Response>
4
+ <name>Zürich, Schweiz</name>
5
+ <Status>
6
+ <code>200</code>
7
+ <request>geocode</request>
8
+ </Status>
9
+ <Placemark id="p1">
10
+ <address>Zürich, Switzerland</address>
11
+ <AddressDetails Accuracy="4" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">
12
+ <Country>
13
+ <CountryNameCode>CH</CountryNameCode>
14
+ <CountryName>Switzerland</CountryName>
15
+ <AdministrativeArea>
16
+ <AdministrativeAreaName>Zurich</AdministrativeAreaName>
17
+ <SubAdministrativeArea>
18
+ <SubAdministrativeAreaName>Zurich</SubAdministrativeAreaName>
19
+ <Locality>
20
+ <LocalityName>Zürich</LocalityName>
21
+ </Locality>
22
+ </SubAdministrativeArea>
23
+ </AdministrativeArea>
24
+ </Country>
25
+ </AddressDetails>
26
+ <ExtendedData>
27
+ <LatLonBox north="47.4347210" south="47.3201830" east="8.6254420" west="8.4480810" />
28
+ </ExtendedData>
29
+ <Point>
30
+ <coordinates>8.5380326,47.3690239,0</coordinates>
31
+ </Point>
32
+ </Placemark>
33
+ </Response>
34
+ </kml>
data/test/fixtures/success_german.xml ADDED
@@ -0,0 +1,34 @@
1
+ <?xml version="1.0" encoding="UTF-8" ?>
2
+ <kml xmlns="http://earth.google.com/kml/2.0">
3
+ <Response>
4
+ <name>Zürich, Schweiz</name>
5
+ <Status>
6
+ <code>200</code>
7
+ <request>geocode</request>
8
+ </Status>
9
+ <Placemark id="p1">
10
+ <address>Zürich, Schweiz</address>
11
+ <AddressDetails Accuracy="4" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">
12
+ <Country>
13
+ <CountryNameCode>CH</CountryNameCode>
14
+ <CountryName>Schweiz</CountryName>
15
+ <AdministrativeArea>
16
+ <AdministrativeAreaName>Zürich</AdministrativeAreaName>
17
+ <SubAdministrativeArea>
18
+ <SubAdministrativeAreaName>Zürich</SubAdministrativeAreaName>
19
+ <Locality>
20
+ <LocalityName>Zürich</LocalityName>
21
+ </Locality>
22
+ </SubAdministrativeArea>
23
+ </AdministrativeArea>
24
+ </Country>
25
+ </AddressDetails>
26
+ <ExtendedData>
27
+ <LatLonBox north="47.4347210" south="47.3201830" east="8.6254420" west="8.4480810" />
28
+ </ExtendedData>
29
+ <Point>
30
+ <coordinates>8.5380326,47.3690239,0</coordinates>
31
+ </Point>
32
+ </Placemark>
33
+ </Response>
34
+ </kml>
data/test/geo_test.rb CHANGED
@@ -1,18 +1,14 @@
1
- require 'test/unit'
2
- $:.unshift "#{File.dirname __FILE__}/../vendor/mocha-0.4.0/lib"
3
- require 'mocha'
4
- require "#{File.dirname __FILE__}/../lib/google/geo"
1
+ require "test_helper"
5
2
 
6
- class Google::GeoTest < Test::Unit::TestCase
3
+ class GeoTest < Test::Unit::TestCase
7
4
  def setup
8
5
  @geo = Google::Geo.new 'API_KEY'
9
6
  end
10
7
 
11
8
  def test_success
12
- @geo.expects(:open).
9
+ stub_response! :success
13
10
  # show that query is escaped
14
- with("http://maps.google.com/maps/geo?q=1600%20Amphitheatre%20Parkway,%20Mountain%20View,%20CA&key=API_KEY&output=xml").
15
- returns(response(:success))
11
+ # with("http://maps.google.com/maps/geo?q=1600%20Amphitheatre%20Parkway,%20Mountain%20View,%20CA&key=API_KEY&output=xml&hl=en&oe=utf-8").
16
12
 
17
13
  query = '1600 Amphitheatre Parkway, Mountain View, CA'
18
14
 
@@ -53,7 +49,7 @@ class Google::GeoTest < Test::Unit::TestCase
53
49
  end
54
50
 
55
51
  def test_success_with_multiple_addresses
56
- @geo.expects(:open).returns(response(:success_with_multiple_addresses))
52
+ stub_response! :success_with_multiple_addresses
57
53
 
58
54
  heavens = @geo.locate('heaven')
59
55
 
@@ -64,39 +60,55 @@ class Google::GeoTest < Test::Unit::TestCase
64
60
 
65
61
  heavens.each { |h| assert_kind_of Google::Geo::Address, h }
66
62
  end
67
-
63
+
64
+ def test_has_an_accessible_language_attribute_defaulting_to_english
65
+ assert_equal 'en', @geo.language
66
+ @geo.language = 'de'
67
+ assert_equal 'de', @geo.language
68
+ end
69
+
70
+ def test_can_get_results_in_german
71
+ stub_response! :success_german
72
+ # with("http://maps.google.com/maps/geo?q=Z%C3%BCrich,%20Schweiz&key=API_KEY&output=xml&hl=de&oe=utf-8").
73
+ @geo.language = 'de'
74
+ address = @geo.locate('Zürich, Schweiz').first
75
+ assert_equal 'Zürich, Schweiz', address.full_address
76
+ end
77
+
78
+ def test_gets_english_results_by_default
79
+ stub_response! :success_english
80
+ # with("http://maps.google.com/maps/geo?q=Z%C3%BCrich,%20Schweiz&key=API_KEY&output=xml&hl=en&oe=utf-8").
81
+ address = @geo.locate('Zürich, Schweiz').first
82
+ assert_equal 'Zürich, Switzerland', address.full_address
83
+ end
84
+
68
85
  def test_invalid_map_key
69
- @geo.expects(:open).returns(response(:invalid_map_key))
86
+ stub_response! :invalid_map_key
70
87
  assert_raises(Google::Geo::InvalidMapKeyError) { @geo.locate 'foo' }
71
88
  end
72
89
 
73
90
  def test_missing_address
74
- @geo.expects(:open).returns(response(:missing_address))
91
+ stub_response! :missing_address
75
92
  assert_raises(Google::Geo::MissingAddressError) { @geo.locate 'foo' }
76
93
  end
77
94
 
78
95
  def test_server_error
79
- @geo.expects(:open).returns(response(:server_error))
96
+ stub_response! :server_error
80
97
  assert_raises(Google::Geo::ServerError) { @geo.locate 'foo' }
81
98
  end
82
99
 
83
100
  def test_too_many_queries
84
- @geo.expects(:open).returns(response(:too_many_queries))
101
+ stub_response! :too_many_queries
85
102
  assert_raises(Google::Geo::TooManyQueriesError) { @geo.locate 'foo' }
86
103
  end
87
104
 
88
105
  def test_unavailable_address
89
- @geo.expects(:open).returns(response(:unavailable_address))
106
+ stub_response! :unavailable_address
90
107
  assert_raises(Google::Geo::UnavailableAddressError) { @geo.locate 'foo' }
91
108
  end
92
109
 
93
110
  def test_unknown_address
94
- @geo.expects(:open).returns(response(:unknown_address))
111
+ stub_response! :unknown_address
95
112
  assert_raises(Google::Geo::UnknownAddressError) { @geo.locate 'foo' }
96
113
  end
97
-
98
- private
99
- def response(filename)
100
- File.new "#{File.dirname __FILE__}/fixtures/#{filename}.xml"
101
- end
102
114
  end
data/test/reverse_locate_test.rb ADDED
@@ -0,0 +1,64 @@
1
+ require "test_helper"
2
+
3
+ class ReverseLocateTest < Test::Unit::TestCase
4
+ def setup
5
+ @geo = Google::Geo.new 'API_KEY'
6
+ end
7
+
8
+ def test_should_locate_with_latlon
9
+ stub_response! :reverse_locate_success
10
+ # with("http://maps.google.com/maps/geo?ll=33.998671,-118.075926&key=API_KEY&output=xml&hl=en&oe=utf-8").
11
+
12
+ location = @geo.locate(33.998671, -118.075926)
13
+
14
+ address = location.first
15
+
16
+ assert_equal 33.9986972, address.latitude
17
+ assert_equal -118.0760384, address.longitude
18
+
19
+ assert_equal address.longitude, address.lng
20
+ assert_equal address.latitude, address.lat
21
+ end
22
+
23
+ def test_should_have_city
24
+ stub_response! :reverse_locate_success
25
+ location = @geo.locate(33.998671, -118.075926)
26
+ address = location.first
27
+ assert_equal "Pico Rivera", address.city
28
+ end
29
+
30
+ def test_should_have_two_letter_state
31
+ stub_response! :reverse_locate_success
32
+ location = @geo.locate(33.998671, -118.075926)
33
+ address = location.first
34
+ assert_equal "CA", address.state
35
+ end
36
+
37
+ def test_should_have_zipcode
38
+ stub_response! :reverse_locate_success
39
+ location = @geo.locate(33.998671, -118.075926)
40
+ address = location.first
41
+ assert_equal "90660", address.zip
42
+ end
43
+
44
+ def test_should_have_country
45
+ stub_response! :reverse_locate_success
46
+ location = @geo.locate(33.998671, -118.075926)
47
+ address = location.first
48
+ assert_equal "US", address.country
49
+ end
50
+
51
+ def test_should_have_full_address
52
+ stub_response! :reverse_locate_success
53
+ location = @geo.locate(33.998671, -118.075926)
54
+ address = location.first
55
+ assert_equal "4952-4958 Tobias Ave, Pico Rivera, CA 90660, USA", address.full_address
56
+ end
57
+
58
+ def test_should_raise_error_when_unknown_address
59
+ stub_response! :reverse_locate_602
60
+ assert_raise Google::Geo::UnknownAddressError do
61
+ @geo.locate(0, 0)
62
+ end
63
+ end
64
+ end
data/test/test_helper.rb ADDED
@@ -0,0 +1,23 @@
1
+ here = File.dirname __FILE__
2
+
3
+ ["vendor/mocha-0.4.0/lib", "lib"].each do |path|
4
+ p = "#{here}/../#{path}"
5
+ $:.unshift p unless $:.include? p
6
+ end
7
+
8
+ require "test/unit"
9
+ require "mocha"
10
+ require "google/geo"
11
+
12
+ begin; require "rubygems"; require "redgreen"; rescue LoadError; end
13
+
14
+ class Test::Unit::TestCase
15
+ def response(filename)
16
+ File.open "#{File.dirname __FILE__}/fixtures/#{filename}.xml"
17
+ end
18
+
19
+ def stub_response!(name)
20
+ Google::Geo::Response.any_instance.
21
+ expects(:open).returns(response(name))
22
+ end
23
+ end
metadata CHANGED
@@ -1,50 +1,75 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-geo
3
3
  version: !ruby/object:Gem::Version
4
- version: "2.1"
4
+ version: "2.3"
5
5
  platform: ruby
6
6
  authors:
7
- - |
8
-
9
-
7
+ - Seth Thomas Rasmussen
10
8
  autorequire:
11
9
  bindir: bin
12
10
  cert_chain: []
13
11
 
14
- date: 2008-02-11 00:00:00 -08:00
12
+ date: 2009-11-19 00:00:00 -05:00
15
13
  default_executable:
16
14
  dependencies: []
17
15
 
18
- description:
19
- email:
16
+ description: |
17
+ A simple, elegant library for getting geocoding information from Google Maps. Very much inspired by the google-geocode gem, but completely dependency free!
18
+
19
+ email: sethrasmussen@gmail.com
20
20
  executables: []
21
21
 
22
22
  extensions: []
23
23
 
24
24
  extra_rdoc_files:
25
- - README
26
25
  - CHANGELOG
26
+ - LICENSE
27
+ - README.textile
28
+ - lib/google/geo.rb
29
+ - lib/google/geo/address.rb
30
+ - lib/google/geo/address/street_view.rb
31
+ - lib/google/geo/params.rb
32
+ - lib/google/geo/parser.rb
33
+ - lib/google/geo/response.rb
27
34
  files:
28
- - lib/google
35
+ - CHANGELOG
36
+ - LICENSE
37
+ - Manifest
38
+ - README.textile
39
+ - Rakefile
40
+ - google-geo.gemspec
29
41
  - lib/google/geo.rb
30
- - test/fixtures
42
+ - lib/google/geo/address.rb
43
+ - lib/google/geo/address/street_view.rb
44
+ - lib/google/geo/params.rb
45
+ - lib/google/geo/parser.rb
46
+ - lib/google/geo/response.rb
47
+ - script/test_street_view.rb
31
48
  - test/fixtures/invalid_map_key.xml
32
49
  - test/fixtures/missing_address.xml
50
+ - test/fixtures/reverse_locate_602.xml
51
+ - test/fixtures/reverse_locate_success.xml
33
52
  - test/fixtures/server_error.xml
53
+ - test/fixtures/streetview_success.xml
34
54
  - test/fixtures/success.xml
55
+ - test/fixtures/success_english.xml
56
+ - test/fixtures/success_german.xml
35
57
  - test/fixtures/success_with_multiple_addresses.xml
36
58
  - test/fixtures/too_many_queries.xml
37
59
  - test/fixtures/unavailable_address.xml
38
60
  - test/fixtures/unknown_address.xml
39
61
  - test/geo_test.rb
40
- - vendor/mocha-0.4.0
62
+ - test/reverse_locate_test.rb
63
+ - test/test_helper.rb
41
64
  - vendor/mocha-0.4.0/COPYING
42
- - vendor/mocha-0.4.0/examples
65
+ - vendor/mocha-0.4.0/MIT-LICENSE
66
+ - vendor/mocha-0.4.0/README
67
+ - vendor/mocha-0.4.0/RELEASE
68
+ - vendor/mocha-0.4.0/Rakefile
43
69
  - vendor/mocha-0.4.0/examples/misc.rb
44
70
  - vendor/mocha-0.4.0/examples/mocha.rb
45
71
  - vendor/mocha-0.4.0/examples/stubba.rb
46
- - vendor/mocha-0.4.0/lib
47
- - vendor/mocha-0.4.0/lib/mocha
72
+ - vendor/mocha-0.4.0/lib/mocha.rb
48
73
  - vendor/mocha-0.4.0/lib/mocha/any_instance_method.rb
49
74
  - vendor/mocha-0.4.0/lib/mocha/auto_verify.rb
50
75
  - vendor/mocha-0.4.0/lib/mocha/central.rb
@@ -62,19 +87,12 @@ files:
62
87
  - vendor/mocha-0.4.0/lib/mocha/setup_and_teardown.rb
63
88
  - vendor/mocha-0.4.0/lib/mocha/standalone.rb
64
89
  - vendor/mocha-0.4.0/lib/mocha/test_case_adapter.rb
65
- - vendor/mocha-0.4.0/lib/mocha.rb
66
90
  - vendor/mocha-0.4.0/lib/mocha_standalone.rb
67
91
  - vendor/mocha-0.4.0/lib/stubba.rb
68
- - vendor/mocha-0.4.0/MIT-LICENSE
69
- - vendor/mocha-0.4.0/Rakefile
70
- - vendor/mocha-0.4.0/README
71
- - vendor/mocha-0.4.0/RELEASE
72
- - vendor/mocha-0.4.0/test
73
92
  - vendor/mocha-0.4.0/test/active_record_test_case.rb
74
93
  - vendor/mocha-0.4.0/test/all_tests.rb
75
94
  - vendor/mocha-0.4.0/test/execution_point.rb
76
95
  - vendor/mocha-0.4.0/test/method_definer.rb
77
- - vendor/mocha-0.4.0/test/mocha
78
96
  - vendor/mocha-0.4.0/test/mocha/any_instance_method_test.rb
79
97
  - vendor/mocha-0.4.0/test/mocha/auto_verify_test.rb
80
98
  - vendor/mocha-0.4.0/test/mocha/central_test.rb
@@ -95,13 +113,18 @@ files:
95
113
  - vendor/mocha-0.4.0/test/stubba_integration_test.rb
96
114
  - vendor/mocha-0.4.0/test/stubba_test_result_integration_test.rb
97
115
  - vendor/mocha-0.4.0/test/test_helper.rb
98
- - README
99
- - CHANGELOG
100
116
  has_rdoc: true
101
- homepage:
102
- post_install_message:
103
- rdoc_options: []
117
+ homepage: http://github.com/greatseth/google-geo
118
+ licenses: []
104
119
 
120
+ post_install_message:
121
+ rdoc_options:
122
+ - --line-numbers
123
+ - --inline-source
124
+ - --title
125
+ - Google-geo
126
+ - --main
127
+ - README.textile
105
128
  require_paths:
106
129
  - lib
107
130
  required_ruby_version: !ruby/object:Gem::Requirement
@@ -114,14 +137,16 @@ required_rubygems_version: !ruby/object:Gem::Requirement
114
137
  requirements:
115
138
  - - ">="
116
139
  - !ruby/object:Gem::Version
117
- version: "0"
140
+ version: "1.2"
118
141
  version:
119
142
  requirements: []
120
143
 
121
- rubyforge_project:
122
- rubygems_version: 1.0.1
144
+ rubyforge_project: google-geo
145
+ rubygems_version: 1.3.5
123
146
  signing_key:
124
- specification_version: 2
147
+ specification_version: 3
125
148
  summary: A simple, elegant library for getting geocoding information from Google Maps. Very much inspired by the google-geocode gem, but completely dependency free!
126
149
  test_files:
127
150
  - test/geo_test.rb
151
+ - test/reverse_locate_test.rb
152
+ - test/test_helper.rb
data/README DELETED
@@ -1,35 +0,0 @@
1
- = Google::Geo
2
-
3
- A simple, elegant library for getting geocoding information from Google Maps. Very much inspired by the google-geocode gem, but completely dependency free!
4
-
5
- == Examples
6
-
7
- geo = Google::Geo.new API_KEY
8
-
9
- addresses = geo.locate '1600 Amphitheatre Parkway, Mountain View, CA'
10
-
11
- addresses.size # 1, :locate always returns an Array
12
-
13
- address = addresses.first
14
-
15
- address.country # 'US'
16
- address.city # 'Mountain View'
17
- address.full_address # '1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA'
18
-
19
- address.query # '1600 Amphitheatre Parkway, Mountain View, CA'
20
- address.accuracy # 8
21
-
22
- In the case of sufficiently vague queries, Google::Geo will return more than one:
23
-
24
- addresses = geo.locate 'hell'
25
-
26
- addresses.size # 2
27
- addresses.map { |a| a.state } # ['PA', 'NC']
28
-
29
- == Contributors
30
-
31
- Seth Thomas Rasmussen - http://sethrasmussen.com - sethrasmussen@gmail.com
32
-
33
- == License
34
-
35
- See LICENSE file.