home-assistant.github.io/source/_components/binary_sensor.iss.markdown
Fabian Affolter e19273e847 Add show_on_map option (#1837)
* Add show_on_map option

* Add logo for ISS

* Add docs for ISS binary sensor

* Add deprecated warning
2017-01-24 10:02:35 +01:00

29 lines
965 B
Markdown

---
layout: page
title: "International Space Station"
description: "Know if or when ISS will be above your home location"
date: 2016-12-18 10:00
sidebar: true
comments: false
sharing: true
footer: true
logo: nasa.png
ha_category: Binary Sensor
ha_release: 0.36
---
The `iss` platform uses the [Open Notify API](http://open-notify.org/Open-Notify-API/ISS-Location-Now/) 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:
```yaml
# Example configuration.yaml entry
binary_sensor:
- platform: iss
```
Configuration variables:
- **show_on_map** (*Optional*): Option to show the position of the ISS on the map. Defaults to `False`.