mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 09:17:06 +00:00
Actual zone docs
This commit is contained in:
parent
0ad162717c
commit
2109e1f917
60
source/components/zone.markdown
Normal file
60
source/components/zone.markdown
Normal file
@ -0,0 +1,60 @@
|
||||
---
|
||||
layout: page
|
||||
title: "Zone"
|
||||
description: "Instructions how to setup zones within Home Assistant."
|
||||
date: 2015-10-04 09:23
|
||||
sidebar: false
|
||||
comments: false
|
||||
sharing: true
|
||||
footer: true
|
||||
---
|
||||
|
||||
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.html#zone-trigger) or [condition](/components/automation.html#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
|
||||
# Optional radius in meters (default: 100)
|
||||
radius: 250
|
||||
# Optional icon to show instead of name
|
||||
icon: group-work
|
||||
|
||||
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: social:people
|
||||
```
|
||||
|
||||
#### {% 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. By default, Home Assistant includes most of the
|
||||
[material icons](https://www.google.com/design/icons/). See [the source][icon-source] for a specific list which
|
||||
categories are included.
|
||||
|
||||
For all but the action category you will need to prefix the icon name with its category. For example
|
||||
`social:people` or `av:radio`. For the action category, you will not need to do this, examples are
|
||||
`home`, `work,`, `group-work` and `shopping-cart`.
|
||||
|
||||
[icon-source]: https://github.com/balloob/home-assistant-polymer/blob/master/src/resources/home-assistant-icons.html#L3
|
Loading…
x
Reference in New Issue
Block a user