56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
---
|
|
layout: page
|
|
title: "Zone"
|
|
description: "Instructions how to setup zones within Home Assistant."
|
|
date: 2015-10-04 09:23
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: home-assistant.png
|
|
ha_category: Organization
|
|
---
|
|
|
|
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](/components/automation/#zone-trigger) or [condition](/components/automation/#zone-condition) inside automation setups.
|
|
|
|
Zones support the usual method to specify multiple zones, use keys `zone:`, `zone 2:` etc.
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
zone:
|
|
name: School
|
|
latitude: 32.8773367
|
|
longitude: -117.2494053
|
|
radius: 250
|
|
icon: mdi:school
|
|
|
|
zone 2:
|
|
name: Work
|
|
latitude: 32.8753367
|
|
longitude: -117.2474053
|
|
|
|
# This will override the default home zone
|
|
zone 3:
|
|
name: Home
|
|
latitude: 32.8793367
|
|
longitude: -117.2474053
|
|
radius: 100
|
|
icon: mdi:account-multiple
|
|
```
|
|
|
|
Configuration variables:
|
|
|
|
- **name** (*Optional*): Friendly name of entry.
|
|
- **latitude** (*Required*): Latitude of the center point of the zone.
|
|
- **longitude** (*Required*): Longitude of the center point of the zone.
|
|
- **radius** (*Optional*): Optional radius in meters. Defaults to 100 meters.
|
|
- **icon** (*Optional*): Optional icon to show instead of name.
|
|
|
|
|
|
#### {% linkable_title Home zone %}
|
|
|
|
If no configuration is given, the `zone` component will create a zone for home. This zone will use location given in the `configuration.yaml` file and have a radius of 100 meters. To override this, create a zone configuration and name it **'Home'**.
|
|
|
|
#### {% linkable_title Icons %}
|
|
|
|
It is preferred to pick an icon to use for your zone. Pick any zone that you can find on [materialdesignicons.com](https://materialdesignicons.com/) and prefix the name with `mdi:`. For example `mdi:school`, `mdi:worker`, `mdi:home`, `mdi:cart`, or `mdi:castle`.
|