Rohan Kapoor 6b57b80366 Split out geofency into a new component and device_tracker platform (#7218)
* Split out geofency into a new component and device_tracker platform

* Switch geofency ha_category to "Presence Detection"

* ⬆️ ha_release
2018-11-11 14:16:42 +01:00

1.7 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class
layout title description date sidebar comments sharing footer logo ha_category ha_release ha_iot_class
page Geofency Instructions for how to use Geofency to track devices in Home Assistant. 2017-08-22 19:00 true false true true geofency.png Presence Detection 0.83 Cloud Push

This component sets up integration with Geofency. Geofency is a paid app for iOS that lets users to configure a request that will be sent when a geofence or iBeacon region is entered or exited. This can be configured with Home Assistant to update your location.

Enabling this component will automatically enable the Geofency Device Tracker.

To integrate Geofency in Home Assistant, add the following section to your configuration.yaml file:

# Example configuration.yaml entry
geofency:

{% configuration %} mobile_beacons: description: List of beacon names that are to be treated as mobile. The name must match the name you configure in Geofency. By default, beacons will be treated as stationary. required: false type: list {% endconfiguration %}

A full sample configuration for the geofency component is shown below:

# Example configuration.yaml entry
geofency:
  mobile_beacons:
    - car
    - keys

To configure Geofency, you must configure (via the Webhook feature) to send a POST request to your Home Assistant server at http://<ha_server>/api/geofency. Use the default POST format, and 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). Make sure to enable the 'Update Geo-Position' functionality for mobile beacons.