Skip to content

v0.3.0 - Safety Zone status: outside-usual-area sensor + tracker attributes

Choose a tag to compare

@positionguard positionguard released this 27 Aug 11:15
· 10 commits to main since this release

What's new in v0.3.0

New: Safety Zone status. A dedicated binary_sensor.<member>_outside_usual_area per member per group, enabled by default. on only for a confirmed out-of-zone status — a stale position never triggers it, and if the server has no safety data for a member (feature not yet enabled on their account, or they're muted or in a public group), the sensor goes unavailable rather than pretending
everything is fine.

When available, three new attributes ride along on the existing tracker entities: safety_status (at_area / in_zone / out_of_zone / stale), safety_area (their own matched place, when you're allowed to see it), and position_age_seconds.

See the README's new "Getting notified when someone is outside their usual area" section for a copy-paste automation example.

Docs: added a multi-instance / multi-site support section covering running the integration across multiple HA instances.

Compatibility

Requires Safety Zone status enabled on the member's PositionGuard account (rolling out now with the iOS 2.0 / Android 0.9.0 release).
No configuration changes — entity IDs and setup are unchanged from v0.2.6.
The new binary sensor is enabled by default; disable it in entity settings if you don't want it.

Installation

Available as a custom repository in HACS:

  1. HACS → three-dot menu → Custom repositories
  2. Repository URL: https://github.com/positionguard/positionguard-homeassistant
  3. Category: Integration
  4. Install, then restart Home Assistant

HACS will offer the update to existing installs automatically.