HVV Departures
The hvv_departures sensor will display the departures of buses, trains and ferries in Hamburg.
Configuration
To add the HVV Departures integration to your Home Assistant instance, use this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the Add Integration button.
-
From the list, select HVV Departures.
-
Follow the instructions on screen to complete the setup.
Need your API credentials? See how to get the API credentials.
Options
Menu: Configuration > Integrations > Select your new integration > Press the cog in the upper left corner
- select lines: filter the departures on the station to only show departures for the selected lines.
- offset: set this if you want to list the departures some minutes in the future, for example, if you live ten minutes away from the station.
- use realtime data: enable this to include delay and cancellation information.
Departure sensors
The integration creates one sensor for the departures at the selected station.
States
The state is a timestamp representing the time for the next departure, not including delays.
Attributes
| Attribute | Description |
|---|---|
line |
Line number of the next departure |
origin |
The station where the transport started from |
direction |
The station where the transport ends |
type |
Type of the transportation, for example, Bus or S
|
id |
A unique identifier for the line. In most cases, line is sufficient to identify the line |
delay |
Real-time data about the delay of the transport in seconds. Add this to the departure time to get the real departure time |
next |
A list of the upcoming departures. Each element has the above attributes and departure containing the timestamp |
Elevator sensors
If the selected station has elevators, binary sensors will be available.
States
- OK (
off): The elevator is working. - Problem (
on): The elevator is out of order. See the cause attribute for more information.
Attributes
| Attribute | Description |
|---|---|
cabin_width |
Width of the elevator cabin |
cabin_length |
Length of the elevator cabin |
door_width |
Width of the elevator doors |
elevator_type |
Type of the elevator |
button_type |
Type of the elevator buttons, can be one of the following:
|
cause |
If the state of the sensor is on (“Problem”), the cause attribute may contain further information about the cause |
lines |
List of lines that can be reached using this elevator |
How to get the API credentials
You have to apply for credentials via the HVV website. You can see their official guide here (the page is only available in German).
In your mail, tell them you are using your API credentials for use within Home Assistant. They will send you a contract you will have to sign and send back. After about a week, you will receive your API credentials.
Data
Data is provided by HVV.