travel_time 0.9.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7806c052f2b4857a08bc6d0f7b837bb97ac8ad59dede5ccc31c184b286da7f0e
-  data.tar.gz: e430a1a07c86b58b0da059b68bec0c2f6d80e1a30d58fb8f063ef5f23cd25357
+  metadata.gz: 0aee6acebdce6aff8b6148cec9f40462ad286ab61d60920cf084744bd1a9a465
+  data.tar.gz: e2669e644f779a1489e301d697ad2db403ffe44191c52d0a8b6a1c2e6a4d2543
 SHA512:
-  metadata.gz: e99e0868f46c664a8cb2b7b430f3b05c111f235bf6ce19069b8b0d9ffab3301cc390fd85ca1c653ef1bd3fb3ad54f006018e0c6a6e8f2bd9b67de7938cf7e1ed
-  data.tar.gz: 6c7ef8ccb25d3bc4a7190f647e0a786a31f97b30c19a1b14383565eb00513d6471081c4c677bc48b6167d03cc9a0ef1dee699f8017ff746d7b4014c94d3c3a2b
+  metadata.gz: 7cd1b1bfa1d81d733f8f09bd35995ae9e8f9ea7ec876ab8c829a5cf54842a3acd8d9ebb5952227af54543a06142243551f0c836bd58f05ad7902e0fa10164756
+  data.tar.gz: 18245fd2e496b743294370d771411997f1d6bbebec1b06f163bd0256081a0cb3b192eb7873c37b6b18c87881b4e0aad29eaabfb519ff0403bfaa48dc84bbd5fe

data/README.md

@@ -42,6 +42,17 @@ After that, you can instantiate a client to initiate the API connection:
 client = TravelTime::Client.new
 ```
 
+A client can also be configured individually, for example to use separate credentials for
+batch operations. Settings not overridden in the block are inherited from the global
+configuration:
+
+```ruby
+batch_client = TravelTime::Client.new.configure do |config|
+  config.application_id = 'YOUR_BATCH_APP_ID'
+  config.api_key = 'YOUR_BATCH_APP_KEY'
+end
+```
+
 You can then use the client to call API endpoints:
 
 ```ruby
@@ -77,7 +88,7 @@ client.time_map(departure_searches: [departure_search])
 You may specify an optional rate limit when initializing your client. The `rate_limit` parameter sets a cap on the number of requests that can be made to the API in 60 seconds. Requests are balanced at equal intervals.
 
 ```ruby
-client = TravelTime::Client.new(rate_limit = 60)
+client = TravelTime::Client.new(rate_limit = 120)
 ```
 
 ### [Isochrones (Time Map)](https://docs.traveltime.com/api/reference/isochrones)
@@ -379,11 +390,12 @@ A fast version of time filter communicating using [protocol buffers](https://git
 
 Body attributes:
 * origin: Origin point.
-* destinations: Destination points. Cannot be more than 200,000.
+* destinations: Destination points. There is no fixed limit on the number of destinations; a request can be up to 10MB (around 2 million locations).
 * country: Return the results that are within the specified country.
 * transport: Transportation type (string) or Transportation object.
 * traveltime: Time limit.
 * with_distance: (Optional) If true, returns distances in addition to travel times.
+* with_fares: (Optional) If true, returns monthly public transport fares in addition to travel times.
 * request_type: (Optional) Specifies the request type - either `TravelTime::ProtoUtils::ONE_TO_MANY` (default) or `TravelTime::ProtoUtils::MANY_TO_ONE`.
 
 #### One-to-Many (default)
@@ -487,6 +499,48 @@ response = client.time_filter_fast_proto(
 * `parking_time` - constant penalty to apply to simulate the difficulty of finding a parking spot.
   Optional. Must be non-negative. Cannot be greater than the global travel time limit.
 
+### [Geohash Fast (Proto)](https://docs.traveltime.com/api/start/geohash-proto)
+
+A fast version of geohash communicating using [protocol buffers](https://github.com/protocolbuffers/protobuf).
+
+Body attributes:
+* country: Return the results that are within the specified country.
+* origin: Location of the search (departure point, or arrival point with `request_type: :many_to_one`).
+* transport: Transportation type, e.g. `{ type: 'driving+ferry' }`.
+* traveltime: Time limit.
+* resolution: Geohash resolution (cell size).
+* properties: (Optional) Travel time statistics to return — any of `:min`, `:max`, `:mean`.
+* remove_water_bodies: (Optional) When true, returned cells will not cover large nearby water bodies. Only sent when set.
+* request_type: (Optional) `:one_to_many` (default) or `:many_to_one`.
+
+```ruby
+response = client.geohash_fast_proto(
+  country: :uk,
+  origin: { lat: 51.508930, lng: -0.131387 },
+  transport: { type: 'driving+ferry' },
+  traveltime: 1800,
+  resolution: 6,
+  properties: [:min]
+)
+```
+
+### [H3 Fast (Proto)](https://docs.traveltime.com/api/start/h3-proto)
+
+A fast version of H3 communicating using [protocol buffers](https://github.com/protocolbuffers/protobuf).
+Takes the same attributes as Geohash Fast (Proto) with an H3 `resolution`; cell ids are returned in their
+15-character hexadecimal form.
+
+```ruby
+response = client.h3_fast_proto(
+  country: :uk,
+  origin: { lat: 51.508930, lng: -0.131387 },
+  transport: { type: 'driving+ferry' },
+  traveltime: 1800,
+  resolution: 7,
+  properties: [:min]
+)
+```
+
 ### [Routes](https://docs.traveltime.com/api/reference/routes)
 Returns routing information between source and destinations.
 

data/lib/GeohashFastRequest_pb.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: GeohashFastRequest.proto
+
+require 'google/protobuf'
+
+require 'RequestsCommon_pb'
+
+
+descriptor_data = "\n\x18GeohashFastRequest.proto\x12)com.igeolise.traveltime.rabbitmq.requests\x1a\x14RequestsCommon.proto\"\xb8\x08\n\x12GeohashFastRequest\x12\x61\n\x10oneToManyRequest\x18\x01 \x01(\x0b\x32G.com.igeolise.traveltime.rabbitmq.requests.GeohashFastRequest.OneToMany\x12\x61\n\x10manyToOneRequest\x18\x02 \x01(\x0b\x32G.com.igeolise.traveltime.rabbitmq.requests.GeohashFastRequest.ManyToOne\x1a\xad\x03\n\tOneToMany\x12L\n\x11\x64\x65partureLocation\x18\x01 \x01(\x0b\x32\x31.com.igeolise.traveltime.rabbitmq.requests.Coords\x12Q\n\x0etransportation\x18\x02 \x01(\x0b\x32\x39.com.igeolise.traveltime.rabbitmq.requests.Transportation\x12P\n\x11\x61rrivalTimePeriod\x18\x03 \x01(\x0e\x32\x35.com.igeolise.traveltime.rabbitmq.requests.TimePeriod\x12\x12\n\ntravelTime\x18\x04 \x01(\x11\x12\x12\n\nresolution\x18\x05 \x01(\r\x12O\n\nproperties\x18\x06 \x03(\x0e\x32;.com.igeolise.traveltime.rabbitmq.requests.CellPropertyType\x12\x1e\n\x11removeWaterBodies\x18\x07 \x01(\x08H\x00\x88\x01\x01\x42\x14\n\x12_removeWaterBodies\x1a\xab\x03\n\tManyToOne\x12J\n\x0f\x61rrivalLocation\x18\x01 \x01(\x0b\x32\x31.com.igeolise.traveltime.rabbitmq.requests.Coords\x12Q\n\x0etransportation\x18\x02 \x01(\x0b\x32\x39.com.igeolise.traveltime.rabbitmq.requests.Transportation\x12P\n\x11\x61rrivalTimePeriod\x18\x03 \x01(\x0e\x32\x35.com.igeolise.traveltime.rabbitmq.requests.TimePeriod\x12\x12\n\ntravelTime\x18\x04 \x01(\x11\x12\x12\n\nresolution\x18\x05 \x01(\r\x12O\n\nproperties\x18\x06 \x03(\x0e\x32;.com.igeolise.traveltime.rabbitmq.requests.CellPropertyType\x12\x1e\n\x11removeWaterBodies\x18\x07 \x01(\x08H\x00\x88\x01\x01\x42\x14\n\x12_removeWaterBodiesb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["com.igeolise.traveltime.rabbitmq.requests.Coords", "RequestsCommon.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Com
+  module Igeolise
+    module Traveltime
+      module Rabbitmq
+        module Requests
+          GeohashFastRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.igeolise.traveltime.rabbitmq.requests.GeohashFastRequest").msgclass
+          GeohashFastRequest::OneToMany = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.igeolise.traveltime.rabbitmq.requests.GeohashFastRequest.OneToMany").msgclass
+          GeohashFastRequest::ManyToOne = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.igeolise.traveltime.rabbitmq.requests.GeohashFastRequest.ManyToOne").msgclass
+        end
+      end
+    end
+  end
+end

data/lib/GeohashFastResponse_pb.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: GeohashFastResponse.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x19GeohashFastResponse.proto\x12*com.igeolise.traveltime.rabbitmq.responses\"\xca\x01\n\x13GeohashFastResponse\x12T\n\x05\x63\x65lls\x18\x01 \x01(\x0b\x32\x45.com.igeolise.traveltime.rabbitmq.responses.GeohashFastResponse.Cells\x1a]\n\x05\x43\x65lls\x12\x0b\n\x03ids\x18\x01 \x03(\t\x12\x16\n\x0eminTravelTimes\x18\x02 \x03(\x11\x12\x16\n\x0emaxTravelTimes\x18\x03 \x03(\x11\x12\x17\n\x0fmeanTravelTimes\x18\x04 \x03(\x11\x62\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Com
+  module Igeolise
+    module Traveltime
+      module Rabbitmq
+        module Responses
+          GeohashFastResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.igeolise.traveltime.rabbitmq.responses.GeohashFastResponse").msgclass
+          GeohashFastResponse::Cells = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.igeolise.traveltime.rabbitmq.responses.GeohashFastResponse.Cells").msgclass
+        end
+      end
+    end
+  end
+end

data/lib/H3FastRequest_pb.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: H3FastRequest.proto
+
+require 'google/protobuf'
+
+require 'RequestsCommon_pb'
+
+
+descriptor_data = "\n\x13H3FastRequest.proto\x12)com.igeolise.traveltime.rabbitmq.requests\x1a\x14RequestsCommon.proto\"\xa9\x08\n\rH3FastRequest\x12\\\n\x10oneToManyRequest\x18\x01 \x01(\x0b\x32\x42.com.igeolise.traveltime.rabbitmq.requests.H3FastRequest.OneToMany\x12\\\n\x10manyToOneRequest\x18\x02 \x01(\x0b\x32\x42.com.igeolise.traveltime.rabbitmq.requests.H3FastRequest.ManyToOne\x1a\xad\x03\n\tOneToMany\x12L\n\x11\x64\x65partureLocation\x18\x01 \x01(\x0b\x32\x31.com.igeolise.traveltime.rabbitmq.requests.Coords\x12Q\n\x0etransportation\x18\x02 \x01(\x0b\x32\x39.com.igeolise.traveltime.rabbitmq.requests.Transportation\x12P\n\x11\x61rrivalTimePeriod\x18\x03 \x01(\x0e\x32\x35.com.igeolise.traveltime.rabbitmq.requests.TimePeriod\x12\x12\n\ntravelTime\x18\x04 \x01(\x11\x12\x12\n\nresolution\x18\x05 \x01(\r\x12O\n\nproperties\x18\x06 \x03(\x0e\x32;.com.igeolise.traveltime.rabbitmq.requests.CellPropertyType\x12\x1e\n\x11removeWaterBodies\x18\x07 \x01(\x08H\x00\x88\x01\x01\x42\x14\n\x12_removeWaterBodies\x1a\xab\x03\n\tManyToOne\x12J\n\x0f\x61rrivalLocation\x18\x01 \x01(\x0b\x32\x31.com.igeolise.traveltime.rabbitmq.requests.Coords\x12Q\n\x0etransportation\x18\x02 \x01(\x0b\x32\x39.com.igeolise.traveltime.rabbitmq.requests.Transportation\x12P\n\x11\x61rrivalTimePeriod\x18\x03 \x01(\x0e\x32\x35.com.igeolise.traveltime.rabbitmq.requests.TimePeriod\x12\x12\n\ntravelTime\x18\x04 \x01(\x11\x12\x12\n\nresolution\x18\x05 \x01(\r\x12O\n\nproperties\x18\x06 \x03(\x0e\x32;.com.igeolise.traveltime.rabbitmq.requests.CellPropertyType\x12\x1e\n\x11removeWaterBodies\x18\x07 \x01(\x08H\x00\x88\x01\x01\x42\x14\n\x12_removeWaterBodiesb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["com.igeolise.traveltime.rabbitmq.requests.Coords", "RequestsCommon.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Com
+  module Igeolise
+    module Traveltime
+      module Rabbitmq
+        module Requests
+          H3FastRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.igeolise.traveltime.rabbitmq.requests.H3FastRequest").msgclass
+          H3FastRequest::OneToMany = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.igeolise.traveltime.rabbitmq.requests.H3FastRequest.OneToMany").msgclass
+          H3FastRequest::ManyToOne = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.igeolise.traveltime.rabbitmq.requests.H3FastRequest.ManyToOne").msgclass
+        end
+      end
+    end
+  end
+end

data/lib/H3FastResponse_pb.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: H3FastResponse.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x14H3FastResponse.proto\x12*com.igeolise.traveltime.rabbitmq.responses\"\xc0\x01\n\x0eH3FastResponse\x12O\n\x05\x63\x65lls\x18\x01 \x01(\x0b\x32@.com.igeolise.traveltime.rabbitmq.responses.H3FastResponse.Cells\x1a]\n\x05\x43\x65lls\x12\x0b\n\x03ids\x18\x01 \x03(\x06\x12\x16\n\x0eminTravelTimes\x18\x02 \x03(\x11\x12\x16\n\x0emaxTravelTimes\x18\x03 \x03(\x11\x12\x17\n\x0fmeanTravelTimes\x18\x04 \x03(\x11\x62\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Com
+  module Igeolise
+    module Traveltime
+      module Rabbitmq
+        module Responses
+          H3FastResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.igeolise.traveltime.rabbitmq.responses.H3FastResponse").msgclass
+          H3FastResponse::Cells = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.igeolise.traveltime.rabbitmq.responses.H3FastResponse.Cells").msgclass
+        end
+      end
+    end
+  end
+end

data/lib/TimeFilterFastResponse_pb.rb

@@ -5,7 +5,7 @@
 require 'google/protobuf'
 
 
-descriptor_data = "\n\x1cTimeFilterFastResponse.proto\x12*com.igeolise.traveltime.rabbitmq.responses\"\x84\x08\n\x16TimeFilterFastResponse\x12[\n\x05\x65rror\x18\x01 \x01(\x0b\x32H.com.igeolise.traveltime.rabbitmq.responses.TimeFilterFastResponse.ErrorB\x02\x18\x01\x12\x61\n\nproperties\x18\x02 \x01(\x0b\x32M.com.igeolise.traveltime.rabbitmq.responses.TimeFilterFastResponse.Properties\x1aJ\n\nProperties\x12\x13\n\x0btravelTimes\x18\x01 \x03(\x11\x12\x14\n\x0cmonthlyFares\x18\x02 \x03(\x05\x12\x11\n\tdistances\x18\x03 \x03(\x05\x1a\x63\n\x05\x45rror\x12Z\n\x04type\x18\x01 \x01(\x0e\x32L.com.igeolise.traveltime.rabbitmq.responses.TimeFilterFastResponse.ErrorType\"\xf8\x04\n\tErrorType\x12\x0f\n\x07UNKNOWN\x10\x00\x1a\x02\x08\x01\x12$\n\x1cONE_TO_MANY_MUST_NOT_BE_NULL\x10\x01\x1a\x02\x08\x01\x12\x1f\n\x17SOURCE_MUST_NOT_BE_NULL\x10\x02\x1a\x02\x08\x01\x12\'\n\x1fTRANSPORTATION_MUST_NOT_BE_NULL\x10\x03\x1a\x02\x08\x01\x12\x1e\n\x16SOURCE_NOT_IN_GEOMETRY\x10\x04\x1a\x02\x08\x01\x12(\n UNRECOGNIZED_TRANSPORTATION_MODE\x10\x05\x1a\x02\x08\x01\x12!\n\x19TRAVEL_TIME_LIMIT_TOO_LOW\x10\x06\x1a\x02\x08\x01\x12\"\n\x1aTRAVEL_TIME_LIMIT_TOO_HIGH\x10\x07\x1a\x02\x08\x01\x12\x1d\n\x15\x41UTH_ERROR_NO_USER_ID\x10\x08\x1a\x02\x08\x01\x12\x32\n*SERVICE_MISMATCH_WRONG_TRANSPORTATION_MODE\x10\t\x1a\x02\x08\x01\x12\x1b\n\x13SOURCE_OUT_OF_REACH\x10\n\x1a\x02\x08\x01\x12\x33\n+INTERLEAVED_DELTAS_INVALID_COORDINATE_PAIRS\x10\x0b\x1a\x02\x08\x01\x12\'\n\x1f\x44ISTANCE_PROPERTY_NOT_SUPPORTED\x10\x0c\x1a\x02\x08\x01\x12\x37\n/BOTH_MANY_TO_ONE_AND_ONE_TO_MANY_CANNOT_BE_SENT\x10\r\x1a\x02\x08\x01\x12\x33\n+ONE_TO_MANY_OR_MANY_TO_ONE_MUST_NOT_BE_NULL\x10\x0e\x1a\x02\x08\x01\x12\x1d\n\x15INVALID_PROTO_REQUEST\x10\x0f\x1a\x02\x08\x01\x62\x06proto3"
+descriptor_data = "\n\x1cTimeFilterFastResponse.proto\x12*com.igeolise.traveltime.rabbitmq.responses\"\xf0\n\n\x16TimeFilterFastResponse\x12[\n\x05\x65rror\x18\x01 \x01(\x0b\x32H.com.igeolise.traveltime.rabbitmq.responses.TimeFilterFastResponse.ErrorB\x02\x18\x01\x12\x61\n\nproperties\x18\x02 \x01(\x0b\x32M.com.igeolise.traveltime.rabbitmq.responses.TimeFilterFastResponse.Properties\x1aJ\n\nProperties\x12\x13\n\x0btravelTimes\x18\x01 \x03(\x11\x12\x14\n\x0cmonthlyFares\x18\x02 \x03(\x05\x12\x11\n\tdistances\x18\x03 \x03(\x05\x1a\x63\n\x05\x45rror\x12Z\n\x04type\x18\x01 \x01(\x0e\x32L.com.igeolise.traveltime.rabbitmq.responses.TimeFilterFastResponse.ErrorType\"\xe4\x07\n\tErrorType\x12\x0f\n\x07UNKNOWN\x10\x00\x1a\x02\x08\x01\x12$\n\x1cONE_TO_MANY_MUST_NOT_BE_NULL\x10\x01\x1a\x02\x08\x01\x12\x1f\n\x17SOURCE_MUST_NOT_BE_NULL\x10\x02\x1a\x02\x08\x01\x12\'\n\x1fTRANSPORTATION_MUST_NOT_BE_NULL\x10\x03\x1a\x02\x08\x01\x12\x1e\n\x16SOURCE_NOT_IN_GEOMETRY\x10\x04\x1a\x02\x08\x01\x12(\n UNRECOGNIZED_TRANSPORTATION_MODE\x10\x05\x1a\x02\x08\x01\x12!\n\x19TRAVEL_TIME_LIMIT_TOO_LOW\x10\x06\x1a\x02\x08\x01\x12\"\n\x1aTRAVEL_TIME_LIMIT_TOO_HIGH\x10\x07\x1a\x02\x08\x01\x12\x1d\n\x15\x41UTH_ERROR_NO_USER_ID\x10\x08\x1a\x02\x08\x01\x12\x32\n*SERVICE_MISMATCH_WRONG_TRANSPORTATION_MODE\x10\t\x1a\x02\x08\x01\x12\x1b\n\x13SOURCE_OUT_OF_REACH\x10\n\x1a\x02\x08\x01\x12\x33\n+INTERLEAVED_DELTAS_INVALID_COORDINATE_PAIRS\x10\x0b\x1a\x02\x08\x01\x12\'\n\x1f\x44ISTANCE_PROPERTY_NOT_SUPPORTED\x10\x0c\x1a\x02\x08\x01\x12\x37\n/BOTH_MANY_TO_ONE_AND_ONE_TO_MANY_CANNOT_BE_SENT\x10\r\x1a\x02\x08\x01\x12\x33\n+ONE_TO_MANY_OR_MANY_TO_ONE_MUST_NOT_BE_NULL\x10\x0e\x1a\x02\x08\x01\x12\x1d\n\x15INVALID_PROTO_REQUEST\x10\x0f\x1a\x02\x08\x01\x12\x19\n\x11TOO_MANY_REQUESTS\x10\x10\x1a\x02\x08\x01\x12+\n#PARKING_TIME_OVER_TRAVEL_TIME_LIMIT\x10\x11\x1a\x02\x08\x01\x12(\n WALK_TO_STATION_MUST_BE_POSITIVE\x10\x12\x1a\x02\x08\x01\x12.\n&WALK_TO_STATION_OVER_TRAVEL_TIME_LIMIT\x10\x13\x1a\x02\x08\x01\x12 \n\x18WALK_TO_STATION_TOO_HIGH\x10\x14\x1a\x02\x08\x01\x12)\n!DRIVE_TO_STATION_MUST_BE_POSITIVE\x10\x15\x1a\x02\x08\x01\x12/\n\'DRIVE_TO_STATION_OVER_TRAVEL_TIME_LIMIT\x10\x16\x1a\x02\x08\x01\x12!\n\x19\x44RIVE_TO_STATION_TOO_HIGH\x10\x17\x1a\x02\x08\x01\x12\'\n\x1fTRANSPORTATION_DETAILS_MISMATCH\x10\x18\x1a\x02\x08\x01\x62\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 

data/lib/travel_time/client.rb

@@ -9,11 +9,20 @@ require 'limiter'
 module TravelTime
   # The Client class provides the main interface to interact with the TravelTime API
   class Client # rubocop:disable Metrics/ClassLength
+    include Dry::Configurable
     extend Limiter::Mixin
 
     API_BASE_URL = 'https://api.traveltimeapp.com/v4/'
     PROTO_BASE_URL = 'https://proto.api.traveltimeapp.com/api/v3/'
 
+    TravelTime.settings.each do |s|
+      if s.default.nil?
+        setting s.name
+      else
+        setting s.name, default: s.default
+      end
+    end
+
     attr_reader :connection, :proto_connection
 
     def initialize(rate_limit = nil)
@@ -27,32 +36,66 @@ module TravelTime
       end
     end
 
+    # Instance configuration starts as a copy of the global config, so settings not
+    # overridden in the block keep their globally configured values. Connections are
+    # rebuilt afterwards so the new config takes effect.
+    def configure
+      inherit_global_config unless @instance_configured
+      super.tap do
+        @instance_configured = true
+        init_connection
+        init_proto_connection
+      end
+    end
+
+    def effective_config
+      @instance_configured ? config : TravelTime.config
+    end
+
+    def inherit_global_config
+      TravelTime.settings.each do |s|
+        config.public_send(:"#{s.name}=", TravelTime.config.public_send(s.name))
+      end
+    end
+    private :inherit_global_config
+
     def init_connection
+      cfg = effective_config
       @connection = Faraday.new(API_BASE_URL) do |f|
         f.request :json
-        f.response :raise_error if TravelTime.config.raise_on_failure
-        f.response :logger if TravelTime.config.enable_logging
+        f.response :raise_error if cfg.raise_on_failure
+        f.response :logger if cfg.enable_logging
         f.response :json
-        f.use TravelTime::Middleware::Authentication
-        f.adapter TravelTime.config.http_adapter || Faraday.default_adapter
+        f.use TravelTime::Middleware::Authentication, config: cfg
+        f.adapter cfg.http_adapter || Faraday.default_adapter
       end
     end
 
     def init_proto_connection
+      cfg = effective_config
       @proto_connection = Faraday.new do |f|
-        f.response :raise_error if TravelTime.config.raise_on_failure
-        f.response :logger if TravelTime.config.enable_logging
-        f.use TravelTime::Middleware::ProtoMiddleware
-        f.adapter TravelTime.config.http_adapter || Faraday.default_adapter
+        f.response :raise_error if cfg.raise_on_failure
+        f.response :logger if cfg.enable_logging
+        f.use TravelTime::Middleware::ProtoMiddleware, config: cfg
+        f.adapter cfg.http_adapter || Faraday.default_adapter
       end
     end
 
+    def proto_properties(with_fares, with_distance)
+      property_enum = Com::Igeolise::Traveltime::Rabbitmq::Requests::TimeFilterFastRequest::Property
+      properties = []
+      properties << property_enum::FARES if with_fares
+      properties << property_enum::DISTANCES if with_distance
+      properties.empty? ? nil : properties
+    end
+    private :proto_properties
+
     def unwrap(response)
       Response.from_object(response)
     end
 
-    def unwrap_proto(response)
-      Response.from_object_proto(response)
+    def unwrap_proto(response, decoder: nil)
+      Response.from_object_proto(response, decoder: decoder)
     end
 
     def perform_request
@@ -65,8 +108,8 @@ module TravelTime
       raise TravelTime::Error.new(exception: e)
     end
 
-    def perform_request_proto
-      unwrap_proto(yield)
+    def perform_request_proto(decoder: nil)
+      unwrap_proto(yield, decoder: decoder)
     rescue Faraday::Error => e
       raise TravelTime::Error.new(response: Response.from_proto_error(e.response), exception: e) if e.response
 
@@ -152,10 +195,9 @@ module TravelTime
     end
 
     def time_filter_fast_proto(country:, origin:, destinations:, transport:, traveltime:, with_distance: false,
-                               request_type: nil)
+                               with_fares: false, request_type: nil)
       transport_obj = Transport.new(transport)
-      distance_prop = Com::Igeolise::Traveltime::Rabbitmq::Requests::TimeFilterFastRequest::Property::DISTANCES
-      properties = with_distance ? [distance_prop] : nil
+      properties = proto_properties(with_fares, with_distance)
       message = ProtoUtils.make_proto_message(origin, destinations, transport_obj, traveltime,
                                               properties: properties, request_type: request_type)
       payload = ProtoUtils.encode_proto_message(message)
@@ -163,6 +205,37 @@ module TravelTime
       perform_request_proto { proto_connection.post(path, payload) }
     end
 
+    def geohash_fast_proto(country:, origin:, transport:, traveltime:, resolution:, properties: nil,
+                           remove_water_bodies: nil, request_type: nil)
+      requests = Com::Igeolise::Traveltime::Rabbitmq::Requests
+      responses = Com::Igeolise::Traveltime::Rabbitmq::Responses
+      cell_fast_proto(requests::GeohashFastRequest, responses::GeohashFastResponse, 'geohash', country, origin,
+                      transport, traveltime, resolution: resolution, properties: properties,
+                                             remove_water_bodies: remove_water_bodies, request_type: request_type)
+    end
+
+    def h3_fast_proto(country:, origin:, transport:, traveltime:, resolution:, properties: nil,
+                      remove_water_bodies: nil, request_type: nil)
+      requests = Com::Igeolise::Traveltime::Rabbitmq::Requests
+      responses = Com::Igeolise::Traveltime::Rabbitmq::Responses
+      response = cell_fast_proto(requests::H3FastRequest, responses::H3FastResponse, 'h3', country, origin,
+                                 transport, traveltime, resolution: resolution, properties: properties,
+                                                        remove_water_bodies: remove_water_bodies,
+                                                        request_type: request_type)
+      response.body.dig(:cells, :ids)&.map! { |id| format('%x', id) }
+      response
+    end
+
+    def cell_fast_proto(request_klass, response_klass, endpoint, country, origin, transport, traveltime, options)
+      transport_obj = Transport.new(transport)
+      message = ProtoUtils.make_cell_proto_message(request_klass, origin, transport_obj, traveltime, options)
+      payload = request_klass.encode(message)
+      path = "#{PROTO_BASE_URL}#{country.to_s.downcase}/#{endpoint}/fast/#{transport_obj.url_name}"
+      decoder = ProtoUtils.cell_response_decoder(response_klass)
+      perform_request_proto(decoder: decoder) { proto_connection.post(path, payload) }
+    end
+    private :cell_fast_proto
+
     def time_filter_postcodes(departure_searches: nil, arrival_searches: nil)
       payload = {
         departure_searches: departure_searches,

data/lib/travel_time/middleware/authentication.rb

@@ -11,9 +11,14 @@ module TravelTime
       API_KEY_HEADER = 'X-Api-Key'
       USER_AGENT = 'User-Agent'
 
+      def initialize(app, options = {})
+        super(app)
+        @config = options[:config] || TravelTime.config
+      end
+
       def on_request(env)
-        env.request_headers[APP_ID_HEADER] = TravelTime.config.application_id
-        env.request_headers[API_KEY_HEADER] = TravelTime.config.api_key
+        env.request_headers[APP_ID_HEADER] = @config.application_id
+        env.request_headers[API_KEY_HEADER] = @config.api_key
         env.request_headers[USER_AGENT] = "Travel Time Ruby SDK #{TravelTime::VERSION}"
       end
     end

data/lib/travel_time/middleware/proto.rb

@@ -9,15 +9,20 @@ module TravelTime
     # The Proto middleware is responsible for setting the basic auth headers for proto requests
     # on each request. These are automatically taken from the `TravelTime.config`.
     class ProtoMiddleware < Faraday::Middleware
+      def initialize(app, options = {})
+        super(app)
+        @config = options[:config] || TravelTime.config
+      end
+
       def on_request(env)
         scheme = env.url.scheme
         raise TravelTime::Error, "Refusing to send credentials over #{scheme}" unless scheme == 'https'
 
         env.request_headers['Authorization'] =
-          "Basic #{Base64.strict_encode64("#{TravelTime.config.application_id}:#{TravelTime.config.api_key}")}"
+          "Basic #{Base64.strict_encode64("#{@config.application_id}:#{@config.api_key}")}"
         env.request_headers['Content-Type'] = 'application/octet-stream'
         env.request_headers['Accept'] = 'application/octet-stream'
-        env.request_headers['User-Agent'] = 'Travel Time Ruby SDK'
+        env.request_headers['User-Agent'] = "Travel Time Ruby SDK #{TravelTime::VERSION}"
       end
     end
   end

data/lib/travel_time/proto/source/GeohashFastRequest.proto

@@ -0,0 +1,32 @@
+syntax = "proto3";
+
+package com.igeolise.traveltime.rabbitmq.requests;
+
+import "RequestsCommon.proto";
+
+message GeohashFastRequest {
+  message OneToMany {
+    Coords departureLocation = 1;
+    Transportation transportation = 2;
+    TimePeriod arrivalTimePeriod = 3;
+    sint32 travelTime = 4;
+    uint32 resolution = 5;
+    repeated CellPropertyType properties = 6;
+    // if absent will default to `true`
+    optional bool removeWaterBodies = 7;
+  }
+
+  message ManyToOne {
+    Coords arrivalLocation = 1;
+    Transportation transportation = 2;
+    TimePeriod arrivalTimePeriod = 3;
+    sint32 travelTime = 4;
+    uint32 resolution = 5;
+    repeated CellPropertyType properties = 6;
+    // if absent will default to `true`
+    optional bool removeWaterBodies = 7;
+  }
+
+  OneToMany oneToManyRequest = 1;
+  ManyToOne manyToOneRequest = 2;
+}

data/lib/travel_time/proto/source/GeohashFastResponse.proto

@@ -0,0 +1,14 @@
+syntax = "proto3";
+
+package com.igeolise.traveltime.rabbitmq.responses;
+
+message GeohashFastResponse {
+  message Cells {
+    repeated string ids = 1;
+    repeated sint32 minTravelTimes = 2;
+    repeated sint32 maxTravelTimes = 3;
+    repeated sint32 meanTravelTimes = 4;
+  }
+
+  Cells cells = 1;
+}

data/lib/travel_time/proto/source/H3FastRequest.proto

@@ -0,0 +1,32 @@
+syntax = "proto3";
+
+package com.igeolise.traveltime.rabbitmq.requests;
+
+import "RequestsCommon.proto";
+
+message H3FastRequest {
+  message OneToMany {
+    Coords departureLocation = 1;
+    Transportation transportation = 2;
+    TimePeriod arrivalTimePeriod = 3;
+    sint32 travelTime = 4;
+    uint32 resolution = 5;
+    repeated CellPropertyType properties = 6;
+    // if absent will default to `true`
+    optional bool removeWaterBodies = 7;
+  }
+
+  message ManyToOne {
+    Coords arrivalLocation = 1;
+    Transportation transportation = 2;
+    TimePeriod arrivalTimePeriod = 3;
+    sint32 travelTime = 4;
+    uint32 resolution = 5;
+    repeated CellPropertyType properties = 6;
+    // if absent will default to `true`
+    optional bool removeWaterBodies = 7;
+  }
+
+  OneToMany oneToManyRequest = 1;
+  ManyToOne manyToOneRequest = 2;
+}

data/lib/travel_time/proto/source/H3FastResponse.proto

@@ -0,0 +1,21 @@
+syntax = "proto3";
+
+package com.igeolise.traveltime.rabbitmq.responses;
+
+message H3FastResponse {
+  message Cells {
+    // H3 cell indices as fixed64 (the native H3Index representation,
+    // see https://h3geo.org/docs/library/index/cell). fixed64 (not uint64):
+    // every valid H3 cell ID has the mode bit set (bit 59), so values are
+    // always >= 2^59 and varint would always spend the full 9 bytes.
+    // fixed64 is 8 bytes and avoids varint encode/decode overhead.
+    // Clients that need the 15-char hex form should call their H3 library's
+    // int-to-string.
+    repeated fixed64 ids = 1;
+    repeated sint32 minTravelTimes = 2;
+    repeated sint32 maxTravelTimes = 3;
+    repeated sint32 meanTravelTimes = 4;
+  }
+
+  Cells cells = 1;
+}

data/lib/travel_time/proto/source/TimeFilterFastResponse.proto

@@ -91,6 +91,56 @@ message TimeFilterFastResponse {
       * Invalid proto request
       */
      INVALID_PROTO_REQUEST = 15 [deprecated = true];
+
+     /*
+      * The user has gone over their request limit rate
+      */
+     TOO_MANY_REQUESTS = 16 [deprecated = true];
+
+     /*
+      * Parking time penalty is over the overall travel time limit for the journey
+      */
+     PARKING_TIME_OVER_TRAVEL_TIME_LIMIT = 17 [deprecated = true];
+
+     /*
+      * Walk to station penalty must be > 0
+      */
+     WALK_TO_STATION_MUST_BE_POSITIVE = 18 [deprecated = true];
+
+     /*
+      * Walk to station limit cannot be greater than the global travel time
+      * limit for the journey.
+      */
+     WALK_TO_STATION_OVER_TRAVEL_TIME_LIMIT = 19 [deprecated = true];
+
+     /*
+      * Walk to station limit cannot be greater than 1800
+      */
+     WALK_TO_STATION_TOO_HIGH = 20 [deprecated = true];
+
+     /*
+      * Drive to station penalty must be > 0
+      */
+     DRIVE_TO_STATION_MUST_BE_POSITIVE = 21 [deprecated = true];
+
+     /*
+      * Drive to station limit cannot be greater than the global travel time
+      * limit for the journey.
+      */
+     DRIVE_TO_STATION_OVER_TRAVEL_TIME_LIMIT = 22 [deprecated = true];
+
+     /*
+      * Drive to station limit cannot be greater than the global travel time
+      * limit for the journey.
+      */
+     DRIVE_TO_STATION_TOO_HIGH = 23 [deprecated = true];
+
+     /*
+      * Transportation details do not match mode. See
+      * * RequestsCommon.PublicTransportDetails 
+      * * RequestsCommon.DrivingAndPublicTransportDetails
+      */
+     TRANSPORTATION_DETAILS_MISMATCH = 24 [deprecated = true];
   }
 
   Error error = 1 [deprecated = true];

data/lib/travel_time/response.rb

@@ -15,12 +15,13 @@ module TravelTime
       )
     end
 
-    def self.from_object_proto(response)
-      new(
-        status: response.status,
-        headers: response.headers,
-        body: response.success? ? ProtoUtils.decode_proto_response(response.body) : proto_error(response.headers)
-      )
+    def self.from_object_proto(response, decoder: nil)
+      body = if response.success?
+               decoder ? decoder.call(response.body) : ProtoUtils.decode_proto_response(response.body)
+             else
+               proto_error(response.headers)
+             end
+      new(status: response.status, headers: response.headers, body: body)
     end
 
     def self.from_hash(response)

data/lib/travel_time/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TravelTime
-  VERSION = '0.9.1'
+  VERSION = '0.10.0'
 end

data/lib/travel_time.rb

@@ -1,11 +1,6 @@
 # frozen_string_literal: true
 
 require 'dry/configurable'
-require 'travel_time/client'
-require 'travel_time/error'
-require 'travel_time/response'
-require 'travel_time/version'
-require 'utils'
 
 # Main TravelTime module
 module TravelTime
@@ -20,3 +15,9 @@ module TravelTime
   setting :enable_logging, default: false
   setting :raise_on_failure, default: false
 end
+
+require 'travel_time/client'
+require 'travel_time/error'
+require 'travel_time/response'
+require 'travel_time/version'
+require 'utils'

data/lib/utils.rb

@@ -3,6 +3,10 @@
 require 'RequestsCommon_pb'
 require 'TimeFilterFastRequest_pb'
 require 'TimeFilterFastResponse_pb'
+require 'GeohashFastRequest_pb'
+require 'GeohashFastResponse_pb'
+require 'H3FastRequest_pb'
+require 'H3FastResponse_pb'
 
 module TravelTime
   # Utilities for encoding/decoding protobuf requests
@@ -68,8 +72,55 @@ module TravelTime
       Com::Igeolise::Traveltime::Rabbitmq::Requests::TimeFilterFastRequest.encode(message)
     end
 
+    def self.make_cell_search(search_klass, transport_obj, traveltime, options)
+      search = search_klass.new(
+        transportation: make_transportation(transport_obj),
+        arrivalTimePeriod: 0,
+        travelTime: traveltime,
+        resolution: options[:resolution],
+        properties: cell_properties(options[:properties])
+      )
+      search.removeWaterBodies = options[:remove_water_bodies] unless options[:remove_water_bodies].nil?
+      search
+    end
+
+    def self.make_transportation(transport_obj)
+      transportation = Com::Igeolise::Traveltime::Rabbitmq::Requests::Transportation.new
+      transport_obj.apply_to_proto(transportation)
+      transportation
+    end
+
+    def self.cell_properties(properties)
+      properties&.map { |property| property.to_s.upcase.to_sym }
+    end
+
+    def self.cell_search_klass(request_klass, request_type)
+      case request_type
+      when ONE_TO_MANY then request_klass::OneToMany
+      when MANY_TO_ONE then request_klass::ManyToOne
+      else raise ArgumentError, "Invalid request_type: #{request_type}. Must be ONE_TO_MANY or MANY_TO_ONE"
+      end
+    end
+
+    def self.make_cell_proto_message(request_klass, origin, transport_obj, traveltime, options)
+      request_type = options[:request_type] || ONE_TO_MANY
+      search = make_cell_search(cell_search_klass(request_klass, request_type), transport_obj, traveltime, options)
+      location = Com::Igeolise::Traveltime::Rabbitmq::Requests::Coords.new(origin)
+      if request_type == ONE_TO_MANY
+        search.departureLocation = location
+        request_klass.new(oneToManyRequest: search)
+      else
+        search.arrivalLocation = location
+        request_klass.new(manyToOneRequest: search)
+      end
+    end
+
     def self.decode_proto_response(response)
       Com::Igeolise::Traveltime::Rabbitmq::Responses::TimeFilterFastResponse.decode(response).to_h
     end
+
+    def self.cell_response_decoder(response_klass)
+      ->(response) { response_klass.decode(response).to_h }
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: travel_time
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.10.0
 platform: ruby
 authors:
 - TravelTime Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-24 00:00:00.000000000 Z
+date: 2026-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -105,6 +105,10 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- lib/GeohashFastRequest_pb.rb
+- lib/GeohashFastResponse_pb.rb
+- lib/H3FastRequest_pb.rb
+- lib/H3FastResponse_pb.rb
 - lib/RequestsCommon_pb.rb
 - lib/TimeFilterFastRequest_pb.rb
 - lib/TimeFilterFastResponse_pb.rb
@@ -113,6 +117,10 @@ files:
 - lib/travel_time/error.rb
 - lib/travel_time/middleware/authentication.rb
 - lib/travel_time/middleware/proto.rb
+- lib/travel_time/proto/source/GeohashFastRequest.proto
+- lib/travel_time/proto/source/GeohashFastResponse.proto
+- lib/travel_time/proto/source/H3FastRequest.proto
+- lib/travel_time/proto/source/H3FastResponse.proto
 - lib/travel_time/proto/source/RequestsCommon.proto
 - lib/travel_time/proto/source/TimeFilterFastRequest.proto
 - lib/travel_time/proto/source/TimeFilterFastResponse.proto