mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-28 13:06:48 +00:00
a4a68172c0
* u-z integrations: apply sentence-style caps to categories * Apply suggestions from code review Co-authored-by: Joakim Sørensen <joasoe@gmail.com> * Add references to glossary terms * Update source/_integrations/universal.markdown Co-authored-by: Joakim Sørensen <joasoe@gmail.com> * Update source/_integrations/universal.markdown Co-authored-by: Joakim Sørensen <joasoe@gmail.com> * linter: change vizio to VIZIO - as per product website https://www.vizio.com/en/smartcast * remove term refs from YAML * VIZIO: change spelling according to website - https://www.vizio.com/en/t * Update source/_integrations/vizio.markdown * Update source/_integrations/universal.markdown * Apply suggestions from code review Co-authored-by: Joakim Sørensen <joasoe@gmail.com> * Update source/_integrations/unifiprotect.markdown Co-authored-by: Joakim Sørensen <joasoe@gmail.com> * Apply suggestions from code review Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com> * Apply suggestions from code review Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com> * Fix some more to sentence-style caps * Update source/_integrations/unifiprotect.markdown Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com> * Update source/_integrations/unifiprotect.markdown Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com> * Update source/_integrations/unifiprotect.markdown Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com> --------- Co-authored-by: Joakim Sørensen <joasoe@gmail.com> Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com>
98 lines
3.5 KiB
Markdown
98 lines
3.5 KiB
Markdown
---
|
|
title: Zone
|
|
description: Instructions on how to set up zones within Home Assistant.
|
|
ha_category:
|
|
- Organization
|
|
- Presence detection
|
|
ha_release: 0.69
|
|
ha_quality_scale: internal
|
|
ha_codeowners:
|
|
- '@home-assistant/core'
|
|
ha_domain: zone
|
|
ha_integration_type: system
|
|
---
|
|
|
|
Zones allow you to specify certain regions on earth (for now). When a device tracker sees a device to be within a zone, the state will take the name from the zone. Zones can also be used as a [trigger](/docs/automation/trigger#zone-trigger) or [condition](/docs/scripts/conditions/#zone-condition) inside automation setups.
|
|
|
|
Zones can be added and managed through the user interface at **{% my zones title="Settings -> Areas & Zones" %}**.
|
|
|
|
|
|
|
|
You can add a zone in the user interface by specifying the GPS coordinates or dragging the icon on the map. You can adjust the zone radius (except for the Home zone) by changing the size of the zone circle.
|
|
|
|
Zones can also be configured via `configuration.yaml`:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
zone:
|
|
- name: School
|
|
latitude: 32.8773367
|
|
longitude: -117.2494053
|
|
radius: 250
|
|
icon: mdi:school
|
|
|
|
- name: Work
|
|
latitude: 32.8753367
|
|
longitude: -117.2474053
|
|
|
|
# This will override the default home zone
|
|
- name: Home
|
|
latitude: 32.8793367
|
|
longitude: -117.2474053
|
|
radius: 100
|
|
icon: mdi:account-multiple
|
|
```
|
|
|
|
{% configuration %}
|
|
name:
|
|
description: The friendly name of the zone.
|
|
required: true
|
|
type: string
|
|
latitude:
|
|
description: The latitude of the center point of the zone.
|
|
required: true
|
|
type: float
|
|
longitude:
|
|
description: The longitude of the center point of the zone.
|
|
required: true
|
|
type: float
|
|
radius:
|
|
description: The radius of the zone in meters.
|
|
required: false
|
|
type: integer
|
|
default: 100
|
|
icon:
|
|
description: The icon to show instead of name.
|
|
required: false
|
|
type: string
|
|
passive:
|
|
description: To only use the zone for automation and hide it from the frontend and not use the zone for device tracker name.
|
|
required: false
|
|
type: boolean
|
|
default: false
|
|
{% endconfiguration %}
|
|
|
|
To find the latitude/longitude of a certain place you can use [Google Maps](https://www.google.com/maps/) or [Bing Maps](https://www.bing.com/maps). Just right click and copy the coordinates from there (Bing) or click on the "What is here?" (Google)
|
|
|
|
## Home zone
|
|
|
|
If no configuration is given, the `zone` integration will create a zone for home. This zone will use location provided in the `configuration.yaml` file and have a radius of 100 meters. To override this, create a zone configuration in `configuration.yaml` (see above) and name it **'Home'**. Overriding the Home zone via the UI is not supported.
|
|
|
|
<div class='note'>
|
|
|
|
Devices that are in the zone **'Home'** will not appear on the map in the Home Assistant UI. To apply the changes to the **'Home'** `zone`, you must restart Home Assistant.
|
|
</div>
|
|
|
|
## Icons
|
|
|
|
It is recommended that you pick an icon to use for your zone. Pick any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/) and prefix the name with `mdi:`. For example `mdi:school`, `mdi:briefcase`, `mdi:home`, `mdi:cart`, or `mdi:castle`.
|
|
|
|
## State
|
|
|
|
The state of a zone is a number, which represents the number of
|
|
{% my people title="persons" %} that are currently in a zone.
|
|
|
|
The number of persons in a zone can be helpful for automations, for example,
|
|
to determine if someone is home, or home alone, or no-one is at home at all.
|
|
The same applies to all other zones.
|