Zum Hauptinhalt springen

Transitous Departures Smart-Home-Integration, kostenlos und Open Source

Transitous Departures-Integration für Gladys Assistant

Abfahrten in der Nähe im Gladys-Dashboard, bereitgestellt von Transitous.

Info

Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.

You need:​

Gladys Assistent > Version 5.2

External Integration Transitous Depatures

Internet Access for Your Gladys Assistant Installation

You get:​

You'll receive an external integration for Galdys Assistant. This integration automatically displays the next 6 public transportation departures in a clear, easy-to-read widget—from buses to trains, ferries, and cable cars. All of this within a configurable radius around your home.

Example:

Testergebnisse – Beispielansicht der Transitous-Integration

Result: For each of the six tiles, the nearest stop is first determined once. That is, the nearest bus stop, nearest ferry, and nearest rail stop. The next departure from that stop is then displayed. This means: If there is only one stop within your search radius, you will see the next six departures. If multiple stops are found, they are displayed using color coding.

Configuration​

  1. Install the external integration either through Gladys Assistant (recommended) or in Gladys Assistant with direct access to GitHub.

  2. After Installation check that Integration is running.

  3. Open your Dashboard and go into Edit Modus and there add the new Widget. Select this Integration Widget.

  4. When adding the widget to your dashboard, you’ll need some information:

a.) Your geolocation as the starting point (or choose location from Gladys Assistant)

5.) The diameter of the search radius.

6.) The refresh interval in 10-minute increments.

7.) A unique identifier for API access at https://transitous.org/. This identifier must be unique—for example, an email address or website. It is stored by the integration only in the configuration field there. The integration neither retrieves nor documents this identifier. Everything remains with you. Transitous.org uses this identifier to manage the load on its IT infrastructure. Keep in mind the data provider when setting this. We recommend 30 minutes.

  1. After filling out this information, save it and place the widget where you want it.

Specifically: Either select your Galdys house or enter a geolocation of your choice. Below that, you can define three search radii in metres. This means that bus stops will be searched for within these radii. The individual radii are added together. If radius 1 is set to 300 metres and you enter 200 metres for radius 2, then radius 2 will have a search radius of 500 metres:

Konfiguration – Beispielansicht der Transitous-Integration

In the lower section, you can then choose to reschedule the time display. The time currently shown is the time today when Gladys Assistant starts. Using the drop-down menu, you can reschedule the display by the number of days you wish; for example, 14:00 plus 1 day = tomorrow at 14:00. The time is always based on when the application starts. They then set the interval at which the new departure times are retrieved. In consideration of the provider, Transitous, we ask that you do not set this to less than 30 minutes. Finally, Transitous asks for a ‘connoisseur’; we do not store this (except in the configuration field) and do not use it. It is used exclusively by Transitous:

Konfiguration – Beispielansicht der Transitous-Integration

Operation​

In the top image, you will see a button. This displays the three search areas you have selected, and with each click you move up and then down through these search areas.

The results are initially displayed in the top six tiles. These show: an icon representing the mode of transport (bus, train, aeroplane, ferry, etc.). Below that, the departure time and the destination station.

Each mode of transport has its own colour. Special transport services such as ferries, cable cars, as well as call-a-taxi and Moonliner services, are shown in grey. Cancelled or disrupted journeys are shown in red.

At the bottom of the screen, you will see a list of the stops found. These initially show the stop name, followed by the route number (also colour-coded), the distance from your current location and, where available, the type of vehicle.

Troubleshooting​

The integration logs everything it does: check the integration logs from the Gladys UI (or docker logs on the host) with LOG_LEVEL=debug for the full detail.

Konfigurationseinstellungen​

Diese Einstellungen fragt Transitous Departures in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Hinweis zur EinrichtungsectionNeinBitte legen Sie vor dem Hinzufügen des Widgets zum Dashboard die Koordinaten Ihres gewünschten Standorts fest. Benötigt werden Breitengrad und Längengrad im Dezimalformat, zum Beispiel 49.350 und 8.690. Beim Hinzufügen des Widgets stellen Sie anschließend Suchradius, Anzahl der Abfahrten und Aktualisierungsintervall ein. Der Standard-Suchradius beträgt 2.000 Meter. Fahrplandaten: Transitous. Informationen zu Datenquellen und Quellenangaben: https://transitous.org/sources/

So installierst du Transitous Departures in Gladys​

  1. Öffne in Gladys Integrationen: Transitous Departures erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/tomgermany/gladys-transitous-departures:3.3.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/tomgermany/gladys-transitous-departures.

Transitous Departures benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Transitous Departures ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von tomgermany veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂