Compare travel times obtained from TravelTime API and Google Maps API
Project description
TravelTime/Google comparison tool
This tool compares the travel times obtained from TravelTime Routes API, Google Maps Directions API, TomTom Routing API, HERE Routing API, Mapbox Directions API, OpenRoutes API, and OSRM Routes API. Source code is available on GitHub.
Features
- Get travel times from TravelTime API, Google Maps API, TomTom API, HERE API, Mapbox API and OSRM API in parallel, for provided origin/destination pairs and a set of departure times.
- Departure times are calculated based on user provided start time, end time and interval.
- Analyze the differences between the results and print out the average error percentage.
Prerequisites
The tool requires Python 3.8+ installed on your system. You can download it from here.
Installation
Create a new virtual environment with a chosen name (here, we'll name it 'env'):
python -m venv env
Activate the virtual environment:
source env/bin/activate
Install the project and its dependencies:
pip install traveltime-google-comparison
Setup
Provide credentials and desired max requests per minute for the APIs inside the config.json
file.
You can also disable unwanted APIs by changing the enabled
value to false
.
{
"traveltime": {
"app-id": "<your-app-id>",
"api-key": "<your-api-key>",
"max-rpm": "60"
},
"api-providers": [
{
"name": "google",
"enabled": true,
"api-key": "<your-api-key>",
"max-rpm": "60"
},
...other providers
]
}
Usage
Run the tool:
traveltime_google_comparison --input [Input CSV file path] --output [Output CSV file path] \
--date [Date (YYYY-MM-DD)] --start-time [Start time (HH:MM)] --end-time [End time (HH:MM)] \
--interval [Interval in minutes] --time-zone-id [Time zone ID]
Required arguments:
--input [Input CSV file path]
: Path to the input file. Input file is required to have a header row and at least one row with data, with two columns:origin
anddestination
. The values in the columns must be latitude and longitude pairs, separated by comma and enclosed in double quotes. For example:"51.5074,-0.1278"
. Columns must be separated by comma as well. Check out the project's repository for examples in theexamples
directory and more pre-prepared routes in theinputs
directory.--output [Output CSV file path]
: Path to the output file. It will contain the gathered travel times. See the details in the Output section--date [Date (YYYY-MM-DD)]
: date on which the travel times are gathered. Use a future date, as Google API returns errors for past dates (and times). Take into account the time needed to collect the data for provided input.--start-time [Start time (HH:MM)]
: start time inHH:MM
format, used for calculation of departure times. See Calculating departure times--end-time [End time (HH:MM)]
: end time inHH:MM
format, used for calculation of departure times. See Calculating departure times--interval [Interval in minutes]
: interval in minutes, used for calculation of departure times. See Calculating departure times--time-zone-id [Time zone ID]
: non-abbreviated time zone identifier in which the time values are specified. For example:Europe/London
. For more information, see here.
Optional arguments:
--config [Config file path]
: Path to the config file. Default - ./config.json
Example:
traveltime_google_comparison --input examples/uk.csv --output output.csv --date 2023-09-20 \
--start-time 07:00 --end-time 20:00 --interval 180 --time-zone-id "Europe/London"
Calculating departure times
Script will collect travel times on the given day for departure times between provided start-time and end-time, with the given interval. The start-time and end-time are in principle inclusive, however if the time window is not exactly divisible by the given interval, the end-time will not be included. For example, if you set the start-time to 08:00, end-time to 20:00 and interval to 240, the script will sample both APIs for departure times 08:00, 12:00, 16:00 and 20:00 (end-time included). But for interval equal to 300, the script will sample APIs for departure times 08:00, 13:00 and 18:00 (end-time is not included).
Output
The output file will contain the origin
and destination
columns from input file, with additional 4 columns:
departure_time
: departure time inYYYY-MM-DD HH:MM:SS±HHMM
format, calculated from the start-time, end-time and interval. It includes date, time and timezone offset.google_travel_time
: travel time gathered from Google Directions API in secondstt_travel_time
: travel time gathered from TravelTime API in secondserror_percentage_*
: relative error between provider and TravelTime travel times in percent, relative to provider result.
Sample output
origin,destination,departure_time,google_travel_time,tomtom_travel_time,here_travel_time,osrm_travel_time,openroutes_travel_time,mapbox_travel_time,tt_travel_time,error_percentage_google,error_percentage_tomtom,error_percentage_here,error_percentage_mapbox,error_percentage_osrm,error_percentage_openroutes
"52.200400622501455, 0.1082577055247136","52.21614536733819, 0.15782831362961777",2024-09-25 07:00:00+0100,621.0,805.0,614.0,532.0,697.0,1018.0,956.0,53,18,55,6,79,37
License
This project is licensed under MIT License. For more details, see the LICENSE file.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for traveltime_google_comparison-1.1.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 92e5887911f79e90b7ba63c8ae85ce1622efcf2d4c1f1b4b2b54be0025c97b7d |
|
MD5 | 6eabb9168c272554f002323b606997a7 |
|
BLAKE2b-256 | 74747cfe1e2abc452b010d101f36e83033bc46fa38ba788c131483e9a25e1d28 |
Hashes for traveltime_google_comparison-1.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 268c9c8907819813f968b292fc64c2124a40b96c2e81f767bcdea9e8d2fb6d80 |
|
MD5 | 6c429686ebcde5de34cf303251dd0392 |
|
BLAKE2b-256 | 777a973c81ffcf2b1299966d19bc1eb538a40e934b43081bf81a61acc363e3a5 |