mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-15 21:36:52 +00:00
Improve docs of Swiss public transport for new options (#35609)
* improve docs * corerabbit * corerabbit * coderabbit * fix reversed images * coderabbit * Tiny tweaks --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
parent
ac043879af
commit
e8c57ef77e
@ -25,6 +25,48 @@ The [Stationboard](https://transport.opendata.ch/examples/stationboard.html) web
|
||||
|
||||
The public timetables are coming from [Swiss public transport](https://transport.opendata.ch/).
|
||||
|
||||
## Set up a connection
|
||||
|
||||
The minimum configuration for a connection requires a _start_ and _end_ station (for example, "Zürich HB").
|
||||
|
||||
Optionally, you can provide up to 5 additional _via_ stations.
|
||||
|
||||

|
||||
|
||||
### Time mode
|
||||
|
||||
The _Time mode_ allows you to specify the time of the connections.
|
||||
|
||||
- Now (default): Provide the next connections.
|
||||
- At a fixed time of day: Provide the connections that depart at a fixed time of day (for example, 18:15 in the evening)
|
||||
- At an offset from now: Provide the next possible connections which depart after a specified offset (for example, 15 minutes from now, which helps account for a 15-minute walk to the station)
|
||||
|
||||

|
||||
|
||||
#### Use case: Next connection at my local bus stop
|
||||
|
||||
Usually, it takes some time to walk to the closest bus station from home, which can be modeled using the `offset` option in the _Time mode_ dropdown, filtering out connections which are not reachable anymore. This information can then be displayed at the door or on your mobile device.
|
||||
|
||||

|
||||
|
||||
#### Use case: Daily train home
|
||||
|
||||
For people working business hours, a set-up using the `fixed` option in the _Time mode_ allows you to identify the same train each day for commuting home. Set up an automation to send a push notification to get informed early.
|
||||
|
||||

|
||||
|
||||
### Departure versus Arrival
|
||||
|
||||
Usually, one wants to know when a connection **departs** (default), but in case where the opposite is needed and one wants to know when a connection **arrives**, select "Show arrival time at end station" in the time reference dropdown.
|
||||
|
||||
When configured for arrival time, the sensor will display the arrival time at the destination instead of the departure time from the start station. This is particularly useful for automations that need to trigger based on arrival times.
|
||||
|
||||

|
||||
|
||||
#### Use case: Inform family of train arriving late
|
||||
|
||||
A popular use case would be to know if your family member is running late and sending out a push notification or displaying their arrival time at home.
|
||||
|
||||
## Actions
|
||||
|
||||
The Swiss public transport integration has the following action:
|
||||
|
Binary file not shown.
After Width: | Height: | Size: 216 KiB |
Binary file not shown.
After Width: | Height: | Size: 85 KiB |
Binary file not shown.
After Width: | Height: | Size: 63 KiB |
Binary file not shown.
After Width: | Height: | Size: 82 KiB |
Binary file not shown.
After Width: | Height: | Size: 67 KiB |
Loading…
x
Reference in New Issue
Block a user