2.9 KiB
| layout | title | description | date | sidebar | comments | sharing | footer | logo | ha_category | ha_qa_scale | ha_release |
|---|---|---|---|---|---|---|---|---|---|---|---|
| page | Zone | Instructions on how to set up zones within Home Assistant. | 2015-10-04 09:23 | true | false | true | true | home-assistant.png | Organization | internal | 0.69 |
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 or condition inside automation setups.
The zone component uses YAML sequences to configure multiple zones:
# 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: false 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 or Bing Maps. Just right click and copy the coordinates from there (Bing) or click on the "What is here?" (Google)
{% linkable_title Home zone %}
If no configuration is given, the zone component 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 and name it 'Home'.
Devices that are in the zone **'Home'** will not appear on the map in the Home Assistant UI.
{% linkable_title Icons %}
It is preferred to pick an icon to use for your zone. Pick any icon that you can find on materialdesignicons.com and prefix the name with mdi:. For example mdi:school, mdi:worker, mdi:home, mdi:cart, or mdi:castle.
{% linkable_title State %}
zoning is the state a zone has when it is configured. A zone doesn't have another state; all configured zones are zoning all the time.