home-assistant.io/source/_components/device_tracker.locative.markdown
2016-02-07 14:20:52 -08:00

1.8 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category
layout title description date sidebar comments sharing footer logo ha_category
page Locative Instructions how to use Locative to track devices in Home Assistant. 2015-10-13 19:00 true false true true locative.png Presence Detection

This platform allows you to detect presence using Locative. Locative is an open source 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:

# Example configuration.yaml entry
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.

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