home-assistant.io/source/_integrations/hvv_departures.markdown

title, description, ha_category, ha_iot_class, ha_release, ha_config_flow, ha_codeowners, ha_domain, ha_platforms, ha_integration_type

title	description	ha_category	ha_iot_class	ha_release	ha_config_flow	ha_codeowners	ha_domain	ha_platforms	ha_integration_type
HVV Departures	Display the departures of buses, trains and ferries in Hamburg within Home Assistant.	Transport	Cloud Polling	0.112	true	@vigonotion	hvv_departures	binary_sensor sensor	integration

The hvv_departures sensor will display the departures of buses, trains and ferries in Hamburg.

{% include integrations/config_flow.md %}

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: BRAILLE ACUSTIC COMBI UNKNOWN
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 subsequently send your API credentials in a follow-up response.

Data

Data is provided by HVV.