jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Update locative documentation

Browse source
This commit is contained in:
Philip Lundrigan 2016-01-02 00:10:08 -07:00
parent 000e1b923b
commit 515b7e2c78
2 changed files with 11 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

13
source/_components/device_tracker.locative.markdown
View file

@ -11,8 +11,7 @@ logo: locative.png
ha_category: Presence Detection
---
This platform allows you to detect presence using [Locative](https://my.locative.io/). Locative allows users to track their location on iOS devices.
This platform allows you to detect presence using [Locative](https://my.locative.io/). Locative is an [open source](https://github.com/LocativeHQ/ios-app) app for iOS that allows users to set up a `GET` or `POST` request when a geofence is entered or exited. This can be configured with Home Assistant to update your location.
To integrate Locative in Home Assistant, add the following section to your `configuration.yaml` file:
@ -21,3 +20,13 @@ To integrate Locative in Home Assistant, add the following section to your `conf
device_tracker:
platform: locative
```
To configure Locative, you must set up the app to send a `GET` request to your Home Assistant server at `http://<ha_server>/api/locative`. Make sure to include the API password if you have configured a password in Home Assistant (add `?api_password=<password>` to the end of the URL). When you enter or exit a geofence, Locative will send a `GET` request to that URL, updating Home Assistant.
<p class='img'>
<img src='{{site_root}}/images/screenshots/locative.png'/>
</p>
When you enter a geofence, your location name in Home Assistant will be set to the name of the geofence in Locative. When you exit a geofence, your location name in Home Assistant will be set to "not home".
To use Locative in combination with another device tracker, such as [nmap](/components/device_tracker.nmap_scanner/) or [Netgear](/components/device_tracker.netgear/), fill in the `mac` field to the Locative entry in `known_devices.yaml` with the MAC address of the device you want to track. The state of the device will be determined by the source that reported last.