A simple tool for periodically collecting Uber fares.
Project description
This is a simple wrapper to the official Uber Python SDK intended to collect data from a given origin and destination at a specified time interval.
The current implementation only handles the price estimate feature since it doesn’t need OAuth 2.0 access.
Motivation
I’m using this tool in order to gather data and then evaluate when’s the best time to leave the house and book an Uber ride to work, and vice-versa.
Requirements
Python 3.4+
Installation
I’d recommend installing it via pipenv:
$ pipenv install uberfare
$ # or via the usual pip
$ pip3 install uberfare
API Key
Get your Server Token API Key by creating an app at: developer.uber.com/dashboard, and then:
Create or Select an app
Copy the Server Token value in the Auth page
Before using this package, export your Server Token as: export UBER_SERVER_TOKEN=<Server Token>. You can however, override this when using the CLI (see below).
Usage
You have to determine the (latitude,longitude) of your location, since the types of rides available will depend on it.
The best way to get the coordinates is going to maps.google.com and then clicking any point in the map. A small box will then appear at the bottom-center of your screen containing the Longitude and Latitude. Take note of the coordinates for both your origin and destination:
CLI
>>> # To get the fare estimate, provide the arguments: <origin>, <destination>
>>> # (Where origin and destination are in the <LATITUDE,LONGITUDE> format)
>>> uberfare estimate 14.55,121.05 14.52,121.01
>>> # To save all the RAW data in a CSV file, you can do:
>>> uberfare estimate 14.55,121.05 14.52,121.01 --output-file output.csv
>>> # You can also periodically fetch the Uber fares by using the
>>> # --check-interval <time in seconds> flag (short -ci):
>>> uberfare --check-interval 120 estimate 14.55,121.05 14.52,121.01
>>> uberfare -ci 120 estimate 14.55,121.05 14.52,121.01
>>> # To safely save the data in long periods of time, do:
>>> uberfare --check-interval 120 estimate 14.55,121.05 14.52,121.01 --output-file output.csv
>>> # You can override the '$UBER_SERVER_TOKEN' env variable right in the CLI via:
>>> uberfare --server_token <SERVER API KEY> estimate 14.55,121.05 14.52,121.01
>>> uberfare -st <SERVER API KEY> estimate 14.55,121.05 14.52,121.01
Notes
Be careful when specifying a very short time interval for checking the price since you might be rate limited.
Future Releases
Better interface for importing as a package
Option to use address instead of coordinates (use Google Maps Geocoding API)
Support the Upfront Fare data collection by enabling the OAUTH2.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file uberfare-0.1.0.tar.gz
.
File metadata
- Download URL: uberfare-0.1.0.tar.gz
- Upload date:
- Size: 7.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a4b39b6daa3585a349ea0db76d1cec4f05eeff16734fecae63dc6b88a5fc04cd |
|
MD5 | e062938343632d79576c5145d508b10c |
|
BLAKE2b-256 | 5f8692fa26a256ec1d02bba7e3418344a93d343f77458f315a18395c7dd09498 |