spaceapi component allow Hackerspaces to expose information to web apps or any other application with the SpaceAPI.
To setup the
spaceapi component in your installation, add the following to your
# Example configuration.yaml entry spaceapi: space: HACKERSPACE_NAME logo: URL_FOR_LOGO url: URL location: address: ADDRESS contact: email: EMAIL_ADDRESS issue_report_channels: - email state: entity_id: binary_sensor.front_door
(string)(Required)Name of the Hackerspace.
(URL)(Required)URL of the hackerspace’s web site.
(map)(Required)Location of the Hackerspace.
(map)(Required)Contact information of the Hackerspace.
(List)(Required)The reporting channel for issues. Pick an entity from
(list)(Required)The current state of the Hackerspace.
entity_idof a binary sensor that represents the current state.
(URL)(Optional)The URL which is publicly accessible of the icon for the open Hackerspace.
(URL)(Optional)The URL which is publicly accessible of the icon for the closed Hackerspace.
(list)(Optional)List of sensors to expose.
The list of sensors can be any sensor, not just temperature or humidity.
The SpaceAPI specification requires every sensor to provide a location. In order to set a sensor specific location do the following steps:
- Go to Configuration -> Customization
- Select the sensor entity
- Pick “Other” from the attribute override pulldown
- Set the attribute name to location and the attribute value to your desired location
If no location is set, the location defined in the HA config is used.
In this section you find some real-life examples of how to use this component.
A possible configuration entry for Eastermundigen, a Hackerspace in Switzerland, could look like this.
# Example configuration.yaml entry spaceapi: space: Eastermundigen logo: https://eastermundigen.ch/logo.png url: https://eastermundigen.ch location: address: "Steinbruchweg 16, 3072 Ostermundigen, Schweiz" contact: phone: "+41311111111" twitter: "@eastermundigen" email: "[email protected]" issue_report_channels: - email state: entity_id: binary_sensor.front_door" icon_open: https://eastermundigen.ch/open.png icon_closed: https://eastermundigen.ch/close.png sensors: temperature: - "sensor.temperature_in" - "sensor.temperature_out" humidity: - "sensor.humidity_in" - "sensor.humidity_out"