google_maps_api-directions 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c5ab55ac8c65193c48ef84b188aad24fb9cc4339
+  data.tar.gz: 64ea3b0da7201bd113dbf9ded5c00150ae22c632
+SHA512:
+  metadata.gz: b946bac2ceb2942a92fcb229dcac1e0ba070434ed4d04f37adab6427d5e204626b8d3050ed0aee38d6175f01b32a844684f05f21eee0f5eaa8bb4564da188585
+  data.tar.gz: d1955b2f858213d5665d90dccc8a903a49415934ce19544fbcd3c536b87ff0ec4050fb01dae526c0849db39ad8d3f8e546a57e4ebc6675ef5ad9c48862298dad

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--warnings
+--require spec_helper

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in google_maps_api-directions.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Felipe Zavan
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,62 @@
+# GoogleMapsAPI::Directions
+
+This is a wrapper around the Google Maps Directions API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'google_maps_api-directions'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install google_maps_api-directions
+
+## Usage
+
+```ruby
+GoogleMapsAPI::Directions.route(origin, destination, options = {})
+```
+
+Origin and destination can be an a string or anything that supports ```to_ary```.
+Options is a *Symbols* Hash with optional parameters. (See https://developers.google.com/maps/documentation/directions/#RequestParameters for more information).
+
+### Examples:
+
+```ruby
+origin = "350, 5th Ave, NY"
+destination = [40.777552, -73.954732]
+options = {:language => 'pt'}
+GoogleMapsAPI::Directions.route(origin, destination, options)
+# => #<GoogleMapsAPI::Directions::Response:0x00000001f2b510...>
+```
+
+The ```GoogleMapsAPI::Directions::Response``` mimics the API JSON structure.
+
+If you wish to call ```#coordinates``` on ```GoogleMapsAPI::Directions::EncodedPolyline``` objects,
+you will need to install the https://rubygems.org/gems/polylines gem.
+
+## Contributing
+
+I am new to Ruby and Testing. We need better specs.
+
+1. Fork it ( https://github.com/zavan/google_maps_api-directions/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+### Important
+
+* Do not touch the version;
+* Write specs for new features;
+* Be independent of Rails stuff;
+* All specs must pass.
+
+## Also see
+
+* [http://github.com/zavan/google_maps_api-core](http://github.com/zavan/google_maps_api-core)

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/google_maps_api-directions.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'google_maps_api/directions/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "google_maps_api-directions"
+  spec.version       = GoogleMapsAPI::Directions::VERSION
+  spec.authors       = ["Felipe Zavan"]
+  spec.email         = ["zavan@outlook.com"]
+  spec.summary       = %q{Wrapper around the Google Maps Directions API.}
+  spec.homepage      = "https://github.com/zavan/google_maps_api-directions"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec", ">= 3.0.0.beta2", "< 4"
+
+  spec.add_dependency "google_maps_api-core", "~> 0"
+end

data/lib/google_maps_api/directions.rb

@@ -0,0 +1,19 @@
+require "google_maps_api/directions/version"
+require "google_maps_api/core"
+require "google_maps_api/directions/request"
+require "google_maps_api/directions/route"
+require "google_maps_api/directions/bounds"
+require "google_maps_api/directions/leg"
+require "google_maps_api/directions/step"
+require "google_maps_api/directions/encoded_polyline"
+require "google_maps_api/directions/response"
+require "google_maps_api/directions/exceptions"
+
+module GoogleMapsAPI
+  module Directions
+    def self.route(origin, destination, options = {})
+      request = Request.build(origin, destination, options)
+      request.perform
+    end
+  end
+end

data/lib/google_maps_api/directions/bounds.rb

@@ -0,0 +1,21 @@
+class GoogleMapsAPI::Directions::Bounds
+  attr_reader :northeast, :southwest
+
+  def initialize(northeast, southwest)
+    @northeast = northeast
+    @southwest = southwest
+    self
+  end
+
+  def self.from_hash(hash)
+    northeast = build_coordinate(hash["northeast"])
+    southwest = build_coordinate(hash["southwest"])
+    self.new(northeast, southwest)
+  end
+
+  private
+
+  def self.build_coordinate(hash)
+    GoogleMapsAPI::Core::Coordinate.from_hash(hash)
+  end
+end

data/lib/google_maps_api/directions/encoded_polyline.rb

@@ -0,0 +1,30 @@
+class GoogleMapsAPI::Directions::EncodedPolyline
+  attr_reader :encoded
+
+  def initialize(encoded)
+    @encoded = encoded
+  end
+
+  def coordinates
+    @coordinates ||= decode
+    @coordinates
+  end
+
+  def to_s
+    encoded
+  end
+
+  private
+
+  def decode
+    begin
+      require "polylines" unless defined?(Polylines)
+      array = Polylines::Decoder.decode_polyline(encoded)
+      return array.collect do |c|
+        GoogleMapsAPI::Core::Coordinate.from_array(c)
+      end
+    rescue LoadError
+      raise "You need to install and require the 'polylines' (https://rubygems.org/gems/polylines) gem in your Gemfile if you want to use this method"
+    end
+  end
+end

data/lib/google_maps_api/directions/exceptions.rb

@@ -0,0 +1,5 @@
+class GoogleMapsAPI::Directions::Error < StandardError; end
+
+class GoogleMapsAPI::Directions::ResponseError < GoogleMapsAPI::Directions::Error
+  attr_accessor :response
+end

data/lib/google_maps_api/directions/leg.rb

@@ -0,0 +1,46 @@
+require 'google_maps_api/directions/leg_and_step_common_builders'
+
+class GoogleMapsAPI::Directions::Leg
+  extend GoogleMapsAPI::Directions::LegAndStepCommonBuilders
+
+  attr_reader :distance, :duration, :end_address, :end_location,
+              :start_address, :start_location, :steps, :via_waypoint
+
+  def initialize(
+    distance, duration, end_address, end_location,
+    start_address, start_location, steps, via_waypoint
+  )
+    @distance = distance
+    @duration = duration
+    @end_address = end_address
+    @end_location = end_location
+    @start_address = start_address
+    @start_location = start_location
+    @steps = steps
+    @via_waypoint = via_waypoint
+  end
+
+  def self.from_hash(hash)
+    distance = build_distance(hash)
+    duration = build_duration(hash)
+    end_address = hash["end_address"]
+    end_location = build_coordinate(hash["end_location"])
+    start_address = hash["start_address"]
+    start_location = build_coordinate(hash["start_location"])
+    steps = build_steps(hash)
+    via_waypoint = hash["via_waypoint"]
+
+    self.new(
+      distance, duration, end_address, end_location,
+      start_address, start_location, steps, via_waypoint
+    )
+  end
+
+  private
+
+  def self.build_steps(hash)
+    hash["steps"].collect do |s|
+      GoogleMapsAPI::Directions::Step.from_hash(s)
+    end
+  end
+end

data/lib/google_maps_api/directions/leg_and_step_common_builders.rb

@@ -0,0 +1,13 @@
+module GoogleMapsAPI::Directions::LegAndStepCommonBuilders
+  def build_distance(hash)
+    GoogleMapsAPI::Core::Distance.from_hash(hash["distance"])
+  end
+
+  def build_duration(hash)
+    GoogleMapsAPI::Core::Duration.from_hash(hash["duration"])
+  end
+
+  def build_coordinate(hash)
+    GoogleMapsAPI::Core::Coordinate.from_hash(hash)
+  end  
+end

data/lib/google_maps_api/directions/request.rb

@@ -0,0 +1,82 @@
+require "net/http"
+
+class GoogleMapsAPI::Directions::Request
+  BASE_PATH = "maps.googleapis.com/maps/api/directions/json"
+
+  attr_accessor :origin, :destination, :options, :http_adapter
+
+  def initialize(origin, destination, options = {})
+    origin = origin.to_ary.join(",") if origin.respond_to?(:to_ary)
+    destination = destination.to_ary.join(",") if destination.respond_to?(:to_ary)
+    @origin = origin
+    @destination = destination
+    @options = default_options.merge(options)
+    @http_adapter = nil
+  end
+
+  def self.build(origin, destination, options = {})
+    self.new(origin, destination, options)
+  end
+
+  def perform
+    response = http_adapter.get_response(uri)
+    if response.is_a?(Net::HTTPSuccess)
+      return GoogleMapsAPI::Directions::Response.from_json(response.body)
+    else
+      msg = "The response was not successful (200). Call #response for datails."
+      exception = GoogleMapsAPI::Directions::ResponseError.new(msg)
+      exception.response = response
+      raise exception
+    end
+  end
+
+  def uri
+    uri = URI("#{scheme}://#{BASE_PATH}")
+    query = prepared_options.merge({origin: origin, destination: destination})
+    uri.query = URI.encode_www_form(query)
+    uri
+  end
+
+  def scheme
+    options[:https] ? "https" : "http"
+  end
+
+  def http_adapter
+    @http_adapter || Net::HTTP
+  end
+
+  private
+
+  def default_options
+    {
+      sensor: false,
+      mode: "driving",
+      language: "en",
+      units: "metric",
+      region: "us"
+    }
+  end
+
+  def prepared_options
+    options = self.options.dup
+    options[:departure_time] = time_or_date_to_unix(options[:departure_time])
+    options[:arrival_time] = time_or_date_to_unix(options[:arrival_time])
+
+    if options[:waypoints].respond_to?(:collect)
+      waypoints = options[:waypoints].collect do |w|
+        w.respond_to?(:to_ary) ? w.to_ary.join(",") : w
+      end
+
+      options[:waypoints] = waypoints.join("|")
+    end
+
+    options.delete_if { |key, value| value.to_s.strip.empty? }
+    options
+  end
+
+  def time_or_date_to_unix(time_or_date)
+    return time_or_date.to_i if time_or_date.is_a?(Time)
+    return time_or_date.to_time.to_i if time_or_date.is_a?(Date)
+    time_or_date
+  end
+end

data/lib/google_maps_api/directions/response.rb

@@ -0,0 +1,29 @@
+require "google_maps_api/directions/route"
+require "json"
+
+class GoogleMapsAPI::Directions::Response
+  attr_reader :routes, :status
+
+  def initialize(routes, status)
+    @routes = routes
+    @status = status
+  end
+
+  def self.from_json(json)
+    parsed_json = parse_json(json)
+    routes = build_routes(parsed_json)
+    self.new(routes, parsed_json['status'])
+  end
+
+  private
+
+  def self.parse_json(json)
+    JSON.parse(json)
+  end
+
+  def self.build_routes(parsed_json)
+    parsed_json['routes'].collect do |r|
+      GoogleMapsAPI::Directions::Route.from_hash(r)
+    end
+  end
+end

data/lib/google_maps_api/directions/route.rb

@@ -0,0 +1,51 @@
+class GoogleMapsAPI::Directions::Route
+  attr_reader :bounds, :copyrights, :legs, 
+              :overview_polyline, :summary, 
+              :warnings, :waypoint_order
+
+  def initialize(
+    bounds, copyrights, legs, 
+    overview_polyline, summary, 
+    warnings, waypoint_order
+  )
+    @bounds = bounds
+    @copyrights = copyrights
+    @legs = legs
+    @overview_polyline = overview_polyline
+    @summary = summary
+    @warnings = warnings
+    @waypoint_order = waypoint_order
+  end
+
+  def self.from_hash(hash)
+    bounds = build_bounds(hash)
+    copyrights = hash["copyrights"]
+    legs = build_legs(hash)
+    overview_polyline = build_overview_polyline(hash)
+    summary = hash["summary"]
+    warnings = hash["warnings"]
+    waypoint_order = hash["waypoint_order"]
+
+    self.new(
+      bounds, copyrights, legs, 
+      overview_polyline, summary, 
+      warnings, waypoint_order
+    )
+  end
+
+  private
+
+  def self.build_bounds(hash)
+    GoogleMapsAPI::Directions::Bounds.from_hash(hash["bounds"])
+  end
+
+  def self.build_legs(hash)
+    hash["legs"].collect do |l|
+      GoogleMapsAPI::Directions::Leg.from_hash(l)
+    end
+  end
+
+  def self.build_overview_polyline(hash)
+    GoogleMapsAPI::Directions::EncodedPolyline.new(hash["overview_polyline"]["points"])
+  end
+end

data/lib/google_maps_api/directions/step.rb

@@ -0,0 +1,45 @@
+require 'google_maps_api/directions/leg_and_step_common_builders'
+
+class GoogleMapsAPI::Directions::Step
+  extend GoogleMapsAPI::Directions::LegAndStepCommonBuilders
+
+  attr_reader :distance, :duration, :end_location,
+              :start_location, :html_instructions, 
+              :polyline, :travel_mode
+
+  def initialize(
+    distance, duration, end_location,
+    start_location, html_instructions, 
+    polyline, travel_mode
+  )
+    @distance = distance
+    @duration = duration
+    @end_location = end_location
+    @start_location = start_location
+    @html_instructions = html_instructions
+    @polyline = polyline
+    @travel_mode = travel_mode
+  end
+
+  def self.from_hash(hash)
+    distance = build_distance(hash)
+    duration = build_duration(hash)
+    end_location = build_coordinate(hash["end_location"])
+    start_location = build_coordinate(hash["start_location"])
+    html_instructions = hash["html_instructions"]
+    polyline = build_polyline(hash)
+    travel_mode = hash["travel_mode"]
+
+    self.new(
+      distance, duration, end_location,
+      start_location, html_instructions, 
+      polyline, travel_mode
+    )
+  end
+
+  private
+
+  def self.build_polyline(hash)
+    GoogleMapsAPI::Directions::EncodedPolyline.new(hash["polyline"]["points"])
+  end
+end

data/lib/google_maps_api/directions/version.rb

@@ -0,0 +1,5 @@
+module GoogleMapsAPI
+  module Directions
+    VERSION = "0.1.0"
+  end
+end

data/spec/google_maps_api/directions/bounds_spec.rb

@@ -0,0 +1,14 @@
+require "spec_helper"
+require "google_maps_api/directions/json_response"
+
+describe GoogleMapsAPI::Directions::Bounds do
+  include_context "json response"
+
+  subject { GoogleMapsAPI::Directions::Bounds }
+
+  describe ".from_hash" do
+    it "returns a new bounds object" do
+      expect(subject.from_hash(parsed_json["routes"].first["bounds"])).to be_a(subject)
+    end
+  end
+end

data/spec/google_maps_api/directions/json_response.rb

@@ -0,0 +1,6 @@
+require "json"
+
+shared_context "json response" do
+  let(:json) { File.read("#{File.dirname(__FILE__)}/response_mock.json") }
+  let(:parsed_json) { JSON.parse(json) }
+end

data/spec/google_maps_api/directions/leg_spec.rb

@@ -0,0 +1,14 @@
+require "spec_helper"
+require "google_maps_api/directions/json_response"
+
+describe GoogleMapsAPI::Directions::Leg do
+  include_context "json response"
+
+  subject { GoogleMapsAPI::Directions::Leg }
+
+  describe ".from_hash" do
+    it "returns a new leg" do
+      expect(subject.from_hash(parsed_json["routes"].first["legs"].first)).to be_a(subject)
+    end
+  end
+end

data/spec/google_maps_api/directions/request_lets.rb

@@ -0,0 +1,5 @@
+shared_context "request lets" do
+  let(:origin) { "350, 5th Avenue, New York" }
+  let(:destination) { "100, 4th Avenue, New York" }
+  let(:options) { {} }
+end

data/spec/google_maps_api/directions/request_spec.rb

@@ -0,0 +1,52 @@
+require "spec_helper"
+require "google_maps_api/directions/request_lets"
+
+describe GoogleMapsAPI::Directions::Request do
+
+  include_context "request lets"
+
+  subject { GoogleMapsAPI::Directions::Request.new(origin, destination, options) }
+
+  describe ".build" do
+    subject { GoogleMapsAPI::Directions::Request }
+
+    it "builds a new request" do
+      expect(subject.build(origin, destination, options)).to be_a(subject)
+    end
+  end
+
+  describe "#perform" do
+    it "returns a response" do
+      expect(subject.perform).to be_a(GoogleMapsAPI::Directions::Response)
+    end
+
+    it "raises a ResponseError if the response is not successful" do
+      allow(subject.http_adapter).to receive(:get_response).and_return(false)
+      expect { subject.perform }.to raise_error(GoogleMapsAPI::Directions::ResponseError)
+    end
+  end
+
+  describe "#uri" do
+    it "returns a URI" do
+      expect(subject.uri).to be_a(URI)
+    end
+  end
+
+  describe "#scheme" do
+    context "when https option is true" do
+      subject { GoogleMapsAPI::Directions::Request.new(origin, destination, {https: true}) }
+
+      it "returns 'https'" do
+        expect(subject.scheme).to eq('https')
+      end
+    end
+
+    context "when https option is false" do
+      subject { GoogleMapsAPI::Directions::Request.new(origin, destination, {https: false}) }
+
+      it "returns 'http'" do
+        expect(subject.scheme).to eq('http')
+      end
+    end
+  end
+end

data/spec/google_maps_api/directions/response_mock.json

@@ -0,0 +1,306 @@
+{
+   "routes" : [
+      {
+         "bounds" : {
+            "northeast" : {
+               "lat" : 40.7660501,
+               "lng" : -73.9777149
+            },
+            "southwest" : {
+               "lat" : 40.7415437,
+               "lng" : -73.99280299999999
+            }
+         },
+         "copyrights" : "Map data ©2014 Google, Sanborn",
+         "legs" : [
+            {
+               "distance" : {
+                  "text" : "1.0 mi",
+                  "value" : 1540
+               },
+               "duration" : {
+                  "text" : "4 mins",
+                  "value" : 216
+               },
+               "end_address" : "200 5th Avenue, New York, NY 10010, USA",
+               "end_location" : {
+                  "lat" : 40.7419552,
+                  "lng" : -73.9893319
+               },
+               "start_address" : "350 5th Avenue, New York, NY 10118, USA",
+               "start_location" : {
+                  "lat" : 40.7479836,
+                  "lng" : -73.9848799
+               },
+               "steps" : [
+                  {
+                     "distance" : {
+                        "text" : "0.5 mi",
+                        "value" : 819
+                     },
+                     "duration" : {
+                        "text" : "1 min",
+                        "value" : 81
+                     },
+                     "end_location" : {
+                        "lat" : 40.7415437,
+                        "lng" : -73.98959259999999
+                     },
+                     "html_instructions" : "Head \u003cb\u003esouthwest\u003c/b\u003e on \u003cb\u003e5th Ave\u003c/b\u003e toward \u003cb\u003eE 33rd St\u003c/b\u003e",
+                     "polyline" : {
+                        "points" : "{quwFndqbMh@`@|BzAxBvAzBvAzBzAxBzAfBhAPL|BzA|BvAn@`@XRXRJFdAp@RPr@d@"
+                     },
+                     "start_location" : {
+                        "lat" : 40.7479836,
+                        "lng" : -73.9848799
+                     },
+                     "travel_mode" : "DRIVING"
+                  },
+                  {
+                     "distance" : {
+                        "text" : "0.2 mi",
+                        "value" : 309
+                     },
+                     "duration" : {
+                        "text" : "1 min",
+                        "value" : 38
+                     },
+                     "end_location" : {
+                        "lat" : 40.7428904,
+                        "lng" : -73.99280299999999
+                     },
+                     "html_instructions" : "Turn \u003cb\u003eright\u003c/b\u003e onto \u003cb\u003eW 23rd St\u003c/b\u003e",
+                     "maneuver" : "turn-right",
+                     "polyline" : {
+                        "points" : "sitwF|arbMsDhLyAvE"
+                     },
+                     "start_location" : {
+                        "lat" : 40.7415437,
+                        "lng" : -73.98959259999999
+                     },
+                     "travel_mode" : "DRIVING"
+                  },
+                  {
+                     "distance" : {
+                        "text" : "279 ft",
+                        "value" : 85
+                     },
+                     "duration" : {
+                        "text" : "1 min",
+                        "value" : 26
+                     },
+                     "end_location" : {
+                        "lat" : 40.7435581,
+                        "lng" : -73.9923115
+                     },
+                     "html_instructions" : "Take the 2nd \u003cb\u003eright\u003c/b\u003e onto \u003cb\u003eAvenue of the Americas\u003c/b\u003e",
+                     "polyline" : {
+                        "points" : "artwF~urbMeCaB"
+                     },
+                     "start_location" : {
+                        "lat" : 40.7428904,
+                        "lng" : -73.99280299999999
+                     },
+                     "travel_mode" : "DRIVING"
+                  },
+                  {
+                     "distance" : {
+                        "text" : "0.2 mi",
+                        "value" : 327
+                     },
+                     "duration" : {
+                        "text" : "1 min",
+                        "value" : 71
+                     },
+                     "end_location" : {
+                        "lat" : 40.7419552,
+                        "lng" : -73.9893319
+                     },
+                     "html_instructions" : "Take the 1st \u003cb\u003eright\u003c/b\u003e onto \u003cb\u003eW 24th St\u003c/b\u003e\u003cdiv style=\"font-size:0.9em\"\u003eDestination will be on the right\u003c/div\u003e",
+                     "polyline" : {
+                        "points" : "gvtwF|rrbMvFmQDE@CBCFAD?F?d@H"
+                     },
+                     "start_location" : {
+                        "lat" : 40.7435581,
+                        "lng" : -73.9923115
+                     },
+                     "travel_mode" : "DRIVING"
+                  }
+               ],
+               "via_waypoint" : []
+            },
+            {
+               "distance" : {
+                  "text" : "2.5 mi",
+                  "value" : 4090
+               },
+               "duration" : {
+                  "text" : "11 mins",
+                  "value" : 651
+               },
+               "end_address" : "100 West 56th Street, New York, NY 10019, USA",
+               "end_location" : {
+                  "lat" : 40.7636538,
+                  "lng" : -73.9777149
+               },
+               "start_address" : "200 5th Avenue, New York, NY 10010, USA",
+               "start_location" : {
+                  "lat" : 40.7419552,
+                  "lng" : -73.9893319
+               },
+               "steps" : [
+                  {
+                     "distance" : {
+                        "text" : "167 ft",
+                        "value" : 51
+                     },
+                     "duration" : {
+                        "text" : "1 min",
+                        "value" : 13
+                     },
+                     "end_location" : {
+                        "lat" : 40.7415437,
+                        "lng" : -73.98959259999999
+                     },
+                     "html_instructions" : "Head \u003cb\u003esouth\u003c/b\u003e on \u003cb\u003eW 24th St\u003c/b\u003e toward \u003cb\u003e5th Ave\u003c/b\u003e",
+                     "polyline" : {
+                        "points" : "gltwFh`rbMF@VJr@d@"
+                     },
+                     "start_location" : {
+                        "lat" : 40.7419552,
+                        "lng" : -73.9893319
+                     },
+                     "travel_mode" : "DRIVING"
+                  },
+                  {
+                     "distance" : {
+                        "text" : "0.2 mi",
+                        "value" : 309
+                     },
+                     "duration" : {
+                        "text" : "1 min",
+                        "value" : 38
+                     },
+                     "end_location" : {
+                        "lat" : 40.7428904,
+                        "lng" : -73.99280299999999
+                     },
+                     "html_instructions" : "Take the 1st \u003cb\u003eright\u003c/b\u003e onto \u003cb\u003eW 23rd St\u003c/b\u003e",
+                     "polyline" : {
+                        "points" : "sitwF|arbMsDhLyAvE"
+                     },
+                     "start_location" : {
+                        "lat" : 40.7415437,
+                        "lng" : -73.98959259999999
+                     },
+                     "travel_mode" : "DRIVING"
+                  },
+                  {
+                     "distance" : {
+                        "text" : "1.1 mi",
+                        "value" : 1762
+                     },
+                     "duration" : {
+                        "text" : "4 mins",
+                        "value" : 234
+                     },
+                     "end_location" : {
+                        "lat" : 40.7567653,
+                        "lng" : -73.98270230000001
+                     },
+                     "html_instructions" : "Take the 2nd \u003cb\u003eright\u003c/b\u003e onto \u003cb\u003eAvenue of the Americas\u003c/b\u003e",
+                     "polyline" : {
+                        "points" : "artwF~urbMeCaByBwA}ByA{B{AwBwA}ByA{ByA{ByA{B{AuByAQMuBuAgC}A{BwA{BwA{BwA}ByAwB_B}BwAIIeBeAUOeCcB}B{A{B{A"
+                     },
+                     "start_location" : {
+                        "lat" : 40.7428904,
+                        "lng" : -73.99280299999999
+                     },
+                     "travel_mode" : "DRIVING"
+                  },
+                  {
+                     "distance" : {
+                        "text" : "0.3 mi",
+                        "value" : 547
+                     },
+                     "duration" : {
+                        "text" : "2 mins",
+                        "value" : 109
+                     },
+                     "end_location" : {
+                        "lat" : 40.7591625,
+                        "lng" : -73.988378
+                     },
+                     "html_instructions" : "Turn \u003cb\u003eleft\u003c/b\u003e onto \u003cb\u003eW 45th St\u003c/b\u003e",
+                     "maneuver" : "turn-left",
+                     "polyline" : {
+                        "points" : "yhwwFzvpbMkFrPITGRi@`Bg@`B_B`Fm@jB"
+                     },
+                     "start_location" : {
+                        "lat" : 40.7567653,
+                        "lng" : -73.98270230000001
+                     },
+                     "travel_mode" : "DRIVING"
+                  },
+                  {
+                     "distance" : {
+                        "text" : "0.5 mi",
+                        "value" : 875
+                     },
+                     "duration" : {
+                        "text" : "2 mins",
+                        "value" : 97
+                     },
+                     "end_location" : {
+                        "lat" : 40.7660501,
+                        "lng" : -73.9833663
+                     },
+                     "html_instructions" : "Turn \u003cb\u003eright\u003c/b\u003e onto \u003cb\u003e8th Ave\u003c/b\u003e",
+                     "maneuver" : "turn-right",
+                     "polyline" : {
+                        "points" : "wwwwFjzqbM}ByA{B}A}BwA{B{A}ByA}B{A{B{A}ByA}ByA{B}A}ByA"
+                     },
+                     "start_location" : {
+                        "lat" : 40.7591625,
+                        "lng" : -73.988378
+                     },
+                     "travel_mode" : "DRIVING"
+                  },
+                  {
+                     "distance" : {
+                        "text" : "0.3 mi",
+                        "value" : 546
+                     },
+                     "duration" : {
+                        "text" : "3 mins",
+                        "value" : 160
+                     },
+                     "end_location" : {
+                        "lat" : 40.7636538,
+                        "lng" : -73.9777149
+                     },
+                     "html_instructions" : "Turn \u003cb\u003eright\u003c/b\u003e onto \u003cb\u003eW 56th St\u003c/b\u003e\u003cdiv style=\"font-size:0.9em\"\u003eDestination will be on the right\u003c/div\u003e",
+                     "maneuver" : "turn-right",
+                     "polyline" : {
+                        "points" : "ybywF`{pbMnBkG\\_A`BiFxAwEtC}I"
+                     },
+                     "start_location" : {
+                        "lat" : 40.7660501,
+                        "lng" : -73.9833663
+                     },
+                     "travel_mode" : "DRIVING"
+                  }
+               ],
+               "via_waypoint" : []
+            }
+         ],
+         "overview_polyline" : {
+            "points" : "{quwFndqbMfD|BtFnDnJnGdIhFd@ZxAbAr@d@sDhLyAvEeCaB|FsQDGLAl@H^Lr@d@sDhLyAvEeCaBwFqDmNgJwFuDgCgBuNcJyFqDwB_B}BwAoBoA{CsByFwDuFhQyDxLm@jB}ByAyFuDsNmJ{FsDyFwDlCkIzDaMtC}I"
+         },
+         "summary" : "Avenue of the Americas",
+         "warnings" : [],
+         "waypoint_order" : [ 0 ]
+      }
+   ],
+   "status" : "OK"
+}

data/spec/google_maps_api/directions/response_spec.rb

@@ -0,0 +1,14 @@
+require "spec_helper"
+require "google_maps_api/directions/json_response"
+
+describe GoogleMapsAPI::Directions::Response do
+  include_context "json response"
+
+  subject { GoogleMapsAPI::Directions::Response }
+
+  describe ".from_json" do
+    it "returns a new response" do
+      expect(subject.from_json(json)).to be_a(subject)
+    end
+  end
+end

data/spec/google_maps_api/directions/route_spec.rb

@@ -0,0 +1,14 @@
+require "spec_helper"
+require "google_maps_api/directions/json_response"
+
+describe GoogleMapsAPI::Directions::Route do
+  include_context "json response"
+
+  subject { GoogleMapsAPI::Directions::Route }
+
+  describe ".from_hash" do
+    it "returns a new route" do
+      expect(subject.from_hash(parsed_json["routes"].first)).to be_a(subject)
+    end
+  end
+end

data/spec/google_maps_api/directions/step_spec.rb

@@ -0,0 +1,15 @@
+require "spec_helper"
+require "google_maps_api/directions/json_response"
+
+describe GoogleMapsAPI::Directions::Step do
+  include_context "json response"
+
+  subject { GoogleMapsAPI::Directions::Step }
+
+  describe ".from_hash" do
+    it "returns a new step" do
+      hash = parsed_json["routes"].first["legs"].first["steps"].first
+      expect(subject.from_hash(hash)).to be_a(subject)
+    end
+  end
+end

data/spec/google_maps_api/directions_spec.rb

@@ -0,0 +1,20 @@
+require "spec_helper"
+require "google_maps_api/directions/request_lets"
+
+describe GoogleMapsAPI::Directions do
+  subject { GoogleMapsAPI::Directions }
+
+  include_context "request lets"
+
+  describe ".route" do
+    it "performs a request" do
+      expect_any_instance_of(subject::Request).to receive(:perform).with(no_args)
+      subject.route(origin, destination, options)
+    end
+
+    it "returns a response" do
+      expect(subject.route(origin, destination, options)).to be_a(subject::Response)
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,84 @@
+require "google_maps_api/directions"
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause this
+# file to always be loaded, without a need to explicitly require it in any files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# (such as loading up an entire rails app) will add to the boot time of your
+# test suite on EVERY test run, even for an individual file that may not need
+# all of that loaded.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # RSpec filters the backtrace by default so as not to be so noisy.
+    # This causes the full backtrace to be printed when running a single
+    # spec file (e.g. to troubleshoot a particular spec failure).
+    config.full_backtrace = true
+
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.formatter = 'doc' if config.formatters.none?
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # Enable only the newer, non-monkey-patching expect syntax.
+    # For more details, see:
+    #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+    expectations.syntax = :expect
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Enable only the newer, non-monkey-patching expect syntax.
+    # For more details, see:
+    #   - http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+    mocks.syntax = :expect
+
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended.
+    mocks.verify_partial_doubles = true
+  end
+=end
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: google_maps_api-directions
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Felipe Zavan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0.beta2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0.beta2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
+- !ruby/object:Gem::Dependency
+  name: google_maps_api-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- zavan@outlook.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- google_maps_api-directions.gemspec
+- lib/google_maps_api/directions.rb
+- lib/google_maps_api/directions/bounds.rb
+- lib/google_maps_api/directions/encoded_polyline.rb
+- lib/google_maps_api/directions/exceptions.rb
+- lib/google_maps_api/directions/leg.rb
+- lib/google_maps_api/directions/leg_and_step_common_builders.rb
+- lib/google_maps_api/directions/request.rb
+- lib/google_maps_api/directions/response.rb
+- lib/google_maps_api/directions/route.rb
+- lib/google_maps_api/directions/step.rb
+- lib/google_maps_api/directions/version.rb
+- spec/google_maps_api/directions/bounds_spec.rb
+- spec/google_maps_api/directions/json_response.rb
+- spec/google_maps_api/directions/leg_spec.rb
+- spec/google_maps_api/directions/request_lets.rb
+- spec/google_maps_api/directions/request_spec.rb
+- spec/google_maps_api/directions/response_mock.json
+- spec/google_maps_api/directions/response_spec.rb
+- spec/google_maps_api/directions/route_spec.rb
+- spec/google_maps_api/directions/step_spec.rb
+- spec/google_maps_api/directions_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/zavan/google_maps_api-directions
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Wrapper around the Google Maps Directions API.
+test_files:
+- spec/google_maps_api/directions/bounds_spec.rb
+- spec/google_maps_api/directions/json_response.rb
+- spec/google_maps_api/directions/leg_spec.rb
+- spec/google_maps_api/directions/request_lets.rb
+- spec/google_maps_api/directions/request_spec.rb
+- spec/google_maps_api/directions/response_mock.json
+- spec/google_maps_api/directions/response_spec.rb
+- spec/google_maps_api/directions/route_spec.rb
+- spec/google_maps_api/directions/step_spec.rb
+- spec/google_maps_api/directions_spec.rb
+- spec/spec_helper.rb