google-maps 1.0.0

data/spec/fixtures/geocoder/science-park-400-amsterdam-en.json

@@ -0,0 +1,78 @@
+{
+  "results" : [
+    {
+      "address_components" : [
+        {
+          "long_name" : "400",
+          "short_name" : "400",
+          "types" : [ "street_number" ]
+        },
+        {
+          "long_name" : "University of Amsterdam",
+          "short_name" : "University of Amsterdam",
+          "types" : [ "establishment" ]
+        },
+        {
+          "long_name" : "Science Park Amsterdam",
+          "short_name" : "Science Park Amsterdam",
+          "types" : [ "route" ]
+        },
+        {
+          "long_name" : "Middenmeer",
+          "short_name" : "Middenmeer",
+          "types" : [ "sublocality", "political" ]
+        },
+        {
+          "long_name" : "Watergraafsmeer",
+          "short_name" : "Watergraafsmeer",
+          "types" : [ "sublocality", "political" ]
+        },
+        {
+          "long_name" : "Amsterdam",
+          "short_name" : "Amsterdam",
+          "types" : [ "locality", "political" ]
+        },
+        {
+          "long_name" : "Government of Amsterdam",
+          "short_name" : "Government of Amsterdam",
+          "types" : [ "administrative_area_level_2", "political" ]
+        },
+        {
+          "long_name" : "Noord-Holland",
+          "short_name" : "NH",
+          "types" : [ "administrative_area_level_1", "political" ]
+        },
+        {
+          "long_name" : "The Netherlands",
+          "short_name" : "NL",
+          "types" : [ "country", "political" ]
+        },
+        {
+          "long_name" : "1098 XH",
+          "short_name" : "1098 XH",
+          "types" : [ "postal_code" ]
+        }
+      ],
+      "formatted_address" : "Science Park Amsterdam 400, University of Amsterdam, 1098 XH Amsterdam, The Netherlands",
+      "geometry" : {
+        "location" : {
+          "lat" : 52.3564490,
+          "lng" : 4.95568890
+        },
+        "location_type" : "ROOFTOP",
+        "viewport" : {
+          "northeast" : {
+            "lat" : 52.35779798029149,
+            "lng" : 4.957037880291502
+          },
+          "southwest" : {
+            "lat" : 52.35510001970850,
+            "lng" : 4.954339919708498
+          }
+        }
+      },
+      "types" : [ "street_address" ]
+    }
+  ],
+  "status" : "OK"
+}

data/spec/fixtures/geocoder/science-park-400-amsterdam-nl.json

@@ -0,0 +1,78 @@
+{
+  "results" : [
+    {
+      "address_components" : [
+        {
+          "long_name" : "400",
+          "short_name" : "400",
+          "types" : [ "street_number" ]
+        },
+        {
+          "long_name" : "Amsterdam",
+          "short_name" : "Amsterdam",
+          "types" : [ "establishment" ]
+        },
+        {
+          "long_name" : "Science Park",
+          "short_name" : "Science Park",
+          "types" : [ "route" ]
+        },
+        {
+          "long_name" : "Middenmeer",
+          "short_name" : "Middenmeer",
+          "types" : [ "sublocality", "political" ]
+        },
+        {
+          "long_name" : "Watergraafsmeer",
+          "short_name" : "Watergraafsmeer",
+          "types" : [ "sublocality", "political" ]
+        },
+        {
+          "long_name" : "Amsterdam",
+          "short_name" : "Amsterdam",
+          "types" : [ "locality", "political" ]
+        },
+        {
+          "long_name" : "Amsterdam",
+          "short_name" : "Amsterdam",
+          "types" : [ "administrative_area_level_2", "political" ]
+        },
+        {
+          "long_name" : "Noord-Holland",
+          "short_name" : "NH",
+          "types" : [ "administrative_area_level_1", "political" ]
+        },
+        {
+          "long_name" : "Nederland",
+          "short_name" : "NL",
+          "types" : [ "country", "political" ]
+        },
+        {
+          "long_name" : "1098 XH",
+          "short_name" : "1098 XH",
+          "types" : [ "postal_code" ]
+        }
+      ],
+      "formatted_address" : "Science Park 400, Amsterdam, 1098 XH Amsterdam, Nederland",
+      "geometry" : {
+        "location" : {
+          "lat" : 52.3564490,
+          "lng" : 4.95568890
+        },
+        "location_type" : "ROOFTOP",
+        "viewport" : {
+          "northeast" : {
+            "lat" : 52.35779798029149,
+            "lng" : 4.957037880291502
+          },
+          "southwest" : {
+            "lat" : 52.35510001970850,
+            "lng" : 4.954339919708498
+          }
+        }
+      },
+      "types" : [ "street_address" ]
+    }
+  ],
+  "status" : "OK"
+}

data/spec/fixtures/over_query_limit.json

@@ -0,0 +1,4 @@
+{
+   "routes" : [],
+   "status" : "OVER_QUERY_LIMIT"
+}

data/spec/fixtures/place_details.json

@@ -0,0 +1,131 @@
+{
+   "html_attributions" : [],
+   "result" : {
+      "address_components" : [
+         {
+            "long_name" : "48",
+            "short_name" : "48",
+            "types" : [ "street_number" ]
+         },
+         {
+            "long_name" : "Pirrama Road",
+            "short_name" : "Pirrama Road",
+            "types" : [ "route" ]
+         },
+         {
+            "long_name" : "Pyrmont",
+            "short_name" : "Pyrmont",
+            "types" : [ "locality", "political" ]
+         },
+         {
+            "long_name" : "NSW",
+            "short_name" : "NSW",
+            "types" : [ "administrative_area_level_1", "political" ]
+         },
+         {
+            "long_name" : "AU",
+            "short_name" : "AU",
+            "types" : [ "country", "political" ]
+         },
+         {
+            "long_name" : "2009",
+            "short_name" : "2009",
+            "types" : [ "postal_code" ]
+         }
+      ],
+      "formatted_address" : "5/48 Pirrama Road, Pyrmont NSW, Australia",
+      "geometry" : {
+         "location" : {
+            "lat" : -33.8669750,
+            "lng" : 151.1956770
+         }
+      },
+      "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+      "id" : "4f89212bf76dde31f092cfc14d7506555d85b5c7",
+      "name" : "Google Sydney",
+      "photos" : [
+         {
+            "height" : 1536,
+            "html_attributions" : [],
+            "photo_reference" : "CoQBcgAAALLroO5acXwquBFUPyAbemoxDjt4Dx8fu0bNzwQFSnFRMuu3UcTGH5GUzCb7tqO9kR0016cDjqFyIfdDHDZrsF101R_wXCtsHLxh-h9oww3qQOCqvrA8IkyBu8egY6ZSII0JPKhKYsT9DpbR5FDtWW5lUbnfq-Y7LWCZIKIghPM6EhCuQBKLOxZBv0nBzkHbGaG2GhQvoB4JGipfjK_F4hEfBB4SnljN2Q",
+            "width" : 2048
+         },
+         {
+            "height" : 480,
+            "html_attributions" : [],
+            "photo_reference" : "CnRqAAAAln93UDawHiQrVVVo9_V_GG9GniClBhwSS7EniT10_AvNZmW9LlMgbWi9eXSusyq3j5Es9xDrQ1Zsvub7uQx5bxOCBOnKzkTrucKD_Mi84aE0scpk2i3tIhs2Jdb07sruocLBNs4v5OTLQxQgVj-inxIQDnl1mmvxXSkQCs296xQBLRoUEw6XEGHSfvyzUEBSz_mqVgx9R4I",
+            "width" : 640
+         }
+      ],
+      "rating" : 4.70,
+      "reference" : "CpQBiAAAAGs4XDizjQoVk9NjuY3ll3aLBLafpDxaFPSJSO7icOj07IRHO4KjjcRIbKEmeSVTcG75kIvwqE7VzA8D7BFvWp8OPwgAiKMveQQUsTGfJrRG5EVd7J34hY8e5JDbaXEPOMUPIWLfiugwUfQqAImvWQCGrMG1iyOpZfaW22NNhornssEg90uxrLbwLJ7QZhwGIRIQSBc_BlD7mILqQaixzTqE1BoUbNrhbmsZYkIurvK4l9exKBryfKk",
+      "reviews" : [
+         {
+            "aspects" : [
+               {
+                  "rating" : 0,
+                  "type" : "quality"
+               }
+            ],
+            "author_name" : "Vanessa Wiseman",
+            "author_url" : "https://plus.google.com/118187699378922275112",
+            "text" : "Google advertising is EVIL! It is not a fair forum and Google wont help. They never help. Good luck speaking with a real human. Competitors can post any nasty unture statements they like to ruin your business. Google doesnt care. Google + Sux. I wish i had never heard of it. Woopdi they have given themselves great pay and a great office and free food. I hope you choke on it. Stop patting your self on the back and try listening to small business and actually doing some work instead of having meetings and discussing how good you think you all are. PS. Lets see if you keep this review, or delete it. BECAUSE ITS TRUE!!!!!!",
+            "time" : 1346283496
+         },
+         {
+            "aspects" : [
+               {
+                  "rating" : 0,
+                  "type" : "quality"
+               }
+            ],
+            "author_name" : "Sunstruck Window Cleaning Hornsby",
+            "author_url" : "https://plus.google.com/103617623203300214486",
+            "text" : "I agree with Vanessa Wiseman. Google doesn't give a damm about your business and reviews unless they are making money from you. I have spent years and thousands on getting my business on their first page only for some reason that I can't get an explanation from anyone disappeared a few days ago. I went from being number 1 in the organic listing to gone, no where to be seen. WHY GOOGLE? WHY HAS MY BUSINESS AD SUDDENLY DISAPPEARED?",
+            "time" : 1348551490
+         },
+         {
+            "aspects" : [
+               {
+                  "rating" : 3,
+                  "type" : "overall"
+               }
+            ],
+            "author_name" : "Joseph Wang",
+            "author_url" : "https://plus.google.com/100092142084689765727",
+            "text" : "Born from the depths of Sydney Harbour, the Accenture building transcends the ephemeral to become a landmark of liberty of freedom. Within the predefined boundaries of this establishment lies the brain, heart and soul of Google Sydney. And may this magnificent deity continue to be for eternity.",
+            "time" : 1329380640
+         },
+         {
+            "aspects" : [
+               {
+                  "rating" : 3,
+                  "type" : "quality"
+               }
+            ],
+            "author_name" : "Tim Lacey",
+            "author_url" : "https://plus.google.com/111157746837259488919",
+            "text" : "What I would give to work here: ALL OF THE THINGS!!! Nerds in their element and Australia's Best Place to Work in 2011.",
+            "time" : 1338385221
+         },
+         {
+            "aspects" : [
+               {
+                  "rating" : 3,
+                  "type" : "quality"
+               }
+            ],
+            "author_name" : "Simon Bengtsson",
+            "author_url" : "https://plus.google.com/104675092887960962573",
+            "text" : "Just went inside to have a look at Google. Amazing.",
+            "time" : 1338440552
+         }
+      ],
+      "types" : [ "establishment" ],
+      "url" : "https://plus.google.com/111840715355681175070/about?hl=en-US",
+      "utc_offset" : 660,
+      "vicinity" : "5/48 Pirrama Road, Pyrmont",
+      "website" : "http://www.google.com.au/"
+   },
+   "status" : "OK"
+}

data/spec/fixtures/zero-results.json

@@ -0,0 +1,4 @@
+{
+  "results" : [],
+  "status" : "ZERO_RESULTS"
+}

data/spec/google-maps/api_spec.rb

@@ -0,0 +1,103 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+describe Google::Maps::API do
+  it "should raise a custom exception when the query fails by net" do
+    HTTPClient.any_instance.unstub(:get_content)
+    
+    Google::Maps.end_point = "http://unknown.tld/"
+    lambda{ Google::Maps.distance("Amsterdam", "Deventer") }.should raise_error(Google::Maps::InvalidResponseException)
+    Google::Maps.end_point = "http://unknown-domain-asdasdasdas123123zxcasd.com/"
+    lambda{ Google::Maps.distance("Amsterdam", "Deventer") }.should raise_error(Google::Maps::InvalidResponseException)
+    Google::Maps.end_point = "http://www.google.com/404"
+    lambda{ Google::Maps.distance("Amsterdam", "Deventer") }.should raise_error(Google::Maps::InvalidResponseException)
+  end
+
+  it "should raise a custom exception when the query fails by Google" do
+    stub_response("over_query_limit.json")
+    lambda{ Google::Maps.distance("Amsterdam", "Deventer") }.should raise_error(Google::Maps::InvalidResponseException)    
+  end
+
+  it "should raise a custom exception when there are no results" do
+    stub_response("zero-results.json")
+    lambda{ Google::Maps.distance("Blah blah", "Jalala") }.should raise_error(Google::Maps::ZeroResultsException)
+  end
+
+  it "should raise a custom exception that is rescue-able" do
+    stub_response("zero-results.json")
+    begin
+      Google::Maps.distance("Blah blah", "Jalala")
+    rescue => error
+      @error = error
+    ensure
+      @error.should_not be_nil
+      @error.should be_a_kind_of StandardError
+    end
+  end
+
+  describe "premier signing" do
+    before :each do 
+      Google::Maps.configure do |config|
+        config.premier_client_id = "clientID"
+        config.premier_key = "vNIXE0xscrmjlyV-12Nj_BvUPaw="
+      end
+    end
+    
+    it "should raise an exception when a client id is set but no key" do
+      Google::Maps.premier_key = nil
+      lambda{ Google::Maps.distance("Amsterdam", "Deventer") }.should raise_error(Google::Maps::InvalidPremierConfigurationException)
+    end
+    
+    it "should sign the url parameters when a client id and premier key is set" do
+      # http://code.google.com/apis/maps/documentation/webservices/index.html#URLSigning
+
+      # Example:
+      # Private Key: vNIXE0xscrmjlyV-12Nj_BvUPaw=
+      # Signature: KrU1TzVQM7Ur0i8i7K3huiw3MsA=
+      # Client ID: clientID
+      # URL: http://maps.googleapis.com/maps/api/geocode/json?address=New+York&sensor=false&client=clientID
+      url = "http://maps.google.com/maps/api/geocode/json?address=New+York&sensor=false&client=clientID"
+      signed_url = Google::Maps::API.send(:premier_signing, url)
+      signed_url.should == "#{url}&signature=KrU1TzVQM7Ur0i8i7K3huiw3MsA="
+    end
+    
+    it "should allow a parsed URI object to be used for signing" do
+      url = URI.parse("http://maps.google.com/maps/api/geocode/json?address=New+York&sensor=false&client=clientID")
+      signed_url = Google::Maps::API.send(:premier_signing, url)
+      signed_url.should == "#{url}&signature=KrU1TzVQM7Ur0i8i7K3huiw3MsA="
+    end
+
+    context "per service overrides" do
+      let(:reference) { "CpQBiAAAAGs4XDizjQoVk9NjuY3ll3aLBLafpDxaFPSJSO7icOj07IRHO4KjjcRIbKEmeSVTcG75kIvwqE7VzA8D7BFvWp8OPwgAiKMveQQUsTGfJrRG5EVd7J34hY8e5JDbaXEPOMUPIWLfiugwUfQqAImvWQCGrMG1iyOpZfaW22NNhornssEg90uxrLbwLJ7QZhwGIRIQSBc_BlD7mILqQaixzTqE1BoUbNrhbmsZYkIurvK4l9exKBryfKk" }
+      let(:api_key) { "some_api_key" }
+      let(:parameters) { [:premier_client_id, :premier_key, :api_key, :default_params] }
+
+      before :each do
+        parameters.each do |what|
+          self.instance_variable_set(:"@old_#{what}", Google::Maps.send(what))
+        end
+
+        Google::Maps.configure do |config|
+          config.premier_client_id = "gme-test"
+          config.premier_key = "secret"
+          config.api_key = api_key
+          config.default_params = {place_details_service: {:use_premier_signing => false}}
+        end
+      end
+
+      after :each do
+        Google::Maps.configure do |config|
+          parameters.each do |what|
+            config.send(:"#{what}=", self.instance_variable_get(:"@old_#{what}"))
+          end
+        end
+      end
+
+      it "should not be used when configured for a certain service" do
+        stub_response("place_details.json", "https://maps.googleapis.com/maps/api/place/details/json?sensor=false&language=nl&reference=#{reference}&key=#{api_key}")
+
+        Google::Maps::place(reference, :nl).should_not be_nil
+      end
+    end
+  end
+
+end

data/spec/google-maps/logger_spec.rb

@@ -0,0 +1,15 @@
+require File.expand_path('../../spec_helper', __FILE__)
+require 'logger'
+
+describe Google::Maps::Logger do
+  it "should be able to log messages when a log output is set" do
+    # fake an exception
+    HTTPClient.any_instance.expects(:get_content).raises("test exception")
+    
+    # expect the logger to be called once
+    Logger.any_instance.expects(:error).at_least_once
+
+    # trigger the exception
+    lambda{ Google::Maps.distance("Amsterdam", "Deventer") }.should raise_error
+  end
+end

data/spec/google-maps/place_details_spec.rb

@@ -0,0 +1,32 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+describe Google::Maps::PlaceDetails do
+  let(:reference) { "CpQBiAAAAGs4XDizjQoVk9NjuY3ll3aLBLafpDxaFPSJSO7icOj07IRHO4KjjcRIbKEmeSVTcG75kIvwqE7VzA8D7BFvWp8OPwgAiKMveQQUsTGfJrRG5EVd7J34hY8e5JDbaXEPOMUPIWLfiugwUfQqAImvWQCGrMG1iyOpZfaW22NNhornssEg90uxrLbwLJ7QZhwGIRIQSBc_BlD7mILqQaixzTqE1BoUbNrhbmsZYkIurvK4l9exKBryfKk" }
+
+  context "given a canned response" do
+    before(:each) do
+      stub_response("place_details.json")
+      @details = Google::Maps::PlaceDetails.find(reference, :nl)
+    end
+
+    it "should have a reference" do
+      @details.reference.should == reference
+    end
+
+    it "should have a latlong" do
+      @details.latitude.should == "-33.866975"
+      @details.longitude.should =="151.195677"
+    end
+
+    it "has data containing at least address components" do
+      @details.data.address_components.should_not be_empty
+    end
+
+    context "#address_components" do
+      it "allows easy access by type" do
+        @details.address_components.postal_code.long_name.should eq "2009"
+        @details.address_components.locality.long_name.should eq "Pyrmont"
+      end
+    end
+  end
+end