From dc22250e937c3fbef99ae4e68c52a16a9b4cf6a9 Mon Sep 17 00:00:00 2001 From: Michael <35783820+mib1185@users.noreply.github.com> Date: Sat, 3 Feb 2024 13:02:19 +0100 Subject: [PATCH] make things clearer in proximity (#31208) Co-authored-by: Franck Nijhof --- source/_integrations/proximity.markdown | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/source/_integrations/proximity.markdown b/source/_integrations/proximity.markdown index 770a6330dd6..600442d1b8c 100644 --- a/source/_integrations/proximity.markdown +++ b/source/_integrations/proximity.markdown @@ -30,12 +30,12 @@ The following sensor entities will be created. ### Distance -For each tracked device or person, a sensor showing the distance from the monitored zone in a unit depending on your [Home Assistant Unit System](/docs/configuration/basic) selection is created. +For each tracked [device](/integrations/device_tracker/) or [person](/integrations/person/), a sensor is created showing the distance from the monitored zone in a unit depending on your [Home Assistant Unit System](/docs/configuration/basic) selection. When a tracked person or device enters the monitored zone, the distance is set to 0. You can use the [Min/Max](/integrations/min_max) integration to determine the nearest and furthest distance. ### Direction of travel -For each tracked device or person, a sensor showing the direction of travel to or from the monitored zone is created. Possible states are: +For each tracked device or person, a sensor is created showing the direction of travel to or from the monitored zone. Possible states are: - `arrived` - `away_from` @@ -45,4 +45,8 @@ For each tracked device or person, a sensor showing the direction of travel to o ### Nearest device -A sensor showing the device or person which is nearest to the monitored zone is created. +A sensor is created showing the device or person which is nearest (_shortest distance_) to the monitored zone. If several devices or persons are at the same nearest distance, this sensor displays them all. + +
+To calculate the distance and the direction of travel for a tracked device or person, they must specify a geo-location. +