Integración domótica Tisséo, gratuita y de código abierto
Próximas salidas de Tisséo en Toulouse, incidencias y bicis VélôToulouse, con datos abiertos.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
El transporte público de Toulouse en Gladys: las próximas salidas en sus paradas (metro, tranvía, Téléo, Linéo, autobuses), las incidencias de sus líneas y las bicis VélôToulouse de sus estaciones. Todo procede de datos abiertos: sin cuenta ni clave de API.
Datos: Tisséo y Toulouse Métropole, bajo la Open Database License (ODbL), publicados en transport.data.gouv.fr. Esta integración es un proyecto comunitario, sin relación con Tisséo, Toulouse Métropole ni JCDecaux.
Qué obtiene
- Un dispositivo por parada vigilada: para cada línea y dirección, los minutos hasta la próxima salida y hasta la siguiente; las tres salidas más próximas en texto; la info de tráfico de sus líneas.
- Un dispositivo por estación VélôToulouse vigilada: bicis disponibles, bicis mecánicas, bicis eléctricas, anclajes libres.
- Widget «Próximas salidas»: el panel de una parada, los horarios seguidos en tiempo real en verde, los horarios teóricos marcados con «≈».
- Widget «VélôToulouse»: sus estaciones de un vistazo.
- Disparadores de escena: «Incidencia de Tisséo», «Bicis que se agotan en una estación», «Bicis de vuelta en una estación».
- Acciones de escena: «Leer las próximas salidas de Tisséo» y «Leer una estación VélôToulouse», con una frase lista para enviar («Metro A hacia Basso Cambo en Jean Jaurès: dentro de 3 y 7 min»).
¿Tiempo real o teórico? Tisséo publica la posición en directo de sus autobuses, del tranvía y de las cabinas de Téléo: sus salidas se corrigen (retrasos, supresiones, paradas no atendidas). El metro no está en el flujo en tiempo real: sus horarios son los del plan de transporte (un tren cada 1 a 4 minutos en hora punta), marcados con «≈» o «horario teórico».
Requisitos
- Gladys 5.1 o posterior, con acceso a Internet.
- Para listar las paradas alrededor de su casa: la posición de su casa en
Gladys (Configuración → Viviendas). La integración la pide al
instalarse (
location): lee las coordenadas de sus casas, nada más, y solo para ordenar las paradas por distancia. Sin ella, busque por nombre. - Unos 20 MB de disco en
/data(el archivo de horarios, actualizado una vez al día).
Instalación
- En Gladys, vaya a Integraciones → Instalar desde GitHub e introduzca
https://github.com/guim31/gladys-tisseo. - Abra la pestaña Configuración de la integración y elija el idioma de los textos (francés por defecto).
- Añada sus paradas y estaciones con las acciones de la misma pantalla (más abajo) y cree después sus dispositivos en la pestaña Descubrir.
Configuración
Ajustes
- Idioma de los textos: nombres de las funciones, info de tráfico, frases de las escenas. Los nombres se fijan al crear el dispositivo: cambie primero el idioma y cree después los dispositivos.
- Intervalo de actualización: 30 segundos, 1 minuto (por defecto), 2 o 5 minutos. Las salidas y las estaciones de bicis lo siguen.
- Tiempo real: activado por defecto. Desactivado, la integración solo usa los horarios teóricos y ya no descarga el flujo en tiempo real.
Añadir una parada
- Buscar una parada: escriba un nombre («jean jaures» encuentra «Jean
Jaurès», los acentos y las mayúsculas no importan), o déjelo vacío para
listar las 10 paradas más cercanas a su casa. Cada resultado muestra sus
líneas, su distancia y su identificador, por ejemplo
• Jean Jaurès [SA_1707] — A, B, L1, L9, L14, 15, 23 — 550 m. - Añadir una parada: su nombre, o su identificador si varias paradas tienen el mismo nombre (hay tres «Jean Jaurès» en la metrópoli). Líneas es opcional: «A, L1» solo conserva esas dos líneas; vacío, todas las líneas.
- Abra la pestaña Descubrir y cree el dispositivo.
Añadir una parada ya vigilada cambia sus líneas: Gladys propone entonces actualizar el dispositivo en la pestaña Descubrir.
La primera búsqueda descarga los horarios de Tisséo (15 MB) y los lee: hasta un minuto en una máquina pequeña. Las acciones lo esperan.
Añadir una estación de bicis
- Buscar una estación de bicis: un nombre, o vacío para las 10 estaciones
más cercanas a su casa. Cada resultado muestra su número, por ejemplo
• Poids de l'Huile [1] — 570 m. - Añadir una estación de bicis: su número o su nombre.
- Cree su dispositivo en la pestaña Descubrir.
Quitar una parada o una estación, comprobar los flujos
- Quitar una parada o una estación: su nombre o su identificador. El dispositivo permanece en Gladys hasta que usted lo elimine.
- Mostrar lo vigilado: las paradas y estaciones, la fecha de los horarios, la antigüedad de los datos en tiempo real y de bicis, y el último error si lo hay.
Como máximo 20 paradas y 20 estaciones.
Dispositivos
Parada
Para cada línea y dirección atendida (o las líneas elegidas):
| Función | Tipo | Valor |
|---|---|---|
| Metro A → Basso Cambo | duración (min) | minutos hasta la próxima salida |
| Metro A → Basso Cambo (siguiente) | duración (min) | minutos hasta la siguiente |
Y dos textos para toda la parada:
- Próximas salidas: las tres más próximas, p. ej.
L1 → Gare Matabiau 2 min · A → Basso Cambo ≈4 min(«≈» = teórico). - Info de tráfico: los títulos de las incidencias en curso en sus líneas, o «Sin incidencias».
0 significa que el vehículo está en la parada o llegando (menos de un
minuto); 1440 significa ninguna salida en las próximas 24 horas (noche,
una línea que no circula ese día). Estos valores no guardan historial: una
cuenta atrás leída cada minuto llenaría la base de datos para nada.
Estación de bicis
| Función | Tipo |
|---|---|
| Bicicletas disponibles | contador |
| Bicicletas mecánicas | contador |
| Bicicletas eléctricas | contador |
| Anclajes libres | contador |
Estas sí guardan su historial: el gráfico muestra cuándo se vacía su estación.
Widgets del panel
- Próximas salidas: elija una parada. Una fila por línea y dirección (diez como máximo, primero las que tienen una salida): «3 · 7 min» en verde cuando es tiempo real, «≈ 3 · 7 min» en azul para el horario teórico. La leyenda lista las incidencias de sus líneas (⚠), o recuerda qué significa «≈».
- VélôToulouse: elija sus estaciones (vacío: todas, diez como máximo). Una sola estación muestra cuatro mosaicos en directo; varias, una fila cada una («3 mec. · 2 eléc. · 12 libres»), en rojo cuando no queda ninguna bici, en naranja con dos o menos.
Disparadores de escena
- Incidencia de Tisséo: aparece una nueva incidencia en una línea de sus paradas vigiladas (el filtro de líneas de una parada la restringe), o en toda la red (huelga, cierres). Filtros: alcance (una línea seguida, toda la red, o vacío para ambos) y línea (tal como la escribe Tisséo: A, T1, L9, 15). Variables: línea, título, detalles (texto plano), enlace a tisseo.fr. Una incidencia se anuncia una vez; las que ya existían cuando usted añade una parada, no.
- Bicis que se agotan en una estación: las bicis de un tipo (todas, mecánicas, eléctricas) en una estación vigilada bajan al número elegido o por debajo (0, 1, 2, 3 o 5). Se dispara una vez al cruzar el umbral, no en cada actualización.
- Bicis de vuelta en una estación: esas mismas bicis vuelven a superar el número elegido.
Para «el próximo autobús llega en menos de 5 minutos», use el disparador «Cambio de estado del dispositivo» de Gladys sobre la cuenta atrás de la parada: ya sabe comparar valores.
Acciones de escena
- Leer las próximas salidas de Tisséo: una parada vigilada y, opcionalmente, una línea. Salidas: frase (hasta cuatro líneas y direcciones, las más próximas primero), parada, línea y dirección de la próxima salida, minutos de espera, minutos hasta la siguiente, tiempo real (1) o teórico (0), número de líneas con salida.
- Leer una estación VélôToulouse: salidas frase, bicis disponibles, mecánicas, eléctricas, anclajes libres, en servicio (1 o 0).
Las frases siguen el idioma de la configuración.
Ejemplos de escenas
- Hora de salir: a las 7:45 entre semana, «Leer las próximas salidas de
Tisséo» en su parada para la línea L1 y envíe después
{{sentence}}por Telegram o anúnciela en un altavoz. - Mañana de huelga: disparador «Incidencia de Tisséo» con el alcance «toda la red» y envíe después el título y el enlace a su móvil.
- La última bici eléctrica: disparador «Bicis que se agotan en una estación», su estación, bicis eléctricas, como máximo 0: envíe «No quedan bicis eléctricas en la estación, tome el metro».
- Salir cuando llega el autobús: disparador «Cambio de estado del dispositivo», cuenta atrás de su autobús menor que 4, condición «alguien en casa» y antes de las 8:30: haga parpadear la luz de la entrada.
Datos, actualización y ancho de banda
| Datos | Fuente | Cuándo |
|---|---|---|
| Horarios (GTFS, 15 MB) | Tisséo, vía data.gouv.fr | una vez al día como máximo, guardados en /data |
| Tiempo real (GTFS-RT, 1,7 MB) | Tisséo (api.tisseo.fr) | en cada actualización, cada 15 min cuando nada circula |
| Estaciones de bicis (GBFS) | VélôToulouse (JCDecaux), vía data.gouv.fr | lista de estaciones una vez al día, estado en cada actualización |
El flujo en tiempo real es el más pesado: unos 100 MB por hora con una actualización por minuto en horas de servicio. De noche, sin salidas en los próximos 90 minutos en sus paradas, solo se lee cada 15 minutos. Elija 2 o 5 minutos, o desactive el tiempo real, en una conexión limitada. Los datos abiertos no tienen cuota; Tisséo regenera el flujo en tiempo real cada 20 segundos aproximadamente.
Solución de problemas
- «Los horarios de Tisséo aún se están cargando»: la primera descarga tarda un minuto; vuelva a intentarlo.
- «Varios resultados»: añada la parada por su identificador (
SA_…), que muestra «Buscar una parada». - Todos los horarios de una parada están marcados con ≈: siempre es así para el metro; para un autobús, el vehículo no está seguido en este momento o el flujo en tiempo real falla («Mostrar lo vigilado» indica el último error). Los horarios teóricos siguen funcionando.
- Una línea muestra 1440: ninguna salida en las próximas 24 horas (servicio nocturno, una línea que no circula ese día, un desvío).
- Ningún dispositivo en la pestaña Descubrir: añada primero una parada o una estación; para las paradas, los horarios deben estar descargados.
- Una línea nueva en mi parada: Gladys propone actualizar el dispositivo en la pestaña Descubrir.
- Registros: en Gladys, los registros de la integración indican qué flujo ha fallado y por qué.
Limitaciones
- Solo Toulouse (la red Tisséo y VélôToulouse).
- El metro solo tiene horarios teóricos: Tisséo no lo publica en tiempo real.
- Sin plazas libres en los aparcamientos disuasorios: los datos abiertos de Toulouse Métropole solo dan su capacidad, no su ocupación.
- Las incidencias son las que Tisséo publica en su flujo en tiempo real; su texto está en francés.
- La API oficial de Tisséo (api.tisseo.fr, con clave) no se usa: los flujos abiertos dan las mismas salidas sin ninguna cuenta.
- Una cuenta atrás es precisa al intervalo de actualización.
- Desarrollada y probada con los datos reales de Tisséo y VélôToulouse, sin instancia de Gladys: sus comentarios son bienvenidos en el foro.
Créditos
- Datos: Tisséo, Toulouse Métropole, VélôToulouse (JCDecaux), bajo la ODbL.
- Inspirada en la integración TCL de prohand (Lyon) y en las integraciones GTFS de Home Assistant.
- Código bajo la licencia Apache 2.0.
Parámetros de configuración
Estos son los parámetros que Tisséo te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Cómo funciona | section | No | Busque sus paradas y estaciones VélôToulouse con las acciones de abajo (por nombre o alrededor de su casa), añádalas y cree después sus dispositivos en la pestaña Descubrir. Todo procede de los datos abiertos de Tisséo y VélôToulouse: sin cuenta ni clave. |
| Idioma de los textos | select | No | Idioma de los nombres de las funciones, de la info de tráfico y de las frases enviadas a sus escenas. Los nombres se fijan al crear un dispositivo. |
| Intervalo de actualización | select | No | Con qué frecuencia se actualizan las salidas y las estaciones de bicis. El flujo en tiempo real pesa unos 1,7 MB: una vez por minuto son unos 2,4 GB al día en horas de servicio. |
| Tiempo real | boolean | No | Corregir los horarios con los vehículos seguidos en directo (autobuses, tranvía, Téléo) y leer las incidencias. Desactivado: solo horarios teóricos, sin descarga cada minuto. |
Cómo instalar Tisséo en Gladys
- En Gladys, abre Integraciones: Tisséo aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-tisseo:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-tisseo.
Tisséo requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Tisséo es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación