collect and analyze flexible/roaming carshare use data
Python HTML JavaScript Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
doc
electric2go
scripts
web
.gitignore
README.md
requirements-download.txt
requirements-web.txt
requirements.txt
tests.py

README.md

electric2go

Collect and analyze data on roaming one-way carshare use.

The project started out as a way to find nearest electric car2go vehicles, hence the name. I've since added caching the data, archiving it, and processing to make visualizations and collect statistics.

There is now good support for other carshare systems, and as of December 2015 we can handle Drivenow, Montréal's Communauto Automobile, Vancouver's Evo, Italy's Enjoy, Milan's Sharengo, and Berlin's floating Multicity.

Requirements

Known to work under Python 3.4.2 and 2.7.8. Scripts invoked from the command line specify #!/usr/bin/env python3.

PyPI dependencies for whole project are in requirements.txt, for data archiver (run headless on a server) in requirements-download.txt, for web interface in requirements-web.txt.

Web interface: finding electric cars

Simple web page listing currently available electric carshare vehicles in a number of cities where a system has both internal-combustion and electric vehicles available. A basic JSON API is also available.

View it live at http://bin.piorkowski.ca/electric2go/

See doc/web.md for more information.

Analyzing data

A carshare's data can be downloaded automatically and archived. An archive can be then analyzed to get usage statistics and generate visualizations.

See doc/analysis.md for more information.

Multisystem operation

Supported carshare systems are defined in packages in the electric2go/systems/ directory.

A system definition consists of a dictionary of cities a system supports and a "parser" that converts the system's API output to a standard format.

More systems can be added fairly easily. See doc/systems.md for more information.

If you add a new system, patches or pull requests are most welcome.

Similar projects

Legal stuff

This product uses the car2go API but is not endorsed or certified by car2go.

Released under the ISC license. Boilerplate:

Copyright (c) 2012-2015, Jarek Piórkowski jarek@piorkowski.ca

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

The software is provided "as is" and the author disclaims all warranties with regard to this software including all implied warranties of merchantability and fitness. In no event shall the author be liable for any special, direct, indirect, or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software.