2024.11.3
Home ▸ Integrations ▸

Swiss public transport

The Swiss public transport integration will give you the next three departure times from a given location to another one in Switzerland.

The Swiss public transport API only allows 1000 requests per 24 hours. The default polling rate is set to 90s, which is just enough for one connection polling continuously. If more entries are needed, consider defining a custom polling interval to reduce the amount of requests.

Start station

The departure station for the start of the connection (e.g., Zürich HB)

End station

The arrival station for the end of the connection (e.g., Geneva)

Via stations

List of up to 5 via stations (e.g., Bern, Lausanne)

Use the Stationboard to find exact station names.

Configuration

To add the Swiss public transport integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Swiss public transport.

  • Follow the instructions on screen to complete the setup.

The public timetables are coming from Swiss public transport.

Actions

The Swiss public transport integration has the following action:

  • swiss_public_transport.fetch_connections

Action swiss_public_transport.fetch_connections

Fetch the connections for a specific instance.

Data attribute Optional Description
config_entry_id No The ID of the Swiss public transport config entry to get data from. For example, in YAML: config_entry_id: zurich_geneva or in UI Instance: zurich_geneva)
limit Yes The number of connections to fetch. (default: 3, range: [1,15])

Defining a custom polling interval

If you want to define a specific interval at which your device is being polled for data, you can disable the default polling interval and create your own polling automation.

To add the automation:

  1. Go to Settings > Devices & services, and select your integration.
  2. On the integration entry, select the .
    • Then, select System options and toggle the button to disable polling. Disable polling for updates
  3. To define your custom polling interval, create an automation.
  4. Save your new automation to poll for data.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three-dot menu. Then, select Delete.