ruby_ptv_api 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4527df64f46e3339016be3ad00bde23f29f3f145
+  data.tar.gz: 495bfd93b229601574aebaa2572c00fbab6b13e2
+SHA512:
+  metadata.gz: bcbfda7701b2a736e1eecc17571cc0cd3f3fdd7d842c13be3eae5a0ec42d476ee4dc68b7b8d2a86c50417619cb90b8ad4f0c39395b7846002e55812b2915bc76
+  data.tar.gz: b4fff08081ecdc68296335f805722f5334557974aebf4fe5b8cb542bcead247bf7eb3e0b4e413a9929c0029de10b70534b4aa1788407a7a3e6e7f8f6a776eb47

data/.directory

@@ -0,0 +1,11 @@
+[Dolphin]
+GroupedSorting=true
+PreviewsShown=true
+SortRole=type
+Timestamp=2016,6,21,12,21,25
+Version=3
+ViewMode=2
+VisibleRoles=Compact_text,Compact_size,Compact_date
+
+[Settings]
+HiddenFilesShown=true

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/.idea/
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+.ruby-version
+.ruby-gemset
+ruby_ptv_api-*.gem

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.2.2
+before_install: gem install bundler -v 1.11.2

data/Gemfile

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

data/Guardfile

@@ -0,0 +1,36 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+## Uncomment and set this to only include directories you want to watch
+# directories %w(app lib config test spec features) \
+#  .select{|d| Dir.exists?(d) ? d : UI.warning("Directory #{d} does not exist")}
+
+#directories %w(lib spec)
+
+## Note: if you are using the `directories` clause above and you are not
+## watching the project directory ('.'), then you will want to move
+## the Guardfile to a watched dir and symlink it back, e.g.
+#
+#  $ mkdir config
+#  $ mv Guardfile config/
+#  $ ln -s config/Guardfile .
+#
+# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
+
+guard :rspec, cmd: "bundle exec rspec" do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # Feel free to open issues for suggestions and improvements
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+
+end

data/README.md

@@ -0,0 +1,46 @@
+# RubyPtvApi
+
+Unofficial PTV API client
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ruby_ptv_api'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ruby_ptv_api
+
+## Setup
+
+Setup configuration parameters
+
+```ruby
+RubyPtvApi.configure do |c|
+  c.x_locate_endpoint = "http://<your PTV server>"
+  c.x_route_endpoint  = "http://<your PTV server>"
+  c.x_tour_endpoint   = "http://<your PTV server>"
+end
+```
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/satelicom/ruby-ptv-api/.
+

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -I lib -r ruby_ptv_api.rb -r ./console_initializer.rb "
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "ruby_ptv_api"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/console_initializer.rb

@@ -0,0 +1,5 @@
+RubyPtvApi.configure do |c|
+  c.x_locate_endpoint = "http://ptv.dev.satelicom.com:50020"
+  c.x_route_endpoint  = "http://ptv.dev.satelicom.com:50030"
+  c.x_tour_endpoint   = "http://ptv.dev.satelicom.com:50090"
+end

data/lib/ruby_ptv_api/base.rb

@@ -0,0 +1,105 @@
+module RubyPtvApi
+  class Base
+    attr_accessor :profile, :coord_format
+
+    def endpoint
+      RubyPtvApi.config.send("#{parent_module_name.downcase}_endpoint")
+    end
+
+    def uri
+      "#{endpoint}/#{ptv_path}/#{ptv_function}"
+    end
+
+    def ptv_path
+      raise "Not implemented PTV path in #{demodulized_name}"
+    end
+
+    def ptv_function
+      raise "Not implemented PTV function in #{demodulized_name}"
+    end
+
+    def parent_module_name
+      name = self.class.name.split('::')[-2]
+      return nil unless name
+      underscore(name)
+    end
+
+    def demodulized_name
+      demodulize(self.class.name)
+    end
+
+    # Avoid active support import
+    def demodulize(path)
+      path = path.to_s
+      if i = path.rindex('::')
+        path[(i+2)..-1]
+      else
+        path
+      end
+    end
+
+    def underscore(path)
+      path.gsub!(/([A-Z\d]+)([A-Z][a-z])/,'\1_\2').downcase
+    end
+
+    def post(params)
+      params.merge!(default_params)
+      #p params.to_json
+      response = connection.post do |req|
+        req.url "#{ptv_path}/#{ptv_function}"
+        req.headers['Content-Type'] = 'application/json; charset=utf-8'
+        req.body = Oj.dump(params)
+      end
+      body = Oj.load(response.body)
+      #p body
+      (200..300).include?(response.status) ? body : raise(BadResponse.new(response.body))
+    end
+
+    def connection
+      Faraday.new(url: endpoint) do |faraday|
+        faraday.request  :url_encoded             # form-encode POST params
+        #faraday.response :logger                  # log requests to STDOUT
+        faraday.adapter  Faraday.default_adapter  # make requests with Net::HTTP
+      end
+    end
+    
+    def default_params
+      {
+        callerContext: {
+          properties: [
+            {
+              key: 'Profile',
+              value: 'car'
+            },
+            {
+              key: 'CoordFormat',
+              value: coord_format || :PTV_GEODECIMAL
+            }
+          ]
+        }
+      }
+    end
+
+    protected
+    
+      def parse_response(response)
+        if response.is_a? Array
+          multiple_response(response)
+        else
+          single_response(response)
+        end
+      end
+
+      def single_response(response)
+        response_class.new(response)
+      end
+
+      def multiple_response(responses)
+        lists = []
+        responses.each do |response|
+          lists << response_class.new(response)
+        end
+        lists
+      end
+  end
+end

data/lib/ruby_ptv_api/constant.rb

@@ -0,0 +1,107 @@
+module RubyPtvApi
+  module Constant
+    RESULT_FIELD = [
+      :COUNTRY, :STATE, :ADMINREGION, :CITY, :CITY2, :POSTCODE, :STREET, :HOUSENR, 
+      :COORDX, :COORDY, :DETAILLEVEL, :DETAILLEVEL_DESCRIPTION, :POPULATION, :EXTENSIONCLASS,
+      :LEVEL, :ISCITYDISTRICT, :COUNTRY_ISO2, :COUNTRY_ISO3, :COUNTRY_COUNTRYCODEPLATE, 
+      :COUNTRY_DIALINGCODE, :COUNTRY_CAPITAL, :COUNTRY_NAME, :HOUSENR_SIDE, :HOUSENR_STRUCTURE, 
+      :HOUSENR_STARTFORMAT, :HOUSENR_ENDFORMAT, :APPENDIX, :SCORE_TOTALSCORE, :SCORE_FINALPENALTY, 
+      :FOUNDBY_CITY, :FOUNDBY_CITY2, :FOUNDBY_POSTCODE, :FOUNDBY_STREET, :CLASSIFICATION, 
+      :CLASSIFICATION_DESCRIPTION, :SWAPANDSPLITMODE, :POPUPINFO, :PHONENUMBER, :SEGMENT_ID, 
+      :SEGMENT_COUNTRY, :SEGMENT_DIRECTION, :XYN, :POINAME, :POITYPE, :ADDRESS_CLASSIFICATION, 
+      :ADDRESS_CLASSIFICATION_DESCRIPTION, :POSTCODE_CLASSIFICATION, :TOWN_CLASSIFICATION, 
+      :STREET_CLASSIFICATION, :HOUSENR_CLASSIFICATION, :POSTCODE_CHARACTERISTICS, :TOWN_CHARACTERISTICS, 
+      :STREET_CHARACTERISTICS, :HOUSENR_CHARACTERISTICS, :UNMATCHED_WORDS, :UNMATCHED_WORDS_COUNT, 
+      :STREETX, :STREETY, :ADMINX, :ADMINY, :DESTINATION_LOCATION_NODE_N, :DESTINATION_LOCATION_NODE_Y,
+      :DESTINATION_LOCATION_NODE_X, :DESTINATION_LOCATION_TILE_Y, :DESTINATION_LOCATION_TILE_X, 
+      :DESTINATION_LOCATION_COUNTRYCODE, :START_LOCATION_NODE_N, :START_LOCATION_NODE_Y, 
+      :START_LOCATION_NODE_X, :START_LOCATION_TILE_Y, :START_LOCATION_TILE_X, :START_LOCATION_COUNTRYCODE, 
+      :ISBLOCKEDFORPEDESTRIANS, :ISBLOCKEDFORBICYCLES, :ISBLOCKEDFORMOTORCYCLES, :ISBLOCKEDFORCARS, 
+      :ISBLOCKEDFORVANS, :ISBLOCKEDFORCAMPERS, :ISBLOCKEDFORBUSES, :ISBLOCKEDFORHAZARDOUSGOODS, 
+      :ISBLOCKEDFORCOMBUSTIBLEGOODS, :ISBLOCKEDFORTRUCKS, :ARTIFICIALTOWNCHARACTERIZATION, 
+      :CITY_LEVEL, :STREETNUMBER, :HOUSENR_ATINPUTCOORDINATESIDE, :PROVINCE 
+    ]
+    
+    SORT_ORDER = [:ASCENDING, :DESCENDING]
+
+    CO_DRIVER_STATUS = [:NEVER, :ALWAYS, :IF_REQUIRED]
+
+    UNSCHEDULED_STOP_STATUS = [:FEASIBLE, :UNSCHEDULED_DUE_TO_PLAN, :UNSCHEDULED_DUE_TO_VEHICLES]
+
+    COORD_FORMAT = [:OG_GEODECIMAL, :PTV_MERCATOR, :PTV_GEOMINSEC, :PTV_GEODECIMAL, :PTV_CONFORM, :PTV_SUPERCONFORM, :PTV_SMARTUNITS, :OG_SRID]
+
+    OPENING_INTERVAL_CONTRAINT = [:START_OF_SERVICE, :COMPLETE_SERVICE]
+
+    PRODUCT_INCOMPATIBILITY_TYPE = [:NOT_ON_SAME_TOUR, :NOT_AT_SAME_TIME]
+
+    TOUR_POINT_FIXATION = [:NONE, :NO_TOUR_POINT_OUT, :NO_TOUR_POINT_IN_AND_OUT, :COMPLETELY_FIXED]
+
+    TOUR_POINT_TYPE = [:TRANSPORT_POINT, :DEPOT]
+
+    LINK_TYPE = [:NEXT_NODE, :NEXT_SEGMENT, :NEXT_MAIN_NODE, :FUZZY_LINKING, :AUTO_LINKING, :NEXT_MAIN_TOLL_NODE, :TOLL_STATION, :TI_LINKING]
+
+    ROUTING_PARAMETER = [
+      :OPTIMIZATION, :SPEED_PROFILE, :AVOID_NATIONALNAMEDTOLL_ROADS, :AVOID_TOLLROADS, :AVOID_VIGNETTEROADS, 
+      :AVOID_HIGHWAYS, :AVOID_FERRIES, :AVOID_RESIDENTS_ONLY, :AVOID_URBAN_AREAS, :AVOID_RAMPS, :AVOID_LOW_EMISSION_ZONES, 
+      :ALLOW_SEGMENT_VIOLATIONS, :COST_OF_SEGMENT_VIOLATIONS, :EXCLUDE_COUNTRIES , :ROUTING_COUNTRIES, 
+      :ROUTING_RECTANGLE, :AUTO, :ROUTE_LANGUAGE, :START_TIME, :IS_DESTTIME, :DYNAMIC_PROFILE, :ENABLE_DYNAMIC, 
+      :DYNAMIC_PROFILE, :ENABLE_ROADEDITOR, :ROADEDITOR_LAYERNAME, :START_TIME_ROADEDITOR, :ROADEDITOR_LAYERNAME, 
+      :ROADEDITOR_ATTRIBUTESET, :ROADEDITOR_ADDITIONAL_OPTIONS, :DISTANCE_MEASURE, :COUNTRY_ENCODING, 
+      :GENERATE_EXTWAYPOINTS, :EXPERT_OPTIONS, :ALT, :REQUEST_VERSION, :LOW_EMISSION_ZONE_TYPE, 
+      :DYNAMIC_TIME_ON_STATICROUTE, :DYNAMIC_TRAVEL_TIME_STEP_SIZE, :DYNAMIC_TRAVEL_TIME_STEP_COUNT, 
+      :SPEED_INFOS, :ENABLE_DYNAMIC_WITH_FREE_FLOW_SPEED, :GEODATASOURCE_LAYER, :REMAINING_DRIVING_TIMES 
+    ]
+
+    VIA_TYPE_ENUM = [:VIA, :VIA_STOP, :FUZZY, :COMBINED_TRANSPORT]
+
+    DETAIL_LEVEL = [:BORDERS, :VERY_IMPORTANT, :STANDARD, :LESS_IMPORTANT, :OTHER_OPPORTUNITIES, :ORTHOGONAL , :ALL]
+
+    EMISSION_LEVEL = [:NONE, :BASIC, :SEGMENTS, :STATIONS, :ALL]
+
+    HBEFA_VERSION = [:HBEFA_2_1, :HBEFA_3_1, :NO_HBEFA, :HBEFA_3_2, :COPERT_AUS_1_2]
+
+    CEN_VERSION = [:CEN_2011, :CEN_2012, :CO2_DECREE_FRANCE_2011, :AUSTRALIA_NGA_2011, :UK_DEFRA_2014]
+
+    WAY_POINT_TYPE = [:START, :VIA, :DEST]
+
+    TURN_WEIGHT = [:NORMAL, :HALF, :STRONG]
+
+    TURN_ORIENT = [:STRAIGHT, :LEFT, :RIGHT]
+
+    MANOEUVRE_TYPE = [
+      :FURTHER, :KEEP , :TURN , :UTURN, :ENTER, :EXIT , :ENTER_RA , :STAY_RA, :EXIT_RA, 
+      :CHANGE , :ENTER_FERRY , :EXIT_FERRY  , :EXIT_RA_ENTER , :EXIT_RA_ENTER_FERRY
+    ]
+
+    INFO_NODE_TYPE = [:NORMAL , :AE , :AS , :AD , :AK , :BORDER , :BUILT_UP , :FERRY, :TOLL_ROAD, :SIGN]
+
+    NETWORK_CLASS = [
+      :MOTORWAY, :HIGHWAY, :TRUNK_ROAD, :COUNTRY_ROAD, :CITY_ROAD, :RESIDENTIAL_ROAD, 
+      :SPECIAL_ROAD, :CYCLE_AND_WALKWAY 
+    ]
+
+    NORM_SPEED_TYPE = [:FREE_FLOW, :MAX_DYNAMIC, :STATIC]
+
+    BRUNNEL_CODE = [
+      :NOTHING, :OVER_WATER , :UNDER_WATER, :OVER_TRAIN , :UNDER_TRAIN, :OVER_STREET,
+      :UNDER_STREET , :BRIDGE , :TUNNEL
+    ]
+
+    MANOEUVRE_GROUP_TYPE = [:MG_TYPE1, :MG_TYPE2]
+
+    EXPANSION_TYPE = [:EXP_TIME, :EXP_DIST]
+
+    def self.constant_by_value( val )
+      constants.find{ |name| const_get(name)==val }
+    end
+
+    def self.validate(constant, value)
+      value = value.to_sym
+      if constant.include?(value)
+        value
+      else
+        raise WrongParameterFormat.new("#{value} is not a valid #{constant_by_value(constant)}")
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/id_manager.rb

@@ -0,0 +1,17 @@
+module RubyPtvApi
+  class IdManager
+    def initialize
+      @uuid_list = []
+    end
+
+    def add(uuid)
+      @uuid_list << uuid
+      @uuid_list.size
+    end
+
+    def uuid(id)
+      @uuid_list[id - 1]
+    end
+
+  end
+end

data/lib/ruby_ptv_api/model/base.rb

@@ -0,0 +1,12 @@
+module RubyPtvApi
+  module Model
+    class Base < Hashie::Dash
+      # Do not change include order
+      include Hashie::Extensions::Dash::PropertyTranslation
+      include Hashie::Extensions::MethodAccess
+      include Hashie::Extensions::Coercion
+      
+      property '$type', default: ->(obj) { obj.class.name.split(':').last }
+    end
+  end
+end

data/lib/ruby_ptv_api/model/plain_point.rb

@@ -0,0 +1,21 @@
+module RubyPtvApi
+  module Model
+    class PlainPoint < Base
+      # longitude
+      property 'x', transform_with: ->(value) do 
+        if value.to_i.to_s.size != 7
+          raise WrongParameterFormat.new("longitude must be a integer and have size 7 but #{value}")
+        end
+        value
+      end 
+      # latitude
+      property 'y', transform_with: ->(value) do 
+        if value.to_i.to_s.size != 7
+          raise WrongParameterFormat.new("latitude must be a integer and have size 7 but #{value}")
+        end
+        value
+      end  
+      property 'z'
+    end
+  end
+end

data/lib/ruby_ptv_api/model/point.rb

@@ -0,0 +1,9 @@
+module RubyPtvApi
+  module Model
+    class Point < Base
+      property 'point'
+      
+      coerce_key :point, PlainPoint
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_locate/additional_field.rb

@@ -0,0 +1,14 @@
+module RubyPtvApi
+  module Model
+    module XLocate
+      class AdditionalField < RubyPtvApi::Model::Base
+
+        property 'field', transform_with: ->(value) do 
+          RubyPtvApi::Constant.validate(RubyPtvApi::Constant::RESULT_FIELD, value)
+        end
+
+        property 'value'
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_locate/address.rb

@@ -0,0 +1,24 @@
+module RubyPtvApi
+  module Model
+    module XLocate
+      # Attribute Name | Type | Description
+      # country String  The country code of this address. Depends on the COUNTRY_CODETYPE settings.
+      # state String    The state code of this address.
+      # postCode  String    The postcode of this address.
+      # city  String    The city name of this address.
+      # city2 String    The city district of this address.
+      # street  String    The street name of this address.
+      # houseNumber String    The house number of this address.
+
+      class Address < RubyPtvApi::Model::Base
+        property 'country'
+        property 'state'
+        property 'postCode'
+        property 'city'
+        property 'city2'
+        property 'street'
+        property 'houseNumber'
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_locate/address_response.rb

@@ -0,0 +1,13 @@
+module RubyPtvApi
+  module Model
+    module XLocate
+      class AddressResponse < RubyPtvApi::Model::Base
+        property 'errorCode'
+        property 'errorDescription'
+        property 'resultList'
+
+        coerce_key :resultList, Array[ResultAddress] # Do not work if String 'resultList'
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_locate/combined_transport_location.rb

@@ -0,0 +1,13 @@
+module RubyPtvApi
+  module Model 
+    module XLocate
+      class CombinedTransportLocation < RubyPtvApi::Model::Base
+        property 'coordinate'
+        property 'country'
+        property 'name'
+        
+        coerce_key :coordinate, Point
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_locate/combined_transport_response.rb

@@ -0,0 +1,13 @@
+module RubyPtvApi
+  module Model
+    module XLocate
+      class CombinedTransportResponse < RubyPtvApi::Model::Base
+        property 'errorCode'
+        property 'errorDescription'
+        property 'resultList'
+
+        coerce_key :resultList, Array[RubyPtvApi::Model::XLocate::ResultCombinedTransport] # Do not work if String 'resultList'
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_locate/location.rb

@@ -0,0 +1,11 @@
+module RubyPtvApi
+  module Model
+    module XLocate
+      class Location < RubyPtvApi::Model::Base
+        property 'coordinate'
+        
+        coerce_key :coordinate, RubyPtvApi::Model::Point
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_locate/result_address.rb

@@ -0,0 +1,27 @@
+module RubyPtvApi
+  module Model
+    module XLocate
+      # adminRegion String   The administrative address supplement of the address.
+      # appendix  String   The appendix of the address.
+      # countryCapital  String   The capital of the country.
+      # totalScore  int  The quality score of the address candidate. Indicates the overall quality of the resultlist candidate. Does not indicate the match quality of the input address to the result (for this szenario use the classification). In location based search modes, this value is the distance in meter.
+      # detailLevelDescription  DetailLevelDescription   The detail level of the candidate. See DetailLevelDescription for possible values.
+      # classificationDescription ClassificationDescription  The classification of the address candidate based on the quality of the match. See ClassificationDescription for possible values.
+      # coordinates Point  The coordinates of the address candidate.
+      # additionalFields  AdditionalField[]  Additional result fields. The fields are returned in the same order as they have been requested.
+
+      class ResultAddress < Address
+        property 'adminRegion'
+        property 'appendix'
+        property 'countryCapital'
+        property 'totalScore'
+        property 'detailLevelDescription'
+        property 'classificationDescription'
+        property 'coordinates'
+        property 'additionalFields'
+
+        coerce_key :coordinates, Point
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_locate/result_combined_transport.rb

@@ -0,0 +1,30 @@
+module RubyPtvApi
+  module Model
+    module XLocate
+      # id  String  The unique key to identify the combined transport.
+      # name  String  The name of the combined transport.
+      # duration  int The duration in seconds of the combined transport.
+      # distance  double  The distance to the input location in meters.
+      # type  int The type of the combined transport. Legal values are:
+      #   1 - ferry: The combined transport is a ferry boat connection.
+      #   2 - piggyback: The combined transport is a piggyback train connection.
+      # start CombinedTransportLocation The start of the combined transport.
+      # destination CombinedTransportLocation The destination of the combined transport.
+      # combinedTransportFields AdditionalField[] Additional combined transport result fields. The fields are returned in the same order as they have been requested.
+      class ResultCombinedTransport < RubyPtvApi::Model::Base
+        property 'id'
+        property 'name'
+        property 'duration'
+        property 'distance'
+        property 'type'
+        property 'start'
+        property 'destination'
+        property 'combinedTransportFields'
+
+        coerce_key :start, CombinedTransportLocation
+        coerce_key :destination, CombinedTransportLocation
+        coerce_key :combinedTransportFields, Array[AdditionalField]
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_locate/sort_option.rb

@@ -0,0 +1,14 @@
+module RubyPtvApi
+  module Model
+    module XLocate
+      class SortOption < RubyPtvApi::Model::Base
+        property 'field', transform_with: ->(value) do 
+          RubyPtvApi::Constant.validate(RubyPtvApi::Constant::RESULT_FIELD, value)
+        end
+        property 'order', transform_with: ->(value) do 
+          RubyPtvApi::Constant.validate(RubyPtvApi::Constant::SORT_ORDER, value)
+        end
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_locate/suggestion.rb

@@ -0,0 +1,12 @@
+module RubyPtvApi
+  module Model 
+    module XLocate
+      class Suggestion < RubyPtvApi::Model::Base
+        property 'text'
+        property 'additionalFields'
+        
+        coerce_key :suggestionList, Array[AdditionalField]
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_locate/suggestion_response.rb

@@ -0,0 +1,13 @@
+module RubyPtvApi
+  module Model 
+    module XLocate
+      class SuggestionResponse < RubyPtvApi::Model::Base
+        property 'suggestionList'
+        property 'errorcode'
+        property 'errorDescription'
+
+        coerce_key :suggestionList, Array[Suggestion]
+      end
+    end
+  end
+end

data/lib/ruby_ptv_api/model/x_route/bounding_rectangle.rb

@@ -0,0 +1,13 @@
+module RubyPtvApi
+  module Model
+    module XRoute
+      class BoundingRectangle < RubyPtvApi::Model::Base
+        property 'leftBottom'
+        property 'rightTop'
+        
+        coerce_key :leftBottom,  Point
+        coerce_key :rightTop  ,  Point
+      end
+    end
+  end
+end