International Space Station (ISS)

The iss platform uses the Open Notify API to let you know if the station is above your home location. This means that ISS is 10° above the horizon of your home.

You can check in the attributes of the sensor to see the timestamp for the next rise of the station, its current coordinates, and the number of people in space.


To add ISS binary sensor to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
  - platform: iss

Configuration Variables

name string (Optional, default: ISS)

The name for this sensor in the frontend.

show_on_map boolean (Optional, default: false)

Option to show the position of the ISS on the map.

If you set show_on_map: true then the location attributes are named latitude and longitude. The default name of the location attributes is lat and long to avoid showing them on the map.

Show position on map with camera platform

The generic camera platform offers the possibility to show the location of the ISS on OpenStreetMap.

# Example configuration.yaml entry
  - platform: iss
    show_on_map: true
  - platform: generic
    name: ISS
    still_image_url:{{ state_attr('binary_sensor.iss', 'lat') }},{{ state_attr('binary_sensor.iss', 'long') }}&zoom=4&size=865x512&maptype=mapnik&markers={{ state_attr('binary_sensor.iss', 'lat') }},{{ state_attr('binary_sensor.iss', 'long') }},lightblue
    limit_refetch_to_url_change: true