go_maps 0.2.0 → 0.3.0

data/README.markdown

@@ -1,13 +1,34 @@
 ## ABOUT
 
-Ruby API to geographic operations. Currently it supports the validation of an address and the distance between two of them.
+Ruby API to geographic operations. Currently it supports:
+
+* Validation of an address
+* Distance between two addresses
+* Map with route between two addresses
+* Directions in HTML format between two addresses
+* Load address data from a CEP (only for Brazil)
 
 ## USAGE
 
-    address = Address.new "Rua Tenerife, 31, Sao Paulo, Brasil"
+    address = GoMaps::Address.new "Rua Tenerife, 31, Sao Paulo, Brasil"
     address.exists?
+    => true
     address.distance_to "Av Paulista, Sao Paulo, Brasil"
-    GoMaps::Direction.new(:from => "Av Paulista 100, Sao Paulo, Brasil", :to => "Avenida Brigadeiro Faria Lima 1000, Sao Paulo, Brasil").to_map
+    => 6.3
+
+    direction = GoMaps::Direction.new(:from => "Av Paulista 100, Sao Paulo, Brasil",
+                                      :to => "Avenida Brigadeiro Faria Lima 1000, Sao Paulo, Brasil")
+    direction.to_map
+    direction.to_map(:width => 400, :height => 700)
+    direction.to_html
+    direction.to_html(:language => 'pt-BR')
+
+    cep = GoMaps::CEP.new('01310-000')
+    cep.street
+    => "Avenida Paulista"
+    cep.city
+    => "São Paulo"
+
 
 ## LICENSE
 

data/Rakefile

@@ -7,7 +7,7 @@ begin
   require 'jeweler'
   Jeweler::Tasks.new do |gem|
     gem.name = "go_maps"
-    gem.version = "0.2.0"
+    gem.version = "0.3.0"
     gem.summary = %Q{Ruby API to geographic operations}
     gem.description = %Q{Ruby API to geographic operations}
     gem.homepage = "http://github.com/gonow/go_maps"
@@ -15,6 +15,7 @@ begin
     gem.add_development_dependency "rspec", ">= 1.2.9"
     gem.add_development_dependency "fakeweb", ">= 1.2.8"
     gem.add_dependency("crack", ">= 0.1.6")
+    gem.add_dependency("nokogiri", ">= 1.4.1")
     # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
   end
   Jeweler::GemcutterTasks.new

data/go_maps.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{go_maps}
-  s.version = "0.2.0"
+  s.version = "0.3.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Gonow"]
-  s.date = %q{2010-07-13}
+  s.date = %q{2010-07-16}
   s.description = %q{Ruby API to geographic operations}
   s.extra_rdoc_files = [
     "README.markdown"
@@ -22,12 +22,19 @@ Gem::Specification.new do |s|
      "lib/go_maps.rb",
      "lib/go_maps/address.rb",
      "lib/go_maps/address_not_found_exception.rb",
+     "lib/go_maps/cep.rb",
      "lib/go_maps/direction.rb",
      "spec/data/address_error",
      "spec/data/address_success",
+     "spec/data/cep_error",
+     "spec/data/cep_success",
+     "spec/data/direction_error",
+     "spec/data/direction_success",
+     "spec/data/direction_success_pt-BR",
      "spec/data/distance_error",
      "spec/data/distance_success_10.8",
      "spec/go_maps/address_spec.rb",
+     "spec/go_maps/cep_spec.rb",
      "spec/go_maps/direction_spec.rb",
      "spec/spec.opts",
      "spec/spec_helper.rb"
@@ -39,6 +46,7 @@ Gem::Specification.new do |s|
   s.summary = %q{Ruby API to geographic operations}
   s.test_files = [
     "spec/go_maps/address_spec.rb",
+     "spec/go_maps/cep_spec.rb",
      "spec/go_maps/direction_spec.rb",
      "spec/spec_helper.rb"
   ]
@@ -51,15 +59,18 @@ Gem::Specification.new do |s|
       s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
       s.add_development_dependency(%q<fakeweb>, [">= 1.2.8"])
       s.add_runtime_dependency(%q<crack>, [">= 0.1.6"])
+      s.add_runtime_dependency(%q<nokogiri>, [">= 1.4.1"])
     else
       s.add_dependency(%q<rspec>, [">= 1.2.9"])
       s.add_dependency(%q<fakeweb>, [">= 1.2.8"])
       s.add_dependency(%q<crack>, [">= 0.1.6"])
+      s.add_dependency(%q<nokogiri>, [">= 1.4.1"])
     end
   else
     s.add_dependency(%q<rspec>, [">= 1.2.9"])
     s.add_dependency(%q<fakeweb>, [">= 1.2.8"])
     s.add_dependency(%q<crack>, [">= 0.1.6"])
+    s.add_dependency(%q<nokogiri>, [">= 1.4.1"])
   end
 end
 

data/lib/go_maps/address.rb

@@ -9,13 +9,18 @@ module GoMaps
     end
 
     def distance_to(address)
-      directions_to(address)['routes'].first['legs'].first['distance']['text'].to_f rescue raise AddressNotFoundException
+      route_to(address)['distance']['text'].to_f
+    end
+
+    def route_to(address, options = {})
+      options[:language] ||= 'en'
+      directions_to(address, "&language=#{options[:language]}")['routes'].first['legs'].first rescue raise AddressNotFoundException
     end
 
     private
 
-    def directions_to(address)
-      api_response :directions, "origin=#{@address}&destination=#{address}"
+    def directions_to(address, language)
+      api_response :directions, "origin=#{@address}&destination=#{address}#{language}"
     end
 
     def location

data/lib/go_maps/cep.rb

@@ -0,0 +1,22 @@
+module GoMaps
+  class CEP
+    def initialize(cep)
+      @response = Nokogiri::XML(open("http://www.buscarcep.com.br?formato=xml&cep=#{cep}"))
+      raise GoMaps::AddressNotFoundException if element('resultado') != '1'
+    end
+
+    def street
+      "#{element('tipo_logradouro')} #{element('logradouro')}"
+    end
+
+    def city
+      element('cidade')
+    end
+
+    private
+
+    def element(name)
+      @response.css(name).inner_text
+    end
+  end
+end

data/lib/go_maps/direction.rb

@@ -6,9 +6,13 @@ module GoMaps
     end
 
     def to_map(options = {})
-      width = options[:width] || 425
-      height = options[:height] || 350
-      "<iframe width='#{width}' height='#{height}' frameborder='0' scrolling='no' marginheight='0' marginwidth='0' src='#{map_url(@from, @to)}'></iframe>"
+      options[:width] ||= 425
+      options[:height] ||= 350
+      "<iframe width='#{options[:width]}' height='#{options[:height]}' frameborder='0' scrolling='no' marginheight='0' marginwidth='0' src='#{map_url(@from, @to)}'></iframe>"
+    end
+
+    def to_html(options = {})
+      Address.new(@from).route_to(@to, :language => options[:language])['steps'].inject(''){|directions, step| directions << step['html_instructions']}
     end
 
     private

data/lib/go_maps.rb

@@ -1,5 +1,6 @@
 require 'crack'
 require 'open-uri'
+require 'nokogiri'
 
 Dir.glob(File.dirname(__FILE__) + '/go_maps/*.rb').each { |file| require file }
 

data/spec/data/cep_error

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="iso-8859-1" ?><webservicecep><quantidade>1</quantidade><retorno><resultado>-1</resultado><local_busca>loc</local_busca><resultado_txt>cep nao encontrado</resultado_txt><cep>12345678</cep><codigo_ibge>codigo ibge nao encontrado</codigo_ibge></retorno></webservicecep>

data/spec/data/cep_success

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="iso-8859-1" ?><webservicecep><quantidade>1</quantidade><retorno><cep>01310000</cep><uf>SP</uf><cidade>S�o Paulo</cidade><bairro>Bela Vista</bairro><tipo_logradouro>Avenida</tipo_logradouro><logradouro>Paulista</logradouro><complemento>- at� 0610 - lado par</complemento><data>2010-06-02 08:05:23</data><resultado>1</resultado><resultado_txt>sucesso. cep encontrado local</resultado_txt><limite_buscas>5</limite_buscas><ibge_uf>35</ibge_uf><ibge_municipio>355030</ibge_municipio><ibge_municipio_verificador>3550308</ibge_municipio_verificador></retorno></webservicecep>

data/spec/data/direction_error

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

data/spec/data/direction_success

@@ -0,0 +1,356 @@
+{
+  "status": "OK",
+    "routes": [ {
+      "summary": "R. da Consolação",
+      "legs": [ {
+        "steps": [ {
+          "travel_mode": "DRIVING",
+          "start_location": {
+            "lat": -23.5489400,
+            "lng": -46.6388200
+          },
+          "end_location": {
+            "lat": -23.5471000,
+            "lng": -46.6378600
+          },
+          "polyline": {
+            "points": "zkvnCrct{Ga@BcAMqCyAwB{A",
+            "levels": "B???B"
+          },
+          "duration": {
+            "value": 21,
+            "text": "1 min"
+          },
+          "html_instructions": "Head \u003cb\u003enorth\u003c/b\u003e on \u003cb\u003eAv. Vinte e Três de Maio\u003c/b\u003e",
+          "distance": {
+            "value": 233,
+            "text": "0.2 km"
+          }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5471000,
+              "lng": -46.6378600
+            },
+            "end_location": {
+              "lat": -23.5435300,
+              "lng": -46.6354900
+            },
+            "polyline": {
+              "points": "j`vnCr}s{G_A{@_LaIiF{A",
+              "levels": "B??B"
+            },
+            "duration": {
+              "value": 42,
+              "text": "1 min"
+            },
+            "html_instructions": "Continue onto \u003cb\u003eAv. Nove de Julho\u003c/b\u003e",
+            "distance": {
+              "value": 469,
+              "text": "0.5 km"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5435300,
+              "lng": -46.6354900
+            },
+            "end_location": {
+              "lat": -23.5413800,
+              "lng": -46.6341800
+            },
+            "polyline": {
+              "points": "`junCxns{GoBmA}HwD",
+              "levels": "B?B"
+            },
+            "duration": {
+              "value": 25,
+              "text": "1 min"
+            },
+            "html_instructions": "Continue onto \u003cb\u003eAv. Prestes Maia\u003c/b\u003e",
+            "distance": {
+              "value": 274,
+              "text": "0.3 km"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5413800,
+              "lng": -46.6341800
+            },
+            "end_location": {
+              "lat": -23.5396300,
+              "lng": -46.6337300
+            },
+            "polyline": {
+              "points": "r|tnCrfs{G}@q@_Hg@",
+              "levels": "B?B"
+            },
+            "duration": {
+              "value": 50,
+              "text": "1 min"
+            },
+            "html_instructions": "Slight \u003cb\u003eright\u003c/b\u003e at \u003cb\u003eR. Carlos de Sousa Nazaré\u003c/b\u003e",
+            "distance": {
+              "value": 204,
+              "text": "0.2 km"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5396300,
+              "lng": -46.6337300
+            },
+            "end_location": {
+              "lat": -23.5393200,
+              "lng": -46.6337000
+            },
+            "polyline": {
+              "points": "tqtnCxcs{G}@E",
+              "levels": "BB"
+            },
+            "duration": {
+              "value": 5,
+              "text": "1 min"
+            },
+            "html_instructions": "Take the ramp to \u003cb\u003eAv. Sen. Queirós\u003c/b\u003e",
+            "distance": {
+              "value": 35,
+              "text": "35 m"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5393200,
+              "lng": -46.6337000
+            },
+            "end_location": {
+              "lat": -23.5393100,
+              "lng": -46.6363100
+            },
+            "polyline": {
+              "points": "votnCrcs{GMnCcAzGJn@bAl@",
+              "levels": "B???B"
+            },
+            "duration": {
+              "value": 101,
+              "text": "2 mins"
+            },
+            "html_instructions": "Turn \u003cb\u003eleft\u003c/b\u003e at \u003cb\u003eAv. Sen. Queirós\u003c/b\u003e",
+            "distance": {
+              "value": 293,
+              "text": "0.3 km"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5393100,
+              "lng": -46.6363100
+            },
+            "end_location": {
+              "lat": -23.5395400,
+              "lng": -46.6363600
+            },
+            "polyline": {
+              "points": "totnC|ss{Gl@H",
+              "levels": "BB"
+            },
+            "duration": {
+              "value": 5,
+              "text": "1 min"
+            },
+            "html_instructions": "Slight \u003cb\u003eleft\u003c/b\u003e at \u003cb\u003eAv. Cásper Líbero\u003c/b\u003e",
+            "distance": {
+              "value": 26,
+              "text": "26 m"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5395400,
+              "lng": -46.6363600
+            },
+            "end_location": {
+              "lat": -23.5472000,
+              "lng": -46.6457900
+            },
+            "polyline": {
+              "points": "bqtnCfts{GpK`RhG|GFVlCdDvBnDrBhBhC|CdCvDlEnD",
+              "levels": "B????????B"
+            },
+            "duration": {
+              "value": 168,
+              "text": "3 mins"
+            },
+            "html_instructions": "Slight \u003cb\u003eright\u003c/b\u003e at \u003cb\u003eAv. Ipiranga\u003c/b\u003e",
+            "distance": {
+              "value": 1292,
+              "text": "1.3 km"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5472000,
+              "lng": -46.6457900
+            },
+            "end_location": {
+              "lat": -23.5562100,
+              "lng": -46.6641000
+            },
+            "polyline": {
+              "points": "~`vnCdou{GMjD^pDzHh]bGnM~KfWfItM~H~JvBvDV~@",
+              "levels": "B??@?????B"
+            },
+            "duration": {
+              "value": 227,
+              "text": "4 mins"
+            },
+            "html_instructions": "Turn \u003cb\u003eright\u003c/b\u003e at \u003cb\u003eR. da Consolação\u003c/b\u003e",
+            "distance": {
+              "value": 2157,
+              "text": "2.2 km"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5562100,
+              "lng": -46.6641000
+            },
+            "end_location": {
+              "lat": -23.5640900,
+              "lng": -46.6778000
+            },
+            "polyline": {
+              "points": "hywnCray{Gn@hErArF`IjMjJxS|F|KzBxDfCnD`CbEpBbE",
+              "levels": "B?@??????B"
+            },
+            "duration": {
+              "value": 150,
+              "text": "3 mins"
+            },
+            "html_instructions": "Continue onto \u003cb\u003eAv. Rebouças\u003c/b\u003e",
+            "distance": {
+              "value": 1660,
+              "text": "1.7 km"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5640900,
+              "lng": -46.6778000
+            },
+            "end_location": {
+              "lat": -23.5614200,
+              "lng": -46.6797600
+            },
+            "polyline": {
+              "points": "pjynCfw{{GuOfK",
+              "levels": "BB"
+            },
+            "duration": {
+              "value": 48,
+              "text": "1 min"
+            },
+            "html_instructions": "Turn \u003cb\u003eright\u003c/b\u003e at \u003cb\u003eR. Henrique Schaumann\u003c/b\u003e",
+            "distance": {
+              "value": 358,
+              "text": "0.4 km"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5614200,
+              "lng": -46.6797600
+            },
+            "end_location": {
+              "lat": -23.5625200,
+              "lng": -46.6816000
+            },
+            "polyline": {
+              "points": "zyxnCnc|{GzEnJ",
+              "levels": "BB"
+            },
+            "duration": {
+              "value": 64,
+              "text": "1 min"
+            },
+            "html_instructions": "Take the 1st \u003cb\u003eleft\u003c/b\u003e onto \u003cb\u003eR. Artur de Azevedo\u003c/b\u003e",
+            "distance": {
+              "value": 224,
+              "text": "0.2 km"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5625200,
+              "lng": -46.6816000
+            },
+            "end_location": {
+              "lat": -23.5644800,
+              "lng": -46.6801000
+            },
+            "polyline": {
+              "points": "v`ynC~n|{GfKkH",
+              "levels": "BB"
+            },
+            "duration": {
+              "value": 46,
+              "text": "1 min"
+            },
+            "html_instructions": "Turn \u003cb\u003eleft\u003c/b\u003e at \u003cb\u003eR. Con. Eugênio Leite\u003c/b\u003e",
+            "distance": {
+              "value": 266,
+              "text": "0.3 km"
+            }
+        }, {
+          "travel_mode": "DRIVING",
+            "start_location": {
+              "lat": -23.5644800,
+              "lng": -46.6801000
+            },
+            "end_location": {
+              "lat": -23.5642400,
+              "lng": -46.6792200
+            },
+            "polyline": {
+              "points": "~lynCre|{Go@gC?g@",
+              "levels": "B?B"
+            },
+            "duration": {
+              "value": 21,
+              "text": "1 min"
+            },
+            "html_instructions": "Take the 1st \u003cb\u003eleft\u003c/b\u003e onto \u003cb\u003eR. dos Pinheiros\u003c/b\u003e \u003cdiv style=\"font-size:0.9em\"\u003eDestination will be on the left\u003c/div\u003e",
+            "distance": {
+              "value": 95,
+              "text": "0.1 km"
+            }
+        } ],
+          "duration": {
+            "value": 973,
+            "text": "16 mins"
+          },
+          "distance": {
+            "value": 7586,
+            "text": "7.6 km"
+          },
+          "start_location": {
+            "lat": -23.5489400,
+            "lng": -46.6388200
+          },
+          "end_location": {
+            "lat": -23.5642400,
+            "lng": -46.6792200
+          },
+          "start_address": "São Paulo, Brazil",
+          "end_address": "R. dos Pinheiros, 100 - Pinheiros, São Paulo, 05422-000, Brazil"
+      } ],
+      "copyrights": "Map data ©2010 MapLink",
+      "overview_polyline": {
+        "points": "zkvnCrct{Ga@BcAMwAs@kBiAeCsB_LaIiF{AoBmA}HwD}@q@}Im@MnCcAzGJn@bAl@l@HPP~JnQhG|GFVlCdDvBnDrBhBhC|CdCvDlEnDMjD^pDzHh]bGnM~KfWfItM~H~JvBvDf@jB^|CrArF`IjMjJxS|F|KzBxDfCnD`CbEpBbEuOfKzEnJfKkHo@gC?g@",
+        "levels": "B?????????@A??@???????????@??@??????????????@@@@?B"
+      },
+      "warnings": [ ],
+      "waypoint_order": [ ]
+    } ]
+}

data/spec/data/direction_success_pt-BR

@@ -0,0 +1,241 @@
+{
+  "status": "OK",
+  "routes": [ {
+    "summary": "Av. Brg. Faria Lima",
+    "legs": [ {
+      "steps": [ {
+        "travel_mode": "DRIVING",
+        "start_location": {
+          "lat": -23.5642400,
+          "lng": -46.6792200
+        },
+        "end_location": {
+          "lat": -23.5644200,
+          "lng": -46.6784300
+        },
+        "polyline": {
+          "points": "nkynCb`|{G@qA`@kA",
+          "levels": "B?B"
+        },
+        "duration": {
+          "value": 13,
+          "text": "1 min"
+        },
+        "html_instructions": "Siga na direção \u003cb\u003eleste\u003c/b\u003e na \u003cb\u003eR. dos Pinheiros\u003c/b\u003e em direção à \u003cb\u003eR. Francisco Leitão\u003c/b\u003e \u003cspan style=\"white-space: nowrap\"\u003e- siga \u003cb\u003e85 m\u003c/b\u003e\u003c/span\u003e",
+        "distance": {
+          "value": 85,
+          "text": "85 m"
+        }
+      }, {
+        "travel_mode": "DRIVING",
+        "start_location": {
+          "lat": -23.5644200,
+          "lng": -46.6784300
+        },
+        "end_location": {
+          "lat": -23.5693200,
+          "lng": -46.6876400
+        },
+        "polyline": {
+          "points": "rlynCd{{{Gr]px@",
+          "levels": "BB"
+        },
+        "duration": {
+          "value": 142,
+          "text": "2 minutos"
+        },
+        "html_instructions": "Vire à \u003cb\u003edireita\u003c/b\u003e na \u003cb\u003eAv. Rebouças\u003c/b\u003e \u003cspan style=\"white-space: nowrap\"\u003e- siga \u003cb\u003e1,1 km\u003c/b\u003e\u003c/span\u003e",
+        "distance": {
+          "value": 1085,
+          "text": "1,1 km"
+        }
+      }, {
+        "travel_mode": "DRIVING",
+        "start_location": {
+          "lat": -23.5693200,
+          "lng": -46.6876400
+        },
+        "end_location": {
+          "lat": -23.5706800,
+          "lng": -46.6904100
+        },
+        "polyline": {
+          "points": "fkznCvt}{GnGhP",
+          "levels": "BB"
+        },
+        "duration": {
+          "value": 71,
+          "text": "1 min"
+        },
+        "html_instructions": "Curva suave à \u003cb\u003edireita\u003c/b\u003e para permanecer na \u003cb\u003eAv. Rebouças\u003c/b\u003e \u003cspan style=\"white-space: nowrap\"\u003e- siga \u003cb\u003e300 m\u003c/b\u003e\u003c/span\u003e",
+        "distance": {
+          "value": 321,
+          "text": "0,3 km"
+        }
+      }, {
+        "travel_mode": "DRIVING",
+        "start_location": {
+          "lat": -23.5706800,
+          "lng": -46.6904100
+        },
+        "end_location": {
+          "lat": -23.5693900,
+          "lng": -46.6916500
+        },
+        "polyline": {
+          "points": "vsznC`f~{GBr@Mh@kBjAkClA",
+          "levels": "B???B"
+        },
+        "duration": {
+          "value": 18,
+          "text": "1 min"
+        },
+        "html_instructions": "Pegue a rampa de acesso para a \u003cb\u003eAv. Brg. Faria Lima\u003c/b\u003e \u003cspan style=\"white-space: nowrap\"\u003e- siga \u003cb\u003e210 m\u003c/b\u003e\u003c/span\u003e",
+        "distance": {
+          "value": 208,
+          "text": "0,2 km"
+        }
+      }, {
+        "travel_mode": "DRIVING",
+        "start_location": {
+          "lat": -23.5693900,
+          "lng": -46.6916500
+        },
+        "end_location": {
+          "lat": -23.5945400,
+          "lng": -46.6803600
+        },
+        "polyline": {
+          "points": "tkznCxm~{GAr@|p@q^nLaG`DoAvBk@xTmIpF}@zJcCdIsAxR_EvLqB",
+          "levels": "B?????@????B"
+        },
+        "duration": {
+          "value": 373,
+          "text": "6 minutos"
+        },
+        "html_instructions": "Faça um \u003cb\u003eretorno\u003c/b\u003e \u003cspan style=\"white-space: nowrap\"\u003e- siga \u003cb\u003e3,1 km\u003c/b\u003e\u003c/span\u003e",
+        "distance": {
+          "value": 3084,
+          "text": "3,1 km"
+        }
+      }, {
+        "travel_mode": "DRIVING",
+        "start_location": {
+          "lat": -23.5945400,
+          "lng": -46.6803600
+        },
+        "end_location": {
+          "lat": -23.5950500,
+          "lng": -46.6821700
+        },
+        "polyline": {
+          "points": "zh_oCfg|{GdBhJ",
+          "levels": "BB"
+        },
+        "duration": {
+          "value": 31,
+          "text": "1 min"
+        },
+        "html_instructions": "Vire à \u003cb\u003edireita\u003c/b\u003e na \u003cb\u003eR. Elvira Ferraz\u003c/b\u003e \u003cspan style=\"white-space: nowrap\"\u003e- siga \u003cb\u003e190 m\u003c/b\u003e\u003c/span\u003e",
+        "distance": {
+          "value": 192,
+          "text": "0,2 km"
+        }
+      }, {
+        "travel_mode": "DRIVING",
+        "start_location": {
+          "lat": -23.5950500,
+          "lng": -46.6821700
+        },
+        "end_location": {
+          "lat": -23.5961200,
+          "lng": -46.6873500
+        },
+        "polyline": {
+          "points": "`l_oCpr|{GXlCYfBvBfN|AlH",
+          "levels": "B???B"
+        },
+        "duration": {
+          "value": 85,
+          "text": "1 min"
+        },
+        "html_instructions": "Continue para \u003cb\u003eR. Olimpíadas\u003c/b\u003e \u003cspan style=\"white-space: nowrap\"\u003e- siga \u003cb\u003e550 m\u003c/b\u003e\u003c/span\u003e",
+        "distance": {
+          "value": 549,
+          "text": "0,5 km"
+        }
+      }, {
+        "travel_mode": "DRIVING",
+        "start_location": {
+          "lat": -23.5961200,
+          "lng": -46.6873500
+        },
+        "end_location": {
+          "lat": -23.5959300,
+          "lng": -46.6877500
+        },
+        "polyline": {
+          "points": "vr_oC|r}{Ge@nA",
+          "levels": "BB"
+        },
+        "duration": {
+          "value": 13,
+          "text": "1 min"
+        },
+        "html_instructions": "Curva suave à \u003cb\u003edireita\u003c/b\u003e na \u003cb\u003eR. Gomes de Carvalho\u003c/b\u003e \u003cspan style=\"white-space: nowrap\"\u003e- siga \u003cb\u003e46 m\u003c/b\u003e\u003c/span\u003e",
+        "distance": {
+          "value": 46,
+          "text": "46 m"
+        }
+      }, {
+        "travel_mode": "DRIVING",
+        "start_location": {
+          "lat": -23.5959300,
+          "lng": -46.6877500
+        },
+        "end_location": {
+          "lat": -23.5962400,
+          "lng": -46.6879000
+        },
+        "polyline": {
+          "points": "pq_oClu}{G|@\\",
+          "levels": "BB"
+        },
+        "duration": {
+          "value": 13,
+          "text": "1 min"
+        },
+        "html_instructions": "Vire à \u003cb\u003eesquerda\u003c/b\u003e na \u003cb\u003eR. Tenerife\u003c/b\u003e \u003cspan style=\"white-space: nowrap\"\u003e- siga \u003cb\u003e38 m\u003c/b\u003e\u003c/span\u003e\u003cdiv style=\"font-size:0.9em\"\u003eO destino estará à esquerda\u003c/div\u003e",
+        "distance": {
+          "value": 38,
+          "text": "38 m"
+        }
+      } ],
+      "duration": {
+        "value": 759,
+        "text": "13 minutos"
+      },
+      "distance": {
+        "value": 5608,
+        "text": "5,6 km"
+      },
+      "start_location": {
+        "lat": -23.5642400,
+        "lng": -46.6792200
+      },
+      "end_location": {
+        "lat": -23.5962400,
+        "lng": -46.6879000
+      },
+      "start_address": "R. dos Pinheiros, 100 - Pinheiros, São Paulo, 05422-000, Brasil",
+      "end_address": "R. Tenerife, 31 - Itaim Bibi, São Paulo, 04548-040, Brasil"
+    } ],
+    "copyrights": "Map data ©2010 MapLink",
+    "overview_polyline": {
+      "points": "nkynCb`|{G@qA`@kAr]px@nGhPBr@Mh@kBjAkClAAr@bJ}E~ByApl@i[~EuBpCw@xTmIpF}@zJcCdIsAxR_EvLqBdBhJTjBB`@YfBvBfN|AlHe@nA|@\\",
+      "levels": "B?@?@????A?????@????A???????B"
+    },
+    "warnings": [ ],
+    "waypoint_order": [ ]
+  } ]
+}

data/spec/go_maps/cep_spec.rb

@@ -0,0 +1,29 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe GoMaps::CEP do
+  context 'given valid cep' do
+    before :each do
+      map_url_to_file 'http://www.buscarcep.com.br/?formato=xml&cep=01310-000', 'cep_success'
+      @cep = GoMaps::CEP.new('01310-000')
+    end
+
+    context 'on #street' do
+      it 'should return the street' do
+        @cep.street.should eql('Avenida Paulista')
+      end
+    end
+
+    context 'on #city' do
+      it 'should return the city' do
+        @cep.city.should eql('São Paulo')
+      end
+    end
+  end
+
+  context 'given invalid cep' do
+    it 'should raise AddressNotFoundException' do
+      map_url_to_file 'http://www.buscarcep.com.br/?formato=xml&cep=12345-678', 'cep_error'
+      lambda { @cep = GoMaps::CEP.new('12345-678') }.should raise_error(GoMaps::AddressNotFoundException)
+    end
+  end
+end

data/spec/go_maps/direction_spec.rb

@@ -1,21 +1,39 @@
 require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
 
 describe GoMaps::Direction do
-  context 'on #to_map' do
-    before :each do
-      @address1, @address2 = 'Invalid Address 1', 'Invalid Address 2'
-    end
+  before :each do
+    @address1, @address2 = 'Valid Address 1', 'Valid Address 2'
+    @direction = GoMaps::Direction.new(:from => @address1, :to => @address2)
+  end
 
+  context 'on #to_map' do
     it 'should return a map' do
-      GoMaps::Direction.new(:from => @address1, :to => @address2).to_map.should eql("<iframe width='425' height='350' frameborder='0' scrolling='no' marginheight='0' marginwidth='0' src='http://maps.google.com/maps?ie=UTF8&output=embed&saddr=#{@address1}&daddr=#{@address2}'></iframe>")
+      @direction.to_map.should eql("<iframe width='425' height='350' frameborder='0' scrolling='no' marginheight='0' marginwidth='0' src='http://maps.google.com/maps?ie=UTF8&output=embed&saddr=#{@address1}&daddr=#{@address2}'></iframe>")
     end
 
     it 'should accept width as an option' do
-      GoMaps::Direction.new(:from => @address1, :to => @address2).to_map(:width => 333).include?('width=\'333\'').should be_true
+      @direction.to_map(:width => 333).include?('width=\'333\'').should be_true
     end
 
     it 'should accept height as an option' do
-      GoMaps::Direction.new(:from => @address1, :to => @address2).to_map(:height => 444).include?('height=\'444\'').should be_true
+      @direction.to_map(:height => 444).include?('height=\'444\'').should be_true
+    end
+  end
+
+  context 'on #to_html' do
+    it 'should return an html' do
+      map_addresses_to_file(@address1, @address2, 'direction_success')
+      @direction.to_html.include?('Head <b>north</b> on <b>Av. Vinte e Três de Maio</b>').should be_true
+    end
+
+    it 'should return an html with a language specified' do
+      map_addresses_to_file(@address1, @address2, 'direction_success_pt-BR', :language => 'pt-BR')
+      @direction.to_html(:language => 'pt-BR').include?('Siga na direção <b>leste</b> na <b>R. dos Pinheiros</b>').should be_true
+    end
+
+    it 'should raise an address not found expection' do
+      map_addresses_to_file(@address1, @address2, 'direction_error')
+      lambda { @direction.to_html }.should raise_error(GoMaps::AddressNotFoundException)
     end
   end
 end

data/spec/spec_helper.rb

@@ -10,8 +10,9 @@ Spec::Runner.configure do |config|
   FakeWeb.allow_net_connect = false
 end
 
-def map_addresses_to_file(address1, address2, file_name)
-  map_query_string_to_file "origin=#{address1}&destination=#{address2}", file_name
+def map_addresses_to_file(address1, address2, file_name, options = {})
+  options[:language] ||= "en"
+  map_query_string_to_file "origin=#{address1}&destination=#{address2}&language=#{options[:language]}", file_name
 end
 
 def map_address_to_file(address, file_name)

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 2
+  - 3
   - 0
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Gonow
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-07-13 00:00:00 -03:00
+date: 2010-07-16 00:00:00 -03:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -59,6 +59,20 @@ dependencies:
         version: 0.1.6
   type: :runtime
   version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 4
+        - 1
+        version: 1.4.1
+  type: :runtime
+  version_requirements: *id004
 description: Ruby API to geographic operations
 email: 
 executables: []
@@ -75,12 +89,19 @@ files:
 - lib/go_maps.rb
 - lib/go_maps/address.rb
 - lib/go_maps/address_not_found_exception.rb
+- lib/go_maps/cep.rb
 - lib/go_maps/direction.rb
 - spec/data/address_error
 - spec/data/address_success
+- spec/data/cep_error
+- spec/data/cep_success
+- spec/data/direction_error
+- spec/data/direction_success
+- spec/data/direction_success_pt-BR
 - spec/data/distance_error
 - spec/data/distance_success_10.8
 - spec/go_maps/address_spec.rb
+- spec/go_maps/cep_spec.rb
 - spec/go_maps/direction_spec.rb
 - spec/spec.opts
 - spec/spec_helper.rb
@@ -116,5 +137,6 @@ specification_version: 3
 summary: Ruby API to geographic operations
 test_files: 
 - spec/go_maps/address_spec.rb
+- spec/go_maps/cep_spec.rb
 - spec/go_maps/direction_spec.rb
 - spec/spec_helper.rb