Robbie Trencheny 86b7c07ad6
iOS docs update
2017-04-22 16:57:03 -07:00

3.0 KiB
Raw Blame History

layout, title, description, date, sidebar, comments, sharing, footer, redirect_from
layout title description date sidebar comments sharing footer redirect_from
page Location Documentation about the location tracking abilities in Home Assistant for iOS 2016-10-25 15:00:00 -0700 true false true true /ecosystem/ios/location/

{% linkable_title Location tracking when outside a Home Assistant zone %}

Home Assistant for iOS receives significant location updates from iOS. Whenever an update is received, it is sent to Home Assistant. Roughly, an update is received everytime that your device transfers to a new cellular tower, a significant amount of time has passed (usually a couple hours) or a connection state changes and the system notices your location recently changed.

Apple defines significant significant-change location updates as:

The significant-change location service delivers updates only when there has been a significant change in the devices location, such as 500 meters or more.

They also say in the Energy Efficiency Guide:

Significant-change location updates wake the system and your app once every 15 minutes, at minimum, even if no location changes have occurred.

Finally, I think this answer from Stack Overflow says it best:

The significant location change is the least accurate of all the location monitoring types. It only gets its updates when there is a cell tower transition or change. This can mean a varying level of accuracy and updates based on where the user is. City area, more updates with more towers. Out of town, interstate, fewer towers and changes.

What's the real story on significant-change location updates? Who knows, because Apple keeps it private.

{% linkable_title Location tracking in Home Assistant zones %}

At launch, Home Assistant for iOS sets up geofences for all zones in your Home Assistant configuration. Enter and exit notifications are sent to Home Assistant.

Configuration

Add track_ios: false to your zone configurations to disable zone location tracking for all connected iOS apps.

iBeacons

As of 1.0.3 the app has basic support for using iBeacons to trigger enter/exit updates. To configure them, add your iBeacon details to your zone like this:

zone.home:
  beacon:
    uuid: B9407F30-F5F8-466E-AFF9-25556B57FE6D
    major: 60042
    minor: 43814

Restart Home Assistant and then the iOS app. It will begin then begin using iBeacons instead of your location for enter and exit triggers around your zones. To add an iBeacon to zone.home add the above under your customize.