Zone

A zone in Home Assistant is a virtual representation of a physical space. Think of it as drawing a circle on a map; that circle represents a zone. Zones are used to track the location of people and devices but can also be used to trigger automations based on entering or leaving a zone.

Spook adds new actions to the zone integrations that allow you to manage and modify them using automations dynamically.

Devices & entities¶

Spook does not provide any new devices or entities for this integration.

Actions¶

Spook adds the following new actions to your Home Assistant instance:

Create a zone¶

Adds a new zone to your Home Assistant instance.

The radius attribute must be entered in meters.

1
2
3
4
5
6
7
action: zone.create
data:
  name: "Statue of Liberty"
  icon: mdi:human-female-dance
  latitude: 40.6892494
  longitude: -74.0445004
  radius: 250

Update a zone¶

Updates properties of an existing zone.

The radius attribute must be entered in meters. Only the parameters that are provided will be updated. Other parameters will remain unchanged.

1
2
3
4
5
action: zone.update
data:
  entity_id: zone.statue_of_liberty
  name: "Statue of Liberty, New York"
  radius: 250

Delete a zone¶

Deletes a zone from Home Assistant

1
2
3
action: zone.delete
data:
  entity_id: zone.statue_of_liberty

1
2
3
4
5
action: zone.delete
data:
  entity_id:
    - zone.central_park
    - zone.statue_of_liberty

Repairs¶

Spook has no repair detections for this integration.

Uses cases¶

Some use cases for the enhancements Spook provides for this integration:

• You could use these action to dynamically create and update zones around a car or a person using automations. Using these you could tell who is close to the car or notify if you are near a certain person.

Blueprints & tutorials¶

There are currently no known blueprints or tutorials for the enhancements Spook provides for this integration. If you created one or stumbled upon one, please let us know in our discussion forums.

Features requests, ideas, and support¶

If you have an idea on how to further enhance this integration, for example, by adding a new action, entity, or repairs detection; feel free to let us know in our discussion forums.

Are you stuck using these new features? Or maybe you’ve run into a bug? Please check the Support page on where to go for help.