Intégration domotique Entur, gratuite et open source

Prochains départs en Norvège (train, métro, tram, bus, ferry), retards, suppressions, perturbations.

• Publiée par guim31
• Appareils
• Version 1.0.0
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Les prochains départs de vos arrêts de transport en commun en Norvège dans Gladys : trains, métro, trams, bus, cars et ferries, avec retards, suppressions et messages de trafic, en temps réel.

Les données viennent d'Entur, le registre national de tous les opérateurs de transport public norvégiens (Vy, Ruter, Skyss, AtB, Kolumbus…), par ses API ouvertes : ni compte, ni clé. Cette intégration n'est pas affiliée à Entur.

Ce que vous obtenez

• Un appareil par arrêt suivi (filtré si vous le voulez par lignes, direction ou mode de transport) : prochain départ et départ suivant (minutes), retard du prochain départ (minutes), sa ligne et sa destination (texte), et si un message de trafic touche ses départs (oui/non).
• Un widget de tableau de bord avec les prochains départs d'un arrêt : heure, minutes, retard, départs supprimés en rouge, messages de trafic en tête.
• Quatre déclencheurs de scène : c'est l'heure de partir, départ en retard, départ supprimé, nouvelle perturbation.
• Une action de scène qui lit les prochains départs d'un arrêt, avec une phrase prête à envoyer par message ou sur une enceinte.

Prérequis

• Gladys Assistant 5.1.0 ou plus récent.
• Un accès à Internet depuis la machine Gladys (l'intégration appelle api.entur.io).
• Un arrêt en Norvège. Entur couvre tout le pays, pas les autres pays nordiques.

Installation

1. Dans Gladys, ouvrez Intégrations → Installer depuis GitHub.
2. Collez https://github.com/guim31/gladys-entur et installez.
3. Ouvrez l'onglet Configuration de l'intégration.

Configuration

Réglages

• Langue des textes : langue des noms de fonctionnalités (fixés à la création de l'appareil), des phrases des scènes et des messages de trafic quand Entur les publie dans cette langue. Entur écrit ses messages en norvégien et souvent en anglais : un message sans la langue choisie s'affiche en anglais, sinon en norvégien. Le norvégien n'est pas proposé comme langue d'interface.
• Fréquence de mise à jour : 30 secondes, 1 minute (par défaut) ou 2 minutes. Tous les appareils créés sont lus en une seule requête.

Ajouter un arrêt

1. Chercher un arrêt : saisissez un nom (Jernbanetorget, Bergen busstasjon…). La réponse liste les arrêts trouvés avec leur identifiant, par exemple NSR:StopPlace:58366.
2. Ajouter un arrêt : collez l'identifiant (ou le numéro seul, ou le nom exact s'il est unique). Filtres facultatifs :
   • Lignes : L1, R13 ne garde que ces lignes (telles qu'écrites sur le véhicule).
   • Direction : Ski ne garde que les départs dont la destination contient ce texte (accents et majuscules ignorés, lillestrom trouve Lillestrøm).
   • Mode : train, métro, tram, bus, car ou ferry, pour les grands pôles.
3. Ouvrez l'onglet Découverte et ajoutez l'appareil à Gladys.

Le même arrêt avec d'autres filtres donne un autre appareil : ajoutez Oslo S direction Ski et Oslo S direction Drammen pour suivre les deux sens. Jusqu'à 20 arrêts peuvent être suivis.

Retirer un arrêt, vérifier l'état

• Retirer un arrêt : saisissez son nom tel qu'affiché par l'état (Oslo S (L1)) ou son identifiant. Son appareil reste dans Gladys jusqu'à ce que vous le supprimiez.
• Voir ce qui est suivi : les arrêts, l'existence de leur appareil, la dernière lecture d'Entur et la dernière erreur.

Appareils

Fonctionnalité	Type	Contenu
Prochain départ	durée (min)	minutes avant le prochain départ maintenu (0 = part maintenant)
Départ suivant	durée (min)	minutes avant le suivant
Retard	durée (min)	retard du prochain départ (0 à l'heure ou en avance)
Ligne et destination	texte	L1 → Spikkestad
Perturbation	binaire (oui/non)	un message de trafic touche les départs de l'appareil

Les départs supprimés sont sautés par les comptes à rebours. Sans départ dans les 24 heures, les comptes à rebours affichent 1440 minutes. Seuls les départs gardés par les filtres comptent.

Widget de tableau de bord

Prochains départs : choisissez un arrêt. Le widget affiche ses huit prochains départs (ligne, destination, heure estimée, minutes, retard) : en vert quand le véhicule est suivi en temps réel, en orange à partir de deux minutes de retard, en rouge s'il est supprimé, en gris pour un horaire théorique. La légende affiche les messages de trafic de l'arrêt.

Déclencheurs de scène

Chaque déclencheur peut être limité à un arrêt et à une ligne (telle qu'écrite sur le véhicule, en majuscules).

• C'est l'heure de partir : un départ part dans le nombre de minutes choisi (1 à 20). Une fois par départ, quand son compte à rebours atteint ce nombre. Un départ vu pour la première fois déjà dans la fenêtre ne déclenche pas.
• Départ en retard : un départ a au moins le retard choisi (1 à 60 minutes). Une fois par départ et par seuil.
• Départ supprimé : un départ est supprimé. Une fois par départ.
• Nouvelle perturbation : un nouveau message de trafic touche les départs d'un arrêt. Une fois par message.

Variables transmises à la scène : arrêt, ligne, mode, destination, quai, heures prévue et estimée, minutes, retard ; pour une perturbation, son résumé et ses détails. Ce qui existe déjà au démarrage de l'intégration n'est pas annoncé ; les suppressions et messages déjà annoncés ne le sont pas de nouveau après un redémarrage.

Actions de scène

Lire les prochains départs Entur : choisissez un arrêt, et si vous voulez une ligne. Sorties : une phrase (Train L1 vers Spikkestad à Oslo S : dans 3 et 18 min), l'arrêt, la ligne, la destination, les minutes à attendre, les minutes jusqu'au suivant, le retard, l'heure estimée, le quai, temps réel (1/0), perturbation (1/0). La phrase suit la langue de la configuration.

Exemples de scènes

• Partir pour le train : déclencheur « C'est l'heure de partir », arrêt Oslo S (L1), 7 min → envoyer « Ton L1 part dans {{minutes}} min, quai {{platform}} » et faire clignoter la lumière de l'entrée.
• Point du matin : à 7 h en semaine, action « Lire les prochains départs Entur » → envoyer sa phrase sur l'enceinte de la cuisine.
• Prévenir d'un bus supprimé : déclencheur « Départ supprimé », arrêt Jernbanetorget (31) → envoyer un message avec la destination et l'heure prévue.

Données, fréquence et quotas

Les API d'Entur sont gratuites et ouvertes (licence NLOD). Entur demande à chaque client de s'identifier : l'intégration envoie l'en-tête ET-Client-Name: guim31-gladys et lit tous vos arrêts en une seule requête, au plus toutes les 30 secondes, et seulement pour les appareils créés dans Gladys. Les données sont le temps réel des opérateurs quand ils le publient, sinon leurs horaires.

Dépannage

• Aucun appareil dans Découverte : ajoutez d'abord l'arrêt avec « Ajouter un arrêt ».
• « Entur est injoignable » : la machine Gladys n'a pas accès à Internet, ou Entur est en panne. L'intégration réessaie à chaque mise à jour et signale le retour.
• Un filtre de ligne est refusé : la réponse liste les lignes qui desservent l'arrêt ; saisissez la ligne telle qu'elle y est écrite.
• Un déclencheur ne se déclenche pas : vérifiez la ligne (exacte, en majuscules) et que l'appareil existe dans Gladys : seuls les appareils créés sont lus.

Limites

• Développée sans vivre en Norvège, contre la vraie API d'Entur : vos retours sont les bienvenus.
• Les noms de fonctionnalités sont fixés à la création de l'appareil.
• Les messages de trafic sont en norvégien et souvent en anglais, jamais traduits.
• Les départs sont lus sur les 24 prochaines heures : les 40 prochains des lignes et du mode choisis (filtrés par Entur), 100 avec un filtre de direction. Dans un grand pôle sans filtre, 40 départs peuvent ne couvrir qu'une demi-heure.

Crédits

Données : Entur, licence NLOD. Inspirée de l'intégration Home Assistant entur_public_transport (Apache 2.0) et des intégrations gladys-tisseo et gladys-gtfs.

Paramètres de configuration

Voici les paramètres demandés par Entur dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Comment ça marche	section	Non	Cherchez vos arrêts avec les actions ci-dessous, ajoutez-les (avec un filtre facultatif de ligne, de direction ou de mode), puis créez leurs appareils dans l'onglet Découverte. Tout vient de l'open data d'Entur : ni compte, ni clé.
Langue des textes	select	Non	Langue des noms de fonctionnalités, des phrases envoyées à vos scènes et des messages de trafic quand Entur les a dans cette langue (sinon anglais, sinon norvégien). Les noms sont fixés à la création de l'appareil.
Fréquence de mise à jour	select	Non	Fréquence de lecture des départs de vos appareils créés : une seule requête pour tous.

Comment installer Entur dans Gladys

1. Dans Gladys, ouvrez Intégrations : Entur apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-entur:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-entur.

Entur nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

Entur est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂