travel_time 0.4.0 → 0.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e026fa4d97a7a6ed15e6255dd221b1acadaf83d77be1bee06c0d7705c7f556ca
-  data.tar.gz: 57f80869aee09e159742b516e0e16c6757c5c30d86dede1fa2d1bda4811f5b97
+  metadata.gz: 479666f568d16431cf279ead2c1bf61c7f8e1f29596970afbd255750bf808f12
+  data.tar.gz: 0a83062eebe1621bb576ca3629e35f13c42f4e4ce0145f08d42ff12cce78e224
 SHA512:
-  metadata.gz: 8352d34e44966cbf59256900792bfb5e3dbe4060bffcacc6a57bc3c653312ae6fdec78ed3541ff8887889c4c78dbc3907b6b52b067cf4206a9b6f7ca398dc41e
-  data.tar.gz: e87883a54e9e2b2585db76cebbddaf2496a1b516c4f2b29c9b39d3ad89daac83cb9617ec9b73ccb86068f2f4b28fcce9efdc2e2266f9712f2d8e8f6613355101
+  metadata.gz: 587e2360688195fa2caebf53530bd6c8ca0969e757c1f9c9c071903c7ef8f0106f7225915c9e1c0a8c947fbc6d40ac291f30ad1862ed52b8adf5b200cc36c349
+  data.tar.gz: 1893e32110aeda9fbea6bec890d59b5f0c3ffeacd38bb9a0bb6668894761a3dce2d9a651b3f8f6afb88e9202bb10ed460518a31004e4c3dca618e7b1fe0a0ada

data/README.md

@@ -3,9 +3,7 @@
 [![Gem Version](https://badge.fury.io/rb/travel_time.svg)](https://rubygems.org/gems/travel_time)
 [![GitHub Actions CI](https://github.com/traveltime-dev/traveltime-sdk-ruby/workflows/CI/badge.svg)](https://github.com/traveltime-dev/traveltime-sdk-ruby/actions?query=workflow%3ACI)
 
-
-This open-source library allows you to access [TravelTime API](https://docs.traveltime.com/overview/introduction)
-endpoints.
+[Travel Time](https://docs.traveltime.com/api/overview/introduction) Ruby SDK helps users find locations by journey time rather than using ‘as the crow flies’ distance. Time-based searching gives users more opportunities for personalisation and delivers a more relevant search.
 
 ## Installation
 
@@ -30,7 +28,7 @@ In order to be able to call the API, you'll first need to set your Application I
 ```ruby
 TravelTime.configure do |config|
   config.application_id = '<your app id>'
-  config.api_key = '<your api key>'
+  config.api_key = '<your app key>'
 end
 ```
 
@@ -70,11 +68,16 @@ departure_search = {
 client.time_map(departure_searches: [departure_search])
 ```
 
-
 ### [Isochrones (Time Map)](https://traveltime.com/docs/api/reference/isochrones)
 Given origin coordinates, find shapes of zones reachable within corresponding travel time.
 Find unions/intersections between different searches.
 
+Body attributes:
+* departure_searches: Searches based on departure times. Leave departure location at no earlier than given time. You can define a maximum of 10 searches.
+* arrival_searches: Searches based on arrival times. Arrive at destination location at no later than given time. You can define a maximum of 10 searches.
+* unions: Define unions of shapes that are results of previously defined searches.
+* intersections: Define intersections of shapes that are results of previously defined searches.
+
 ```ruby
 require 'time'
 
@@ -120,10 +123,41 @@ response = client.time_map(
 puts response.body
 ```
 
+### [Isochrones (Time Map) Fast](https://docs.traveltime.com/api/reference/isochrones-fast)
+A very fast version of Isochrone API. However, the request parameters are much more limited.
+
+```ruby
+require 'time'
+
+arrival_search = {
+  id: "public transport to Trafalgar Square",
+  coords: {
+    lat: 51.506756,
+    lng: -0.128050
+  },
+  transportation: { type: "public_transport" },
+  arrival_time_period: 'weekday_morning',
+  travel_time: 1800,
+}
+
+response = client.time_map_fast(
+  arrival_searches: {
+    one_to_many: [arrival_search]
+  },
+)
+
+puts response.body
+```
+
 ### [Distance Matrix (Time Filter)](https://traveltime.com/docs/api/reference/distance-matrix)
 Given origin and destination points filter out points that cannot be reached within specified time limit.
 Find out travel times, distances and costs between an origin and up to 2,000 destination points.
 
+Body attributes:
+* locations: Locations to use. Each location requires an id and lat/lng values
+* departure_searches: Searches based on departure times. Leave departure location at no earlier than given time. You can define a maximum of 10 searches
+* arrival_searches: Searches based on arrival times. Arrive at destination location at no later than given time. You can define a maximum of 10 searches
+
 ```ruby
 require 'time'
 
@@ -184,6 +218,11 @@ puts response.body
 ### [Routes](https://traveltime.com/docs/api/reference/routes)
 Returns routing information between source and destinations.
 
+Body attributes:
+* locations: Locations to use. Each location requires an id and lat/lng values.
+* departure_searches: Searches based on departure times. Leave departure location at no earlier than given time. You can define a maximum of 10 searches.
+* arrival_searches: Searches based on arrival times. Arrive at destination location at no later than given time. You can define a maximum of 10 searches.
+
 ```ruby
 require 'time'
 
@@ -248,7 +287,7 @@ puts response.body
 ```
 
 ### [Time Filter (Fast)](https://traveltime.com/docs/api/reference/time-filter-fast)
-A very fast version of time_filter().
+A very fast version of `time_filter()`.
 However, the request parameters are much more limited.
 Currently only supports UK and Ireland.
 
@@ -310,7 +349,7 @@ response = client.time_filter_fast(
 puts response.body
 ```
 
-### [Time Filter (Fast) Proto](https://docs.traveltime.com/api/reference/travel-time-distance-matrix-proto)
+### [Time Filter Fast (Proto)](https://docs.traveltime.com/api/reference/travel-time-distance-matrix-proto)
 A fast version of time filter communicating using [protocol buffers](https://github.com/protocolbuffers/protobuf).
 
 The request parameters are much more limited and only travel time is returned. In addition, the results are only approximately correct (95% of the results are guaranteed to be within 5% of the routes returned by regular time filter).
@@ -320,9 +359,9 @@ This inflexibility comes with a benefit of faster response times (Over 5x faster
 Body attributes:
 * origin: Origin point.
 * destinations: Destination points. Cannot be more than 200,000.
+* country: Return the results that are within the specified country.
 * transport: Transportation type.
-* travelTime: Time limit;
-* country: Return the results that are within the specified country
+* traveltime: Time limit.
 
 ```ruby
 origin = {
@@ -345,39 +384,7 @@ response = client.time_filter_fast_proto(
 puts(response.body)
 ```
 
-### Time Filter (Fast) Proto Distance
-A version of `Time Filter (Fast) Proto` endpoint that also returns distance information. Request parameters are even more limited than `Time Filter (Fast) Proto`.
-
-This endpoint is not enabled by default, please [contact us](https://traveltime.com/contact-us) if you wish to obtain access. 
-
-Body attributes:
-* origin: Origin point.
-* destinations: Destination points. Cannot be more than 200,000.
-* transport: Transportation type.
-* travelTime: Time limit;
-* country: Return the results that are within the specified country
-
-```ruby
-origin = {
-  lat: 51.508930,
-  lng: -0.131387,
-}
-
-destinations = [{
-  lat: 51.508824,
-  lng: -0.167093,
-}]
-
-response = client.time_filter_fast_proto_distance(
-  country: 'UK',
-  origin: origin,
-  destinations: destinations,
-  transport: 'driving+ferry',
-  traveltime: 7200
-)
-puts(response.body)
-```
-
+The responses are in the form of a list where each position denotes either a travel time (in seconds) of a journey, or if negative that the journey from the origin to the destination point is impossible.
 
 ### [Time Filter (Postcode Districts)](https://traveltime.com/docs/api/reference/postcode-district-filter)
 Find districts that have a certain coverage from origin (or to destination) and get statistics about postcodes within such districts.

data/lib/travel_time/client.rb

@@ -66,27 +66,25 @@ module TravelTime
     end
 
     def geocoding(query:, within_country: nil, format_name: nil, exclude: nil, limit: nil, force_postcode: nil,
-                  bounds: nil)
+                  bounds: nil, accept_language: nil)
       query = {
         query: query,
-        'within.country': within_country,
+        'within.country': within_country.is_a?(Array) ? within_country.join(',') : within_country,
         'format.name': format_name,
         'format.exclude.country': exclude,
         limit: limit,
         'force.add.postcode': force_postcode,
-        bounds: bounds ? bounds.join(',') : nil
+        bounds: bounds&.join(',')
       }.compact
-      perform_request { connection.get('geocoding/search', query) }
+      perform_request { connection.get('geocoding/search', query, { 'Accept-Language' => accept_language }) }
     end
 
-    def reverse_geocoding(lat:, lng:, within_country: nil, exclude: nil)
+    def reverse_geocoding(lat:, lng:, accept_language: nil)
       query = {
         lat: lat,
-        lng: lng,
-        'within.country': within_country,
-        'exclude.location.types': exclude
+        lng: lng
       }.compact
-      perform_request { connection.get('geocoding/reverse', query) }
+      perform_request { connection.get('geocoding/reverse', query, { 'Accept-Language' => accept_language }) }
     end
 
     def time_map(departure_searches: nil, arrival_searches: nil, unions: nil, intersections: nil, format: nil)
@@ -99,6 +97,13 @@ module TravelTime
       perform_request { connection.post('time-map', payload, { 'Accept' => format }) }
     end
 
+    def time_map_fast(arrival_searches:, format: nil)
+      payload = {
+        arrival_searches: arrival_searches
+      }.compact
+      perform_request { connection.post('time-map/fast', payload, { 'Accept' => format }) }
+    end
+
     def time_filter(locations:, departure_searches: nil, arrival_searches: nil)
       payload = {
         locations: locations,

data/lib/travel_time/middleware/authentication.rb

@@ -9,10 +9,12 @@ module TravelTime
     class Authentication < Faraday::Middleware
       APP_ID_HEADER = 'X-Application-Id'
       API_KEY_HEADER = 'X-Api-Key'
+      USER_AGENT = 'User-Agent'
 
       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[USER_AGENT] = 'Travel Time Ruby SDK'
       end
     end
   end

data/lib/travel_time/middleware/proto.rb

@@ -13,6 +13,7 @@ module TravelTime
           "Basic #{Base64.encode64("#{TravelTime.config.application_id}:#{TravelTime.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'
       end
     end
   end

data/lib/travel_time/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: travel_time
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.4
 platform: ruby
 authors:
 - TravelTime Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-11-07 00:00:00.000000000 Z
+date: 2023-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-configurable