travel_time 0.5.7 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7a2b13991042791d77578dc894e869564b289137381fc5c8b319fd37efb2b11
-  data.tar.gz: 587fac0cd53502b30c3834c7320e9b66dce1589dcb3d8757e8f0f1c7356ef920
+  metadata.gz: af716d7c4c1267d934bb7c5800e3c0e4b87e58d6ec58d5ecdc4a9fa86b8be88d
+  data.tar.gz: 472cbf1e167a1dba7f776f7729a47de3f1648267836ccd23fd04ff34b13fc491
 SHA512:
-  metadata.gz: 5cd13c389968b3b96684d9f36002dcc783f23c01cc90968af58e3ffb671dfb1ea6eed776e60cc7791bb15d78005753b5bc6fb5fa0574f58c0f6b92aa14157949
-  data.tar.gz: 6720fd0d83332a628d44743381c27c3d63f981c46f667fa228ca1fbb4ae015a84d127627a0acf91d76742d850c8794532fe0fae07e0cfc29ad2ff2c7adc10c45
+  metadata.gz: 32e49cd7b6fc8fefd2fb84ad7b30dbf8c67d323548d9c4904263b3a6a1b51b0de60af27f73edd4d1b8ab910664225be4884817d93a7a7ed6bfc9e690a2c2a54d
+  data.tar.gz: 46394883839d6dfc3ec8893fce80d9abab8ba6dbed2329c595155fc719533ac120de7ecf5d1a22a815d4993c17152d51b437ec6c0cf43efca90c5f35e5acaf67

data/README.md

@@ -15,11 +15,15 @@ gem 'travel_time'
 
 And then execute:
 
-    $ bundle install
+```bash
+$ bundle install
+```
 
 Or install it yourself as:
 
-    $ gem install travel_time
+```bash
+$ gem install travel_time
+```
 
 ## Usage
 
@@ -27,8 +31,8 @@ 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 app key>'
+  config.application_id = 'YOUR_APP_ID'
+  config.api_key = 'YOUR_APP_KEY'
 end
 ```
 
@@ -76,7 +80,7 @@ You may specify an optional rate limit when initializing your client. The `rate_
 client = TravelTime::Client.new(rate_limit = 60)
 ```
 
-### [Isochrones (Time Map)](https://traveltime.com/docs/api/reference/isochrones)
+### [Isochrones (Time Map)](https://docs.traveltime.com/api/reference/isochrones)
 Given origin coordinates, find shapes of zones reachable within corresponding travel time.
 Find unions/intersections between different searches.
 
@@ -131,6 +135,62 @@ response = client.time_map(
 puts response.body
 ```
 
+### [Distance Map](https://docs.traveltime.com/api/reference/distance-map)
+Given origin coordinates, find shapes of zones reachable within corresponding travel distance.
+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'
+
+departure_search = {
+  id: "driving from Trafalgar Square",
+  coords: {
+    lat: 51.506756,
+    lng: -0.128050
+  },
+  transportation: { type: "driving" },
+  departure_time: Time.now.iso8601,
+  travel_distance: 1800,
+}
+
+arrival_search = {
+  id: "cycling to Trafalgar Square",
+  coords: {
+    lat: 51.506756,
+    lng: -0.128050
+  },
+  transportation: { type: "cycling" },
+  arrival_time: Time.now.iso8601,
+  travel_distance: 1800,
+  range: { enabled: true, width: 3600 }
+}
+
+union = {
+  id: 'union of driving and cycling',
+  search_ids: ['driving from Trafalgar Square', 'cycling to Trafalgar Square']
+}
+
+intersection = {
+  id: 'intersection of driving and cycling',
+  search_ids: ['driving from Trafalgar Square', 'cycling to Trafalgar Square']
+}
+
+response = client.distance_map(
+  departure_searches: [departure_search], 
+  arrival_searches: [arrival_search], 
+  unions: [union], 
+  intersections: [intersection]
+)
+
+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.
 
@@ -157,7 +217,7 @@ response = client.time_map_fast(
 puts response.body
 ```
 
-### [Distance Matrix (Time Filter)](https://traveltime.com/docs/api/reference/distance-matrix)
+### [Distance Matrix (Time Filter)](https://docs.traveltime.com/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.
 
@@ -223,10 +283,9 @@ response = client.time_filter(
 puts response.body
 ```
 
-### [Time Filter (Fast)](https://traveltime.com/docs/api/reference/time-filter-fast)
+### [Time Filter (Fast)](https://docs.traveltime.com/api/reference/time-filter-fast)
 A very fast version of `time_filter()`.
 However, the request parameters are much more limited.
-Currently only supports UK and Ireland.
 
 ```ruby
 locations = [
@@ -323,7 +382,7 @@ 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.
 
-### [Routes](https://traveltime.com/docs/api/reference/routes)
+### [Routes](https://docs.traveltime.com/api/reference/routes)
 Returns routing information between source and destinations.
 
 Body attributes:
@@ -394,7 +453,7 @@ response = client.routes(
 puts response.body
 ```
 
-### [Geocoding (Search)](https://traveltime.com/docs/api/reference/geocoding-search) 
+### [Geocoding (Search)](https://docs.traveltime.com/api/reference/geocoding-search) 
 Match a query string to geographic coordinates.
 
 ```ruby
@@ -402,7 +461,7 @@ response = client.geocoding(query: 'London', within_country: 'GB')
 puts response.body
 ```
 
-### [Reverse Geocoding](https://traveltime.com/docs/api/reference/geocoding-reverse)
+### [Reverse Geocoding](https://docs.traveltime.com/api/reference/geocoding-reverse)
 Attempt to match a latitude, longitude pair to an address.
 
 ```ruby
@@ -410,7 +469,7 @@ response = client.reverse_geocoding(lat: 51.506756, lng: -0.128050)
 puts response.body
 ```
 
-### [Time Filter (Postcodes)](https://traveltime.com/docs/api/reference/postcode-search)
+### [Time Filter (Postcodes)](https://docs.traveltime.com/api/reference/postcode-search)
 Find reachable postcodes from origin (or to destination) and get statistics about such postcodes.
 Currently only supports United Kingdom.
 
@@ -443,7 +502,7 @@ response = client.time_filter_postcodes(
 puts response.body
 ```
 
-### [Time Filter (Postcode Districts)](https://traveltime.com/docs/api/reference/postcode-district-filter)
+### [Time Filter (Postcode Districts)](https://docs.traveltime.com/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.
 Currently only supports United Kingdom.
 
@@ -478,7 +537,7 @@ response = client.time_filter_postcode_districts(
 puts response.body
 ```
 
-### [Time Filter (Postcode Sectors)](https://traveltime.com/docs/api/reference/postcode-sector-filter)
+### [Time Filter (Postcode Sectors)](https://docs.traveltime.com/api/reference/postcode-sector-filter)
 Find sectors that have a certain coverage from origin (or to destination) and get statistics about postcodes within such sectors.
 Currently only supports United Kingdom.
 
@@ -513,7 +572,7 @@ response = client.time_filter_postcode_sectors(
 puts response.body
 ```
 
-### [Map Info](https://traveltime.com/docs/api/reference/map-info)
+### [Map Info](https://docs.traveltime.com/api/reference/map-info)
 Get information about currently supported countries.
 
 ```ruby
@@ -521,7 +580,7 @@ response = client.map_info
 puts response.body
 ```
 
-### [Supported Locations](https://traveltime.com/docs/api/reference/supported-locations)
+### [Supported Locations](https://docs.traveltime.com/api/reference/supported-locations)
 Find out what points are supported by the api.
 
 ```ruby
@@ -561,14 +620,47 @@ puts response.body
 
 ## 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.
+### Set up Ruby Version Manager
+
+This is optional, but enables you not installing gems to system directories.
+
+1. Install RVM: https://rvm.io/
+2. Optional gnome-terminal integration: https://rvm.io/integration/gnome-terminal
+3. Install and set up Ruby with RVM:
+```shell
+rvm install ruby-3.2.2
+rvm alias create default ruby-3.2.2
+rvm use ruby-3.2.2
+rvm gemset create traveltime-sdk
+```
+
+### Start using RVM
+
+```shell
+rvm use default@traveltime-sdk
+```
+
+### Install dependencies
+
+Run `bin/setup` to install dependencies.
+
+### Run tests
+
+Run `rake spec` to run the tests.
+
+### Interactive prompt
+
+Run `bin/console` for an interactive prompt that will allow you to experiment.
+
+### Installing TravelTime gem
 
 To install this gem onto your local machine, run `bundle exec rake install`.
 
+### Release
+
 To release a new version, update the version number in `version.rb` and then create a GitHub release. This will trigger
 a GitHub Action which will push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/traveltime-dev/travel_time.
+Bug reports and pull requests are welcome on GitHub at https://github.com/traveltime-dev/traveltime-sdk-ruby.

data/lib/travel_time/client.rb

@@ -108,6 +108,16 @@ module TravelTime
       perform_request { connection.post('time-map', payload, { 'Accept' => format }) }
     end
 
+    def distance_map(departure_searches: nil, arrival_searches: nil, unions: nil, intersections: nil, format: nil)
+      payload = {
+        departure_searches: departure_searches,
+        arrival_searches: arrival_searches,
+        unions: unions,
+        intersections: intersections
+      }.compact
+      perform_request { connection.post('distance-map', payload, { 'Accept' => format }) }
+    end
+
     def time_map_fast(arrival_searches:, format: nil)
       payload = {
         arrival_searches: arrival_searches

data/lib/travel_time/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: travel_time
 version: !ruby/object:Gem::Version
-  version: 0.5.7
+  version: 0.6.1
 platform: ruby
 authors:
 - TravelTime Team
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-05-12 00:00:00.000000000 Z
+date: 2025-01-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-configurable
@@ -50,20 +50,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.21'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 3.21.9
+        version: 3.25.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.21'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 3.21.9
+        version: 3.25.5
 - !ruby/object:Gem::Dependency
   name: ruby-limiter
   requirement: !ruby/object:Gem::Requirement
@@ -112,7 +106,7 @@ metadata:
   homepage_uri: https://traveltime.com
   source_code_uri: https://github.com/traveltime-dev/traveltime-sdk-ruby
   changelog_uri: https://github.com/traveltime-dev/traveltime-sdk-ruby/releases
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -128,7 +122,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.1.6
-signing_key: 
+signing_key:
 specification_version: 4
 summary: TravelTime SDK for Ruby programming language
 test_files: []