ebike-connect

Python library to get rides and trips from the Bosch eBike Connect platform.

Installation

The package is available on PyPI. Installation can be done with your favourite package manager. For example:

pip install ebike-connect

Usage

Initialize a client with your username and password:

from ebikeconnect.client import EBikeConnectClient


client = EBikeConnectClient.login("username", "password")

The eBike Connect api provides rides and trips, where a ride is a single uninterrupted ride, and a trip is a collection of rides (all rides on a single day?).

Rides and trips can be listed with the following methods:

def find_rides(
    self, from_datetime: datetime | None = None, to_datetime: datetime | None = None
) -> Iterable[EBikeConnectRide]

This returns an iterable of EBikeConnectRide dataclasses, which have the following fields:

    id: str
    start_time: datetime
    end_time: datetime
    driving_time: timedelta
    type: str
    status: int
    total_distance: float
    title: str
    calories: float
    avg_speed: float
    max_speed: float

def find_trips(
    self, from_datetime: datetime | None = None, to_datetime: datetime | None = None
) -> Iterable[EBikeConnectTrip]:

This returns an iterable of EBikeConnectTrip dataclasses, which have the following fields:

    id: str
    start_time: datetime
    end_time: datetime
    driving_time: timedelta
    type: str
    status: int
    total_distance: float
    ride_ids: list[str]

In addition, ride details (with many additional fields) can be obtained by calling:

def get_ride(self, id: str) -> EBikeConnectRideDetails