---
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
redirect_from: /components/sensor.iss/
---

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`.

<p class='note warning'>
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.
</p>


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

The [generic camera platform](/components/camera.mjpeg/) offers the possibility to show the location of the ISS on Google Maps.

```yaml
# Example configuration.yaml entry
camera:
  - platform: generic
    name: ISS
    still_image_url: {% raw %}https://maps.googleapis.com/maps/api/staticmap?center={{ states.binary_sensor.iss.attributes.lat }},{{ states.binary_sensor.iss.attributes.long }}&zoom=5&size=500x500&maptype=roadmap&markers=color:blue%7Clabel:P%7C{{ states.binary_sensor.iss.attributes.lat }},{{ states.binary_sensor.iss.attributes.long }}{% endraw %}
    limit_refetch_to_url_change: true
```
