home-assistant.io/source/_components/binary_sensor.iss.markdown
Olivér Falvai 002da69ce4 Changed Google Maps to OpenStreetMap in code explanation (#7695)
The code snippet contains an OpenStreetMap URL, but the paragraph above mentioned Google Maps
2018-11-30 19:30:16 +01:00

2.0 KiB

layout title description date sidebar comments sharing footer logo ha_category ha_release redirect_from
page International Space Station Know if or when ISS will be above your home location 2016-12-18 10:00 true false true true nasa.png Binary Sensor 0.36 /components/sensor.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.

{% linkable_title Configuration %}

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

# Example configuration.yaml entry
binary_sensor:
  - platform: iss

{% configuration %} name: description: The name for this sensor in the frontend. required: false type: string default: ISS show_on_map: description: Option to show the position of the ISS on the map. required: optional type: boolean default: false {% endconfiguration %}

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.

{% linkable_title Show position on map with camera platform %}

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

{% raw %}

# Example configuration.yaml entry
camera:
  - platform: generic
    name: ISS
    still_image_url: http://staticmap.openstreetmap.de/staticmap.php?center={{ states.binary_sensor.iss.attributes.lat }},{{ states.binary_sensor.iss.attributes.long }}&zoom=4&size=865x512&maptype=mapnik&markers={{ states.binary_sensor.iss.attributes.lat }},{{ states.binary_sensor.iss.attributes.long }},lightblue
     limit_refetch_to_url_change: true

{% endraw %}