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

title	description	ha_category	ha_release	ha_iot_class	ha_domain	ha_platforms	ha_integration_type	ha_codeowners
OpenSky Network	Instructions on how to integrate OpenSky Network into Home Assistant.	Transport	0.43	Cloud Polling	opensky	sensor	integration	@joostlek

The opensky sensor allows one to track overhead flights in a given region. It uses crowd-sourced data from the OpenSky Network public API. It will also fire Home Assistant events when flights enter and exit the defined region.

Configuration

To enable this sensor, add the following lines to your configuration.yaml file:

sensor:
  - platform: opensky
    radius: 10

Configuration options for the OpenSky Network sensor:

• radius (Required): Radius of region to monitor, in kilometers.
• latitude (Optional): Region latitude. Defaults to home zone latitude.
• longitude (Optional): Region longitude. Defaults to home zone longitude.
• altitude (Optional): The maximum altitude (in meters) for planes to be detected in, 0 sets it to unlimited. Defaults to 0).
• name (Optional): Sensor name. Defaults to opensky.

Events

• opensky_entry: Fired when a flight enters the region.
• opensky_exit: Fired when a flight exits the region.

Both events have four attributes:

• sensor: Name of opensky sensor that fired the event.
• callsign: Callsign of the flight.
• altitude: Altitude of the flight in meters.
• icao24: The ICAO 24-bit address of the aircraft's transponder.

To receive notifications of the entering flights using the Home Assistant Companion App, add the following lines to your configuration.yaml file:

{% raw %}

automation:
  - alias: "Flight entry notification"
    trigger:
      platform: event
      event_type: opensky_entry
    action:
      service: notify.mobile_app_<device_name>
      data:
        message: "Flight entry of {{ trigger.event.data.callsign }}"

{% endraw %}

One can also get a direct link to the OpenSky website to see the flight using the icao24 identification:

{% raw %}

automation:
  - alias: "Flight entry notification"
    trigger:
      platform: event
      event_type: opensky_entry
    action:
      service: notify.mobile_app_<device_name>
      data:
        message: "Flight entry of {{ trigger.event.data.callsign }}"
        data:
          actions:
            - action: URI
              title: Track the flight
              uri: >-
                https://opensky-network.org/aircraft-profile?icao24={{
                trigger.event.data.icao24 }}

{% endraw %}