geokit 1.8.5 → 1.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 98e06d3c4938d6abb5d93ffa864c847d327c914a
+  data.tar.gz: 96b8865be8cf94ab9a50887af007550de8fc90b6
+SHA512:
+  metadata.gz: 8c2a873dde628c7d662df14ce2540db29cbb7676b73800dd58b545fc97a440e31c2ee59b0b9e6a753696118e6ac1527cbf0c1c35b1cf0e384bde07c6aaa83029
+  data.tar.gz: 94d0cd927bdeeb27dd6457e7a83fac92b919624f2a2b20d0824ea8fd6cc0b008097384b79427536090c7b9bb6661c55379db6fd765e41bd13c431ddadcbbcf6e

data/.travis.yml

@@ -1,6 +1,5 @@
 language: ruby
 rvm:
-  - 1.8
   - 1.9
   - 2.0
   - 2.1

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## 1.9.0
+
+* Drop Ruby 1.8 support
+* Make meter centric
+* Add meters as a unit
+* Use state_name/state_code instead of state
+
 ## 1.8.5
 
 * HTTPS on Google, Bing, Yahoo and MapQuest

data/README.markdown

@@ -11,7 +11,7 @@ Geokit
 
 The Geokit gem provides:
 
- * Distance calculations between two points on the earth. Calculate the distance in miles, kilometers, or nautical miles, with all the trigonometry abstracted away by Geokit.
+ * Distance calculations between two points on the earth. Calculate the distance in miles, kilometers, meters, or nautical miles, with all the trigonometry abstracted away by Geokit.
  * Geocoding from multiple providers. It supports Google, Yahoo, Geocoder.us, and Geocoder.ca geocoders, and others. It provides a uniform response structure from all of them.
    It also provides a fail-over mechanism, in case your input fails to geocode in one service.
  * Rectangular bounds calculations: is a point within a given rectangular bounds?
@@ -45,11 +45,15 @@ Combine this gem with the [geokit-rails](http://github.com/geokit/geokit-rails)
 * Yandex
 * MapQuest
 * Geocod.io
+* Mapbox - requires an access token
+* [OpenCage](http://geocoder.opencagedata.com) - requires an API key
 
 ### address geocoders that also provide reverse geocoding
 * Google - Supports multiple results and bounding box/country code biasing.  Also supports Maps API for Business keys; see the configuration section below.
 * FCC
-* Open Street Map
+* OpenStreetMap
+* Mapbox
+* OpenCage
 
 ### IP address geocoders
 * IP - geocodes an IP address using hostip.info's web service.
@@ -64,6 +68,8 @@ Combine this gem with the [geokit-rails](http://github.com/geokit/geokit-rails)
 * Bing
 * FCC
 * MapQuest
+* Mapbox
+* OpenCage
 
 Options to control the use of HTTPS are described below in the Configuration section.
 
@@ -100,7 +106,7 @@ If you're using this gem by itself, here are the configuration options:
 
 ```ruby
     # These defaults are used in Geokit::Mappable.distance_to and in acts_as_mappable
-    Geokit::default_units = :miles
+    Geokit::default_units = :miles # others :kms, :nms, :meters
     Geokit::default_formula = :sphere
 
     # This is the timeout value in seconds to be used for calls to the geocoder web
@@ -152,11 +158,22 @@ If you're using this gem by itself, here are the configuration options:
     # and http://geocoder.ca/?register=1
     Geokit::Geocoders::CaGeocoder.key = 'KEY'
 
+    # This is your username key for geonames.
+    # To use this service either free or premium, you must register a key.
+    # See http://www.geonames.org
+    Geokit::Geocoders::GeonamesGeocoder.key = 'KEY'
+
     # Most other geocoders need either no setup or a key
     Geokit::Geocoders::BingGeocoder.key = ''
-    Geokit::Geocoders::GeonamesGeocoder.key = ''
     Geokit::Geocoders::MapQuestGeocoder.key = ''
     Geokit::Geocoders::YandexGeocoder.key = ''
+    Geokit::Geocoders::MapboxGeocoder.key = 'ACCESS_TOKEN'
+    Geokit::Geocoders::OpencageGeocoder.key = 'some_api_key'
+
+    # Geonames has a free service and a premium service, each using a different URL
+    # GeonamesGeocoder.premium = true will use http://ws.geonames.net (premium)
+    # GeonamesGeocoder.premium = false will use http://api.geonames.org (free)
+    Geokit::Geocoders::GeonamesGeocoder.premium = false
 
     # require "external_geocoder.rb"
     # Please see the section "writing your own geocoders" for more information.
@@ -176,11 +193,11 @@ If you're using this gem by itself, here are the configuration options:
 
 	# Disable HTTPS globally.  This option can also be set on individual
 	# geocoder classes.
-    Geokit::Geocoders::secure = false 
-    
+    Geokit::Geocoders::secure = false
+
     # Control verification of the server certificate for geocoders using HTTPS
-    Geokit::Geocoders::ssl_verify_mode = OpenSSL::SSL::VERIFY_(PEER/NONE) 
-    # Setting this to VERIFY_NONE may be needed on systems that don't have 
+    Geokit::Geocoders::ssl_verify_mode = OpenSSL::SSL::VERIFY_(PEER/NONE)
+    # Setting this to VERIFY_NONE may be needed on systems that don't have
     # a complete or up to date root certificate store. Only applies to
     # the Net::HTTP adapter.
 ```
@@ -196,19 +213,19 @@ The Google Geocoder sports a number of useful tricks that elevate it a little bi
      @ne=#<Geokit::LatLng:0x53b204 @lat=37.7968528, @lng=-122.3926933>,
      @sw=#<Geokit::LatLng:0x53b2b8 @lat=37.7905576, @lng=-122.3989885>>
 
-In addition, you can use viewport or country code biasing to make sure the geocoders prefers results within a specific area. Say we wanted to geocode the city of Syracuse in Italy. A normal geocoding query would look like this:
+In addition, you can use viewport or country code biasing to make sure the geocoders prefers results within a specific area. Say we wanted to geocode the city of Toledo in Spain. A normal geocoding query would look like this:
 
-    irb> res = Geokit::Geocoders::GoogleGeocoder.geocode('Syracuse')
+    irb> res = Geokit::Geocoders::GoogleGeocoder.geocode('Toledo')
     irb> res.full_address
-    => "Syracuse, NY, USA"
+    => "Toledo, OH, USA"
 ```
 
-Not exactly what we were looking for. We know that Syracuse is in Italy, so we can tell the Google Geocoder to prefer results from Italy first, and then wander the Syracuses of the world. To do that, we have to pass Italy's ccTLD (country code top-level domain) to the `:bias` option of the `geocode` method. You can find a comprehensive list of all ccTLDs here: http://en.wikipedia.org/wiki/CcTLD.
+Not exactly what we were looking for. We know that Toledo is in Spain, so we can tell the Google Geocoder to prefer results from Spain first, and then wander the Toledos of the world. To do that, we have to pass Italy's ccTLD (country code top-level domain) to the `:bias` option of the `geocode` method. You can find a comprehensive list of all ccTLDs here: http://en.wikipedia.org/wiki/CcTLD.
 
 ```ruby
-    irb> res = Geokit::Geocoders::GoogleGeocoder.geocode('Syracuse', :bias => 'it')
+    irb> res = Geokit::Geocoders::GoogleGeocoder.geocode('Toledo', :bias => 'es')
     irb> res.full_address
-    => "Syracuse, Italy"
+    => "Toledo, Toledo, Spain"
 ```
 
 Alternatively, we can specify the geocoding bias as a bounding box object. Say we wanted to geocode the Winnetka district in Los Angeles.

data/fixtures/vcr_cassettes/geonames_geocode.yml

@@ -2,7 +2,7 @@
 http_interactions:
 - request:
     method: get
-    uri: http://ws.geonames.org/postalCodeSearch?maxRows=10&placename=Adelaide
+    uri: http://api.geonames.org/postalCodeSearch?maxRows=10&placename=Adelaide&username=demo
     body:
       encoding: US-ASCII
       string: ''

data/fixtures/vcr_cassettes/geonames_geocode_premium.yml

@@ -0,0 +1,42 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://ws.geonames.net/postalCodeSearch?maxRows=10&placename=Adelaide&username=demo
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Fri, 20 Jun 2014 02:41:39 GMT
+      Server:
+      - Apache/2.2.17 (Linux/SUSE)
+      Cache-Control:
+      - no-cache
+      Access-Control-Allow-Origin:
+      - '*'
+      Transfer-Encoding:
+      - chunked
+      Content-Type:
+      - text/xml;charset=UTF-8
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" encoding="UTF-8" standalone="no"?>
+        <geonames>
+        <status message="Please provide a valid username for the GeoNames Premium Web Service or use the free api.geonames.org server. Thank you for your understanding." value="10"/>
+        </geonames>
+    http_version: 
+  recorded_at: Fri, 20 Jun 2014 02:41:29 GMT
+recorded_with: VCR 2.9.2

data/fixtures/vcr_cassettes/google_country_code_biased_result_orly.yml

@@ -0,0 +1,160 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://maps.google.com/maps/api/geocode/json?address=orly&region=fr&sensor=false
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json; charset=UTF-8
+      Date:
+      - Tue, 23 Sep 2014 13:48:29 GMT
+      Expires:
+      - Wed, 24 Sep 2014 13:48:29 GMT
+      Cache-Control:
+      - public, max-age=86400
+      Vary:
+      - Accept-Language
+      Access-Control-Allow-Origin:
+      - "*"
+      Server:
+      - mafe
+      X-Xss-Protection:
+      - 1; mode=block
+      X-Frame-Options:
+      - SAMEORIGIN
+      Alternate-Protocol:
+      - 443:quic,p=0.002
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        ewogICAicmVzdWx0cyIgOiBbCiAgICAgIHsKICAgICAgICAgImFkZHJlc3Nf
+        Y29tcG9uZW50cyIgOiBbCiAgICAgICAgICAgIHsKICAgICAgICAgICAgICAg
+        ImxvbmdfbmFtZSIgOiAiT3JseSIsCiAgICAgICAgICAgICAgICJzaG9ydF9u
+        YW1lIiA6ICJPcmx5IiwKICAgICAgICAgICAgICAgInR5cGVzIiA6IFsgImxv
+        Y2FsaXR5IiwgInBvbGl0aWNhbCIgXQogICAgICAgICAgICB9LAogICAgICAg
+        ICAgICB7CiAgICAgICAgICAgICAgICJsb25nX25hbWUiIDogIlZhbC1kZS1N
+        YXJuZSIsCiAgICAgICAgICAgICAgICJzaG9ydF9uYW1lIiA6ICI5NCIsCiAg
+        ICAgICAgICAgICAgICJ0eXBlcyIgOiBbICJhZG1pbmlzdHJhdGl2ZV9hcmVh
+        X2xldmVsXzIiLCAicG9saXRpY2FsIiBdCiAgICAgICAgICAgIH0sCiAgICAg
+        ICAgICAgIHsKICAgICAgICAgICAgICAgImxvbmdfbmFtZSIgOiAiw45sZS1k
+        ZS1GcmFuY2UiLAogICAgICAgICAgICAgICAic2hvcnRfbmFtZSIgOiAiSURG
+        IiwKICAgICAgICAgICAgICAgInR5cGVzIiA6IFsgImFkbWluaXN0cmF0aXZl
+        X2FyZWFfbGV2ZWxfMSIsICJwb2xpdGljYWwiIF0KICAgICAgICAgICAgfSwK
+        ICAgICAgICAgICAgewogICAgICAgICAgICAgICAibG9uZ19uYW1lIiA6ICJG
+        cmFuY2UiLAogICAgICAgICAgICAgICAic2hvcnRfbmFtZSIgOiAiRlIiLAog
+        ICAgICAgICAgICAgICAidHlwZXMiIDogWyAiY291bnRyeSIsICJwb2xpdGlj
+        YWwiIF0KICAgICAgICAgICAgfQogICAgICAgICBdLAogICAgICAgICAiZm9y
+        bWF0dGVkX2FkZHJlc3MiIDogIk9ybHksIEZyYW5jZSIsCiAgICAgICAgICJn
+        ZW9tZXRyeSIgOiB7CiAgICAgICAgICAgICJib3VuZHMiIDogewogICAgICAg
+        ICAgICAgICAibm9ydGhlYXN0IiA6IHsKICAgICAgICAgICAgICAgICAgImxh
+        dCIgOiA0OC43NTI4ODUsCiAgICAgICAgICAgICAgICAgICJsbmciIDogMi40
+        MzY2OTQKICAgICAgICAgICAgICAgfSwKICAgICAgICAgICAgICAgInNvdXRo
+        d2VzdCIgOiB7CiAgICAgICAgICAgICAgICAgICJsYXQiIDogNDguNzI3NjQ5
+        MSwKICAgICAgICAgICAgICAgICAgImxuZyIgOiAyLjM2OTMyMDkKICAgICAg
+        ICAgICAgICAgfQogICAgICAgICAgICB9LAogICAgICAgICAgICAibG9jYXRp
+        b24iIDogewogICAgICAgICAgICAgICAibGF0IiA6IDQ4Ljc0NTE5MywKICAg
+        ICAgICAgICAgICAgImxuZyIgOiAyLjQwMTM3MwogICAgICAgICAgICB9LAog
+        ICAgICAgICAgICAibG9jYXRpb25fdHlwZSIgOiAiQVBQUk9YSU1BVEUiLAog
+        ICAgICAgICAgICAidmlld3BvcnQiIDogewogICAgICAgICAgICAgICAibm9y
+        dGhlYXN0IiA6IHsKICAgICAgICAgICAgICAgICAgImxhdCIgOiA0OC43NTI4
+        ODUsCiAgICAgICAgICAgICAgICAgICJsbmciIDogMi40MzY2OTQKICAgICAg
+        ICAgICAgICAgfSwKICAgICAgICAgICAgICAgInNvdXRod2VzdCIgOiB7CiAg
+        ICAgICAgICAgICAgICAgICJsYXQiIDogNDguNzI3NjQ5MSwKICAgICAgICAg
+        ICAgICAgICAgImxuZyIgOiAyLjM2OTMyMDkKICAgICAgICAgICAgICAgfQog
+        ICAgICAgICAgICB9CiAgICAgICAgIH0sCiAgICAgICAgICJ0eXBlcyIgOiBb
+        ICJsb2NhbGl0eSIsICJwb2xpdGljYWwiIF0KICAgICAgfSwKICAgICAgewog
+        ICAgICAgICAiYWRkcmVzc19jb21wb25lbnRzIiA6IFsKICAgICAgICAgICAg
+        ewogICAgICAgICAgICAgICAibG9uZ19uYW1lIiA6ICJPcmx5IEFpcnBvcnQi
+        LAogICAgICAgICAgICAgICAic2hvcnRfbmFtZSIgOiAiT3JseSBBaXJwb3J0
+        IiwKICAgICAgICAgICAgICAgInR5cGVzIiA6IFsgImVzdGFibGlzaG1lbnQi
+        IF0KICAgICAgICAgICAgfSwKICAgICAgICAgICAgewogICAgICAgICAgICAg
+        ICAibG9uZ19uYW1lIiA6ICJPcmx5IiwKICAgICAgICAgICAgICAgInNob3J0
+        X25hbWUiIDogIk9ybHkiLAogICAgICAgICAgICAgICAidHlwZXMiIDogWyAi
+        bG9jYWxpdHkiLCAicG9saXRpY2FsIiBdCiAgICAgICAgICAgIH0sCiAgICAg
+        ICAgICAgIHsKICAgICAgICAgICAgICAgImxvbmdfbmFtZSIgOiAiw45sZS1k
+        ZS1GcmFuY2UiLAogICAgICAgICAgICAgICAic2hvcnRfbmFtZSIgOiAiSURG
+        IiwKICAgICAgICAgICAgICAgInR5cGVzIiA6IFsgImFkbWluaXN0cmF0aXZl
+        X2FyZWFfbGV2ZWxfMSIsICJwb2xpdGljYWwiIF0KICAgICAgICAgICAgfSwK
+        ICAgICAgICAgICAgewogICAgICAgICAgICAgICAibG9uZ19uYW1lIiA6ICJG
+        cmFuY2UiLAogICAgICAgICAgICAgICAic2hvcnRfbmFtZSIgOiAiRlIiLAog
+        ICAgICAgICAgICAgICAidHlwZXMiIDogWyAiY291bnRyeSIsICJwb2xpdGlj
+        YWwiIF0KICAgICAgICAgICAgfSwKICAgICAgICAgICAgewogICAgICAgICAg
+        ICAgICAibG9uZ19uYW1lIiA6ICI5NDM5MCIsCiAgICAgICAgICAgICAgICJz
+        aG9ydF9uYW1lIiA6ICI5NDM5MCIsCiAgICAgICAgICAgICAgICJ0eXBlcyIg
+        OiBbICJwb3N0YWxfY29kZSIgXQogICAgICAgICAgICB9CiAgICAgICAgIF0s
+        CiAgICAgICAgICJmb3JtYXR0ZWRfYWRkcmVzcyIgOiAiT3JseSBBaXJwb3J0
+        LCA5NDM5MCBPcmx5LCBGcmFuY2UiLAogICAgICAgICAiZ2VvbWV0cnkiIDog
+        ewogICAgICAgICAgICAiYm91bmRzIiA6IHsKICAgICAgICAgICAgICAgIm5v
+        cnRoZWFzdCIgOiB7CiAgICAgICAgICAgICAgICAgICJsYXQiIDogNDguNzQ2
+        MTA0NiwKICAgICAgICAgICAgICAgICAgImxuZyIgOiAyLjQwNzI5NTcKICAg
+        ICAgICAgICAgICAgfSwKICAgICAgICAgICAgICAgInNvdXRod2VzdCIgOiB7
+        CiAgICAgICAgICAgICAgICAgICJsYXQiIDogNDguNzEzMTY1OSwKICAgICAg
+        ICAgICAgICAgICAgImxuZyIgOiAyLjMxMDI4MDMKICAgICAgICAgICAgICAg
+        fQogICAgICAgICAgICB9LAogICAgICAgICAgICAibG9jYXRpb24iIDogewog
+        ICAgICAgICAgICAgICAibGF0IiA6IDQ4LjcyNjI0MzMsCiAgICAgICAgICAg
+        ICAgICJsbmciIDogMi4zNjUyNDcyCiAgICAgICAgICAgIH0sCiAgICAgICAg
+        ICAgICJsb2NhdGlvbl90eXBlIiA6ICJBUFBST1hJTUFURSIsCiAgICAgICAg
+        ICAgICJ2aWV3cG9ydCIgOiB7CiAgICAgICAgICAgICAgICJub3J0aGVhc3Qi
+        IDogewogICAgICAgICAgICAgICAgICAibGF0IiA6IDQ4Ljc0NjEwNDYsCiAg
+        ICAgICAgICAgICAgICAgICJsbmciIDogMi40MDcyOTU3CiAgICAgICAgICAg
+        ICAgIH0sCiAgICAgICAgICAgICAgICJzb3V0aHdlc3QiIDogewogICAgICAg
+        ICAgICAgICAgICAibGF0IiA6IDQ4LjcxMzE2NTksCiAgICAgICAgICAgICAg
+        ICAgICJsbmciIDogMi4zMTAyODAzCiAgICAgICAgICAgICAgIH0KICAgICAg
+        ICAgICAgfQogICAgICAgICB9LAogICAgICAgICAidHlwZXMiIDogWyAiYWly
+        cG9ydCIsICJ0cmFuc2l0X3N0YXRpb24iLCAiZXN0YWJsaXNobWVudCIgXQog
+        ICAgICB9LAogICAgICB7CiAgICAgICAgICJhZGRyZXNzX2NvbXBvbmVudHMi
+        IDogWwogICAgICAgICAgICB7CiAgICAgICAgICAgICAgICJsb25nX25hbWUi
+        IDogIk9ybHktc3VyLU1vcmluIiwKICAgICAgICAgICAgICAgInNob3J0X25h
+        bWUiIDogIk9ybHktc3VyLU1vcmluIiwKICAgICAgICAgICAgICAgInR5cGVz
+        IiA6IFsgImxvY2FsaXR5IiwgInBvbGl0aWNhbCIgXQogICAgICAgICAgICB9
+        LAogICAgICAgICAgICB7CiAgICAgICAgICAgICAgICJsb25nX25hbWUiIDog
+        IlNlaW5lLWV0LU1hcm5lIiwKICAgICAgICAgICAgICAgInNob3J0X25hbWUi
+        IDogIjc3IiwKICAgICAgICAgICAgICAgInR5cGVzIiA6IFsgImFkbWluaXN0
+        cmF0aXZlX2FyZWFfbGV2ZWxfMiIsICJwb2xpdGljYWwiIF0KICAgICAgICAg
+        ICAgfSwKICAgICAgICAgICAgewogICAgICAgICAgICAgICAibG9uZ19uYW1l
+        IiA6ICLDjmxlLWRlLUZyYW5jZSIsCiAgICAgICAgICAgICAgICJzaG9ydF9u
+        YW1lIiA6ICJJREYiLAogICAgICAgICAgICAgICAidHlwZXMiIDogWyAiYWRt
+        aW5pc3RyYXRpdmVfYXJlYV9sZXZlbF8xIiwgInBvbGl0aWNhbCIgXQogICAg
+        ICAgICAgICB9LAogICAgICAgICAgICB7CiAgICAgICAgICAgICAgICJsb25n
+        X25hbWUiIDogIkZyYW5jZSIsCiAgICAgICAgICAgICAgICJzaG9ydF9uYW1l
+        IiA6ICJGUiIsCiAgICAgICAgICAgICAgICJ0eXBlcyIgOiBbICJjb3VudHJ5
+        IiwgInBvbGl0aWNhbCIgXQogICAgICAgICAgICB9CiAgICAgICAgIF0sCiAg
+        ICAgICAgICJmb3JtYXR0ZWRfYWRkcmVzcyIgOiAiT3JseS1zdXItTW9yaW4s
+        IEZyYW5jZSIsCiAgICAgICAgICJnZW9tZXRyeSIgOiB7CiAgICAgICAgICAg
+        ICJib3VuZHMiIDogewogICAgICAgICAgICAgICAibm9ydGhlYXN0IiA6IHsK
+        ICAgICAgICAgICAgICAgICAgImxhdCIgOiA0OC45MTM2MTMsCiAgICAgICAg
+        ICAgICAgICAgICJsbmciIDogMy4yNTI2MjUKICAgICAgICAgICAgICAgfSwK
+        ICAgICAgICAgICAgICAgInNvdXRod2VzdCIgOiB7CiAgICAgICAgICAgICAg
+        ICAgICJsYXQiIDogNDguODg3NjMyLAogICAgICAgICAgICAgICAgICAibG5n
+        IiA6IDMuMjA0MzUyCiAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgfSwK
+        ICAgICAgICAgICAgImxvY2F0aW9uIiA6IHsKICAgICAgICAgICAgICAgImxh
+        dCIgOiA0OC45MDM4NzY5OTk5OTk5OSwKICAgICAgICAgICAgICAgImxuZyIg
+        OiAzLjIyOTgzNgogICAgICAgICAgICB9LAogICAgICAgICAgICAibG9jYXRp
+        b25fdHlwZSIgOiAiQVBQUk9YSU1BVEUiLAogICAgICAgICAgICAidmlld3Bv
+        cnQiIDogewogICAgICAgICAgICAgICAibm9ydGhlYXN0IiA6IHsKICAgICAg
+        ICAgICAgICAgICAgImxhdCIgOiA0OC45MTM2MTMsCiAgICAgICAgICAgICAg
+        ICAgICJsbmciIDogMy4yNTI2MjUKICAgICAgICAgICAgICAgfSwKICAgICAg
+        ICAgICAgICAgInNvdXRod2VzdCIgOiB7CiAgICAgICAgICAgICAgICAgICJs
+        YXQiIDogNDguODg3NjMyLAogICAgICAgICAgICAgICAgICAibG5nIiA6IDMu
+        MjA0MzUyCiAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgfQogICAgICAg
+        ICB9LAogICAgICAgICAidHlwZXMiIDogWyAibG9jYWxpdHkiLCAicG9saXRp
+        Y2FsIiBdCiAgICAgIH0KICAgXSwKICAgInN0YXR1cyIgOiAiT0siCn0K
+    http_version: 
+  recorded_at: Tue, 23 Sep 2014 13:48:29 GMT
+recorded_with: VCR 2.9.3

data/fixtures/vcr_cassettes/google_country_code_biased_result_toledo.yml

@@ -0,0 +1,111 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://maps.google.com/maps/api/geocode/json?address=toledo&region=es&sensor=false
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json; charset=UTF-8
+      Date:
+      - Tue, 23 Sep 2014 13:48:29 GMT
+      Expires:
+      - Wed, 24 Sep 2014 13:48:29 GMT
+      Cache-Control:
+      - public, max-age=86400
+      Vary:
+      - Accept-Language
+      Access-Control-Allow-Origin:
+      - "*"
+      Server:
+      - mafe
+      X-Xss-Protection:
+      - 1; mode=block
+      X-Frame-Options:
+      - SAMEORIGIN
+      Alternate-Protocol:
+      - 443:quic,p=0.002
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: UTF-8
+      string: |
+        {
+           "results" : [
+              {
+                 "address_components" : [
+                    {
+                       "long_name" : "Toledo",
+                       "short_name" : "Toledo",
+                       "types" : [ "locality", "political" ]
+                    },
+                    {
+                       "long_name" : "Toledo",
+                       "short_name" : "Toledo",
+                       "types" : [ "administrative_area_level_4", "political" ]
+                    },
+                    {
+                       "long_name" : "Toledo",
+                       "short_name" : "TO",
+                       "types" : [ "administrative_area_level_2", "political" ]
+                    },
+                    {
+                       "long_name" : "Castile-La Mancha",
+                       "short_name" : "CM",
+                       "types" : [ "administrative_area_level_1", "political" ]
+                    },
+                    {
+                       "long_name" : "Spain",
+                       "short_name" : "ES",
+                       "types" : [ "country", "political" ]
+                    }
+                 ],
+                 "formatted_address" : "Toledo, Toledo, Spain",
+                 "geometry" : {
+                    "bounds" : {
+                       "northeast" : {
+                          "lat" : 39.88605099999999,
+                          "lng" : -3.9192423
+                       },
+                       "southwest" : {
+                          "lat" : 39.8383676,
+                          "lng" : -4.0629256
+                       }
+                    },
+                    "location" : {
+                       "lat" : 39.8628316,
+                       "lng" : -4.027323099999999
+                    },
+                    "location_type" : "APPROXIMATE",
+                    "viewport" : {
+                       "northeast" : {
+                          "lat" : 39.88605099999999,
+                          "lng" : -3.9192423
+                       },
+                       "southwest" : {
+                          "lat" : 39.8383676,
+                          "lng" : -4.0629256
+                       }
+                    }
+                 },
+                 "types" : [ "locality", "political" ]
+              }
+           ],
+           "status" : "OK"
+        }
+    http_version: 
+  recorded_at: Tue, 23 Sep 2014 13:48:29 GMT
+recorded_with: VCR 2.9.3