Integración domótica Calgary Transit, gratuita y de código abierto
Next Calgary Transit bus and CTrain departures in real time, and the CTrain line status.
Publicado por LM1LC3N7
- Dispositivos
- Versión 0.1.1
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
The next Calgary Transit departures (bus and CTrain) in real time and the status of the CTrain lines near your home, in Gladys.
This integration is not affiliated with Calgary Transit nor the City of Calgary.
Get started in 3 steps
No technical knowledge is needed, and no account: there is nothing to create, no key.
- Check the address of your house in Gladys: Settings → Houses. The house must have a position on the map. The integration uses it to find the stops near you. The position stays in your Gladys.
- Install the integration from the integration catalog, and accept the access to the house location. Open its configuration page and press Save, without filling anything in.
- Open the Discover tab of the integration. The 3 stops closest to your home are offered there, with their name and the direction of their routes, e.g. "Calgary Transit – NB 1 ST SW @ 8 AV SW (22 → Richmond Rd SW, 66 → Lakeview)", as well as the Calgary Transit – CTrain device. Press Add on each one you want.
That's it. You now get the next departures at each stop and the status of the CTrain lines.
The message at the top of the configuration page always tells you what to do next. For example: "Ready: 3 stops and the lines to add. Open the Discover tab…".
Device names start with Calgary Transit –, so they are easy to find in the device list of Gladys. You can rename them freely in Gladys.
Showing the departures on the dashboard
- Open the dashboard, then press Edit.
- Add a widget and choose Calgary Transit departures.
- Choose the stop, then save.
The CTrain line status widget is added the same way.
Where the departures come from
Calgary Transit publishes its real-time predictions in the open, for the buses and the CTrain: the integration reads them every minute, for all your stops at once. The direction of each departure ("→ Richmond Rd SW") comes from Transitous, a free community service.
A CTrain station has one stop per platform, one per direction: "EB City Hall/Bow Valley College" (eastbound) and "WB City Hall/Bow Valley College" (westbound).
Watching other stops (work, school…)
For a stop far from home:
- At the bottom of the configuration page, press Find a stop. Type a street, a station or the stop number, e.g. "City Hall" or "1 St SW 8 Av".
- The answer lists the stops with their number and the direction of their
routes, e.g.
5299 — NB 1 ST SW @ 8 AV SW (22 → Richmond Rd SW, 66 → Lakeview). - Copy the number (
5299) in Stops, save, then add the stop in the Discover tab.
The number is the one written on every Calgary Transit stop sign (the one texted to 74500).
Going further
The Stops field accepts several numbers separated by commas, a route
filter after @ and a name after :.
| Entry | Meaning |
|---|---|
5299 | every route calling at stop 5299 |
5299@22 | route 22 only |
5299@22|66 | routes 22 and 66 |
5299@22:Bus to work | route 22, displayed as "Bus to work" |
6831@202 | the Blue Line at City Hall, eastbound |
What each device holds
Stop:
- Next departure, Departure 2…: the minutes to wait. 999 means no departure is coming.
- Next departure route…: the route ("22", "201" for the Red Line, "202" for the Blue Line).
- Next departures: a summary, e.g.
22 3 min · 66 11 min.
CTrain: for each line (Red Line, Blue Line), a status (Normal,
Disrupted, Notice or Unknown) and the message of the Calgary
Transit alert. A closure between stations, with shuttle buses, is a
disruption; a detour or any other announcement is a notice. Elevators and
escalators, and the alerts about a single station, do not change the status
of a line.
Scenes
Triggers:
- Departure approaching: a departure gets under 1, 2, 3, 5, 10 or 15 minutes. Example: "when the 22 is 5 minutes away, turn the hall light on".
- Line status changed: a line is disrupted, gets back to normal, or receives a notice. Example: "if the Red Line is disrupted, send me a message".
Actions:
- Read the next departures: e.g. a message every morning "Your 22 comes in {{minutes}} minutes".
- Read a line status: returns the status, the Calgary Transit message and
normal(true or false).
Troubleshooting
| Message or symptom | What to do |
|---|---|
| "set the address of your house" | Settings → Houses: place the house on the map, then save the configuration of the integration again. |
| "Gladys did not share the location of your house" | Reinstall the integration and accept the location access, or type stop numbers. |
| Nothing in the Discover tab | Read the message of the configuration page: it says what is missing. |
| "Stop … is not in the Calgary Transit stop list" | Check the number on the sign. A brand new stop comes with the next version of the integration. |
| A stop stays at 999 | No departure coming (at night), or a route filter matching no route of the stop. |
| A departure has no direction | Its trip was not listed yet by Transitous: the direction comes back within the day. |
Privacy, data and licences
- The house location is only used to look the nearby stops up, in the stop list shipped with the integration: it is sent nowhere.
- Stop list, real time and alerts: Calgary Transit data, City of Calgary open data, under the Open Government Licence – City of Calgary (the stop list is updated with every version).
- Directions: Transitous, a free community service, from the Calgary Transit data.
- Integration code: Apache 2.0 licence.
Parámetros de configuración
Estos son los parámetros que Calgary Transit te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Get started in 2 minutes | section | No | 1. Check that your house has an address in Gladys (Settings → Houses). 2. Save this page. 3. Open the “Discover” tab of this integration and press “Add” on the stops near your home. That's it: you get the next departures right away. The Calgary Transit real time and the line status come with it, without any key. |
| Near my home | section | No | How many of the closest stops (within 600 m) are proposed in the “Discover” tab. 0 turns the suggestion off. |
| Stops near my home | number | No | |
| Lines | section | No | The status of the CTrain Red and Blue lines, from the Calgary Transit service alerts. |
| Watch the lines | boolean | No | Creates a "Calgary Transit – CTrain" device with the status of the CTrain Red and Blue lines. |
| Other stops (optional) | section | No | To watch a stop that is not near your home (work, school…): type its number, written on the stop sign, or find it with the “Find a stop” button at the bottom of this page. |
| Stops | string | No | Stop numbers. Optional route filter after @ and custom name after : — e.g. "6831, 5299@22:Bus to work". |
| Advanced | section | No | The defaults suit almost everyone. One read of the real-time feed serves every stop. |
| Departures refresh interval (s) | number | No | How often the departures are refreshed, in seconds. |
| Lines refresh interval (s) | number | No | How often the line status is refreshed, in seconds. |
| Departures per stop | number | No | How many upcoming departures each stop device exposes as features. |
| Language of the values | select | No | Language of the feature names and of the texts published. |
Cómo instalar Calgary Transit en Gladys
- En Gladys, abre Integraciones: Calgary Transit 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/lm1lc3n7/gladys-calgary-transit:0.1.1), 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/LM1LC3N7/gladys-calgary-transit.
Calgary Transit 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
Calgary Transit 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 LM1LC3N7, 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