Skip to main content

A module for interacting with the Deutsche Bahn onboard APIs

Project description

iceportal_apis


No longer actively developed in favor of the onboardAPIs (PyPI) project which includes APIs for different providers.


PyPI version PyPI-Versions GitHub

Description

This module interacts with the onboard APIs of the Deutsche Bahn ICE trains.
It can do various things from reading the trains' velocity to telling you the distance to and the delay at the next station.
This is an unofficial project and not supported by Deutsche Bahn AG.

Note, that this module will only work correctly while you are on a train and connected to its WiFi-Hotspot.

Installation

  • Available on PyPI
    $ python -m pip install iceportal_apis
    

Usage

import iceportal_apis as ipa

train = ipa.Train()

while True:
    # Request new data from the api
    # train.refresh()  # obsolete, because onboardapis handles refreshing
    
    # Process data  (uses onboardapis under the hood)
    print(train.get_train_type().name)
    next_station = train.get_next_station()

    . . .

License

This software is distributed under the MIT License, please see LICENSE for detailed information.

API documentation

1. Status API

The Status API is available at https://iceportal.de/api1/rs/status

2. Trip API

The Trip API is available at https://iceportal.de/api1/rs/tripInfo/trip

3. Connections API

The Connecting trains API can be found at https://iceportal.de/api1/rs/tripInfo/connection/{eva_number}

4. Other APIs

These are other APIs I discovered but didn't investigate in:

4.1. https://iceportal.de/api1/rs/pois/map/{lat_s}/{lon_s}/{lat_e}/{lon_e}

4.2. https://iceportal.de/api1/rs/configs

4.3. https://iceportal.de/api1/rs/configs/cities

4.4. https://iceportal.de/bap/api/availabilities

4.5. https://iceportal.de/bap/api/bap-service-status

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

iceportal_apis-2.0.3.tar.gz (7.0 kB view details)

Uploaded Source

Built Distribution

iceportal_apis-2.0.3-py3-none-any.whl (7.6 kB view details)

Uploaded Python 3

File details

Details for the file iceportal_apis-2.0.3.tar.gz.

File metadata

  • Download URL: iceportal_apis-2.0.3.tar.gz
  • Upload date:
  • Size: 7.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for iceportal_apis-2.0.3.tar.gz
Algorithm Hash digest
SHA256 e9f6a12218d9a97604ef9587371de92018cf00dafed4c108376a949db168dd7f
MD5 194959284426a05206bf27020978a296
BLAKE2b-256 b0f9b9d296310e11eeaee168c518ebb9e09ab1f2cbcd3034d3b0fb50a6d9f90c

See more details on using hashes here.

File details

Details for the file iceportal_apis-2.0.3-py3-none-any.whl.

File metadata

File hashes

Hashes for iceportal_apis-2.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 3c1a1fe96568849b5b481c631ddf6a63c9f7c0a1681d08368bf7fae3ddb5a7c0
MD5 f5f698538db94a92c5417d3004d7287e
BLAKE2b-256 f97494346f05468b2bef093c15c69d794620e7515038a36682c1ef925c16b9e6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page