maptp-service 0.0.1

data/History.txt

@@ -0,0 +1,4 @@
+=== 0.0.1 2010-05-03
+
+* 1 major enhancement:
+  * Initial release

data/Manifest.txt

@@ -0,0 +1,19 @@
+History.txt
+Manifest.txt
+PostInstall.txt
+README.rdoc
+Rakefile
+lib/maptp-service.rb
+lib/maptp-service/parser/route.rb
+lib/maptp-service/routing.rb
+nbproject/private/private.properties
+nbproject/private/rake-d.txt
+nbproject/project.properties
+nbproject/project.xml
+script/console
+script/destroy
+script/generate
+spec/maptp-service_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+tasks/rspec.rake

data/PostInstall.txt

@@ -0,0 +1,7 @@
+
+For more information on maptp-service, see http://maptp-service.rubyforge.org
+
+NOTE: Change this information in PostInstall.txt 
+You can also delete it if you don't want it.
+
+

data/README.rdoc

@@ -0,0 +1,77 @@
+= maptp-service
+
+== FINALLY, A RUBY CLIENT FOR MAP TP!
+
+Rpository: http://github.com/ffwdme/maptp-service
+
+== DESCRIPTION:
+
+This gem provides access to the MapTP web services.
+
+In order to use them, you need your MapTP credentials aka your Map24 id.
+
+For more information head over to http://www.nn4d.com
+
+*Note*: This is *not* an official client of MapTP or NAVTEQ, but a private project. :)
+
+== FEATURES/PROBLEMS:
+
+* At this point, only a very simple routing request is implemented.
+* more to come... 
+ 
+== SYNOPSIS:
+
+First of all you need to provide your MapTP credentials.
+For example if your Map24 id is "123ABC" and bound to the server maptp12.map24.com you'll enter
+
+    MapTP.set_credentials '123ABC', 'maptp12'
+
+Given, you have two coordinates to create a route for:
+
+    start_coordinate = { :lat => 49.945589, :lng => 8.845563 }
+    destination_coordinate = { :lat => 49.936982, :lng => 8.911113 }
+
+Just create a new routing object:
+
+    routing = MapTP::Routing.new
+
+And try to find the matching route:
+
+    route = routing.find_route_by_coordinates start_coordinate, destination_coordinate
+
+== REQUIREMENTS:
+
+* The savon SOAP client (http://github.com/rubiii/savon)
+
+== INSTALL:
+
+    sudo gem install maptp-service
+
+== TESTING:
+
+In order to run the tests properly, make sure you provided your MapTP credentials as shown above.
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2010 Christian Bäuerlein
+
+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/Rakefile

@@ -0,0 +1,28 @@
+require 'rubygems'
+gem 'hoe', '>= 2.1.0'
+require 'hoe'
+require 'fileutils'
+require './lib/maptp-service'
+
+Hoe.plugin :newgem
+# Hoe.plugin :website
+# Hoe.plugin :cucumberfeatures
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.spec 'maptp-service' do
+  self.developer 'Christian Bäuerlein', 'christian@ffwdme.com'
+  self.post_install_message = 'PostInstall.txt' # TODO remove if post-install message not required
+  self.rubyforge_name       = self.name # TODO this is default value
+  self.extra_deps         = [['savon','>= 0.7.6']]
+
+end
+
+require 'newgem/tasks'
+# In Netbeans the next lines causes every rspec test to run twice.
+# If you're not using Netbeans and having problem with testing - try to disable it.
+#Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+# remove_task :default
+# task :default => [:spec, :features]

data/lib/maptp-service.rb

@@ -0,0 +1,45 @@
+require "rubygems"
+require "savon"
+#require "pp"
+
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require "maptp-service/routing"
+require "maptp-service/parser/route"
+
+# = A ruby client for MapTP services.
+#
+# This gem provides access to the MapTP web services.
+#
+# In order to use them, you need your MapTP credentials
+# aka your Map24 id.
+#
+# For more information head over to http://www.nn4d.com
+#
+# *Note*: This is *not* an official client of MapTP or NAVTEQ, but a private project.
+#
+#
+
+module MapTP
+  
+  VERSION = '0.0.1'
+
+
+  def self.set_credentials( map24id, maptp_server )
+    @map24_id = map24id
+    @maptp_server = maptp_server
+  end
+
+  protected
+
+  def self.map24_id
+    @map24_id
+  end
+
+  def self.maptp_server
+    @maptp_server
+  end
+
+
+end

data/lib/maptp-service/parser/route.rb

@@ -0,0 +1,85 @@
+module MapTP
+
+  # = Namespace for parsers handling the result.
+  module Parser
+
+    # Parses the results of a calculate route response.
+    module Route
+
+      # Parses the response to a hash
+      # and strips all unneccessary data
+      def self.to_hash(response)
+
+        resp = response.to_hash
+
+        route = resp[:calculate_route_response][:calculate_route_response][:route]
+
+        output = Hash.new
+
+        summary = Hash.new
+        summary[:duration] = route[:total_time].to_i
+        summary[:distance] = route[:total_length].to_i
+        
+        output[:summary] = summary
+
+        
+        directions = Array.new
+
+        route[:segments][:item].each do |direction|
+          
+          direction.delete(:type)
+          direction.delete(:descriptions)
+          direction[:start].delete(:type)
+          direction[:start][:lng] = direction[:start][:longitude].to_f / 60
+          direction[:start].delete(:longitude)
+          direction[:start][:lat] = direction[:start][:latitude].to_f / 60
+          direction[:start].delete(:latitude)
+
+          direction[:heading] = direction[:direction][:value].to_i
+          direction.delete(:direction)
+
+          if direction[:coordinates]
+
+            direction[:path] = {}
+            direction[:path][:lng] = direction[:coordinates][:longitudes].split("|").map { |item| item.to_f / 60 }
+            direction[:path][:lat] = direction[:coordinates][:latitudes].split("|").map { |item| item.to_f / 60 }
+
+            direction.delete(:coordinates)
+
+          end
+
+          if direction[:roundabout_exit_number]
+            direction[:roundabout_exit_number] = direction[:roundabout_exit_number].to_i
+          end
+
+          if direction[:exit_number]
+            direction[:exit_number] = direction[:exit_number].to_i
+          end
+          
+          # really?!
+          direction.delete(:via)
+
+          direction[:duration] = direction[:time].to_i
+          direction.delete(:time)
+
+          direction[:distance] = direction[:segment_length].to_i
+          direction.delete(:segment_length)
+          
+
+          directions << direction
+
+        end
+
+        output[:directions] = directions
+        
+        output
+
+      end
+
+
+    end
+
+
+  end
+
+end

data/lib/maptp-service/routing.rb

@@ -0,0 +1,95 @@
+module MapTP
+
+  # Provides a Ruby client to the SOAP interface of the
+  # MapTP routing services.
+  #
+  # Should be initialized for every new routing request.
+  class Routing
+
+    def initialize
+
+      # Disable log output
+      Savon::Request.log = false
+
+      @client = Savon::Client.new "http://#{MapTP::maptp_server}.map24.com/map24/webservices1.5?soap=Map24Routing"
+    
+    end
+
+    # Requests a route description for the given coordinates
+    #
+    # Parameters:
+    #
+    # [+start+] A hash containing, longitude and latitude, e.g. { :lng => 123, :lat => 465}
+    #
+    # [+destination+] A hash containing, longitude and latitude, e.g. { :lng => 123, :lat => 465}
+    #
+    # Returns either a hash containing the informations or a hash with a key +:ERROR+ containing
+    # the error message.
+    def find_route_by_coordinates(start, destination)
+
+      begin
+
+        response = @client.calculate_route! do |soap|
+
+          soap.namespaces["xmlns:SOAP-ENV"] = "http://schemas.xmlsoap.org/soap/envelope/"
+          soap.namespaces["xmlns:xsd"] = "http://www.w3.org/2001/XMLSchema"
+          soap.namespaces["xmlns:xsi"] = "http://www.w3.org/2001/XMLSchema-instance"
+          soap.namespaces["xmlns:wsdl"] = "Map24Routing"
+          soap.action = 'calculateRoute'
+          soap.input = 'calculateRoute'
+
+          soap.body = {
+
+            "RequestHeader" => {
+              "Map24ID" => MapTP::map24_id
+				
+            },
+            "CalculateRouteRequest" => {
+              "Start" => {
+                "Coordinate" => {
+                  "Longitude" => start[:lng] * 60,
+                  "Latitude" => start[:lat] * 60
+                }
+						
+              },
+              "Destination" => {
+                "Coordinate" => {
+                  "Longitude" => destination[:lng] * 60,
+                  "Latitude" => destination[:lat] * 60
+                }
+              }
+              #,"IgnoreDescription" => true
+			
+            }
+	
+		
+          }
+	
+        end
+
+        MapTP::Parser::Route.to_hash(response)
+
+      rescue Savon::SOAPFault => e
+
+        { :ERROR => e.message }
+
+
+      rescue Savon::HTTPError => e
+
+        { :ERROR => "HTTP Error" }
+
+      rescue SocketError
+
+        { :ERROR => "No HTTP Connection" }
+
+      rescue
+
+        { :ERROR => "Unknown Error" }
+
+      end
+      
+    end
+
+  end
+  
+end

data/nbproject/private/private.properties

@@ -0,0 +1,2 @@
+file.reference.maptp-service-lib=/Users/fabrik42/Dev/Ruby/maptp-service/lib
+file.reference.maptp-service-spec=/Users/fabrik42/Dev/Ruby/maptp-service/spec

data/nbproject/private/rake-d.txt

@@ -0,0 +1,48 @@
+announce=Announce your release.
+audit=Run ZenTest against the package.
+check_extra_deps=Install missing dependencies.
+check_manifest=Verify the manifest.
+check_version=
+clean=Clean up all the extras.
+clobber=
+clobber_docs=Remove rdoc products
+clobber_package=Remove package products
+clobber_rcov=
+config_hoe=Create a fresh ~/.hoerc file.
+debug_email=Generate email announcement file.
+debug_gem=Show information about the gem.
+default=Run the default task(s).
+deps\:email=Print a contact list for gems dependent on this gem
+deps\:fetch=Fetch all the dependent gems of this gem into tarballs
+deps\:list=List all the dependent gems of this gem
+doc=
+doc/index.html=
+docs=Build the RDOC HTML Files
+gem=Build the gem file maptp-service-0.0.1.gem
+gemspec=Generate a maptp-service.gemspec file
+generate_key=Generate a key for signing your gems.
+install_gem=Install the package as a gem.
+install_gem_no_doc=Install the package as a gem, without generating documentation(ri/rdoc)
+manifest=Recreate Manifest.txt to include ALL files to be deployed
+newb=Install deps, generate docs, run tests/specs.
+package=Build all the packages
+pkg=
+pkg/maptp-service-0.0.1=
+pkg/maptp-service-0.0.1.gem=
+pkg/maptp-service-0.0.1.tgz=
+post_blog=Post announcement to blog.
+post_news=Post announcement to rubyforge.
+postrelease=
+prerelease=
+publish_docs=Publish RDoc to wherever you want.
+publish_on_announce=
+redocs=Force a rebuild of the RDOC files
+release=Package and upload the release.
+release_sanity=Sanity checks for release
+release_to=
+release_to_gemcutter=Push gem to gemcutter.
+release_to_rubyforge=Release to rubyforge.
+repackage=Force a rebuild of the package files
+ridocs=Generate ri locally for testing.
+ruby_env=
+spec=Run all specifications

data/nbproject/project.properties

@@ -0,0 +1,7 @@
+file.reference.maptp-service-lib=lib
+file.reference.maptp-service-spec=spec
+main.file=
+platform.active=Ruby
+source.encoding=UTF-8
+src.dir=${file.reference.maptp-service-lib}
+test.src.dir=${file.reference.maptp-service-spec}

data/nbproject/project.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://www.netbeans.org/ns/project/1">
+    <type>org.netbeans.modules.ruby.rubyproject</type>
+    <configuration>
+        <data xmlns="http://www.netbeans.org/ns/ruby-project/1">
+            <name>maptp-service</name>
+            <source-roots>
+                <root id="src.dir"/>
+            </source-roots>
+            <test-roots>
+                <root id="test.src.dir"/>
+            </test-roots>
+        </data>
+    </configuration>
+</project>

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/maptp-service.rb'}"
+puts "Loading maptp-service gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/spec/maptp-service_spec.rb

@@ -0,0 +1,42 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+
+
+describe "MapTP" do
+
+
+before(:each) do
+
+
+    @start_coordinate = { :lat => 49.945589, :lng => 8.845563 }
+    @destination_coordinate = { :lat => 49.936982, :lng => 8.911113 }
+
+    @wrong_start_coordinate = { :lat => 1234657890, :lng => 1234657890 }
+    @wrong_destination_coordinate = { :lat => 987654321, :lng => 987654321 }
+
+    @routing = MapTP::Routing.new
+
+  end
+
+  it "should calculate a route and return it as a hash" do
+
+    @route = @routing.find_route_by_coordinates @start_coordinate, @destination_coordinate
+
+    @route.should be_kind_of(Hash)
+
+    #puts @route
+
+  end
+
+  it "should wrong route" do
+
+    @wrong_route = @routing.find_route_by_coordinates @wrong_start_coordinate, @wrong_destination_coordinate
+
+    @wrong_route.should be_kind_of(Hash)
+
+    @wrong_route[:ERROR].should be_instance_of(String)
+
+  end
+
+  
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--colour

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems' unless ENV['NO_RUBYGEMS']
+  gem 'rspec'
+  require 'spec'
+end
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+require 'maptp-service'
+
+# In order to perform the rspec tests properly
+# you have to provide your MapTP credentials.
+#
+# e.g. if your Map24 id is "123ABC" and bound
+# to the server maptp12.map24.com you'll enter
+#
+# MapTP.set_credentials '123ABC', 'maptp12'
+

data/tasks/rspec.rake

@@ -0,0 +1,21 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems' unless ENV['NO_RUBYGEMS']
+  require 'spec'
+end
+begin
+  require 'spec/rake/spectask'
+rescue LoadError
+  puts <<-EOS
+To use rspec for testing you must install rspec gem:
+    gem install rspec
+EOS
+  exit(0)
+end
+
+desc "Run the specs under spec/models"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ['--options', "spec/spec.opts"]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification 
+name: maptp-service
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- "Christian B\xC3\xA4uerlein"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-03 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: savon
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 7
+        - 6
+        version: 0.7.6
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rubyforge
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 4
+        version: 2.0.4
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 6
+        - 0
+        version: 2.6.0
+  type: :development
+  version_requirements: *id003
+description: |-
+  This gem provides access to the MapTP web services.
+  
+  In order to use them, you need your MapTP credentials aka your Map24 id.
+  
+  For more information head over to http://www.nn4d.com
+  
+  *Note*: This is *not* an official client of MapTP or NAVTEQ, but a private project. :)
+email: 
+- christian@ffwdme.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- nbproject/private/rake-d.txt
+files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- README.rdoc
+- Rakefile
+- lib/maptp-service.rb
+- lib/maptp-service/parser/route.rb
+- lib/maptp-service/routing.rb
+- nbproject/private/private.properties
+- nbproject/private/rake-d.txt
+- nbproject/project.properties
+- nbproject/project.xml
+- script/console
+- script/destroy
+- script/generate
+- spec/maptp-service_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/rspec.rake
+has_rdoc: true
+homepage: 
+licenses: []
+
+post_install_message: PostInstall.txt
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: maptp-service
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: This gem provides access to the MapTP web services
+test_files: []
+