jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-15 05:16:49 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add additional proximity sensors (#31236)

Browse Source 
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Michael 2024-02-05 08:51:38 +01:00 committed by Franck Nijhof
parent b62689e682
commit fea7c5cbea
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3
1 changed files with 17 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
source/_integrations/proximity.markdown
View File

@ -31,7 +31,6 @@ The following sensor entities will be created.
### Distance
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
@ -43,10 +42,24 @@ For each tracked device or person, a sensor is created showing the direction of
- `towards`
- `unknown`
<div class="note">
To calculate the distance and the direction of travel for a tracked device or person, they must specify a geo-location.
</div>
### Nearest device
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.
<div class="note">
To calculate the distance and the direction of travel for a tracked device or person, they must specify a geo-location.
</div>
### Nearest distance
This sensor shows the distance of the device or person nearest to the monitored zone. The unit depends on your settings for the [Home Assistant unit system](/docs/configuration/basic). When a tracked person or device enters the monitored zone, the distance is set to 0.
### Nearest Direction of travel
This sensor shows the direction of travel of the nearest device or person to the monitored zone. Possible states are:
- `arrived`
- `away_from`
- `stationary`
- `towards`
- `unknown`