openuv component displays UV and Ozone data from openuv.io.
To generate an API key, simply log in to the OpenUV website.
The “Limited” plan (which is what new users are given by default) is limited to 500 API requests per day. In order to leave a buffer, the
openuv component queries the API every 30 minutes by default. This value can be modifed (via the
scan_interval key), but please note that over-running the API will require
you to upgrade to a paid plan (and may disable your access in the meantime).
To retrieve data from OpenUV, add the following to your
openuv: api_key: YOUR_OPENUV_API_KEY
To configure additional functionality, add configuration options beneath a
sensor key within the
openuv section of
configuration.yaml as below:
openuv: api_key: YOUR_OPENUV_API_KEY binary_sensors: # binary sensor configuration options... sensors: # sensor configuration options...
(string)(Required)your OpenUV API key
(int)(Optional)the frequency (in seconds) between data updates
Default value: 1800
(map)(Optional)binary sensor-related configuration options
(map)(Optional)sensor-related configuration options
(list)(Optional)the conditions to create sensors from
Default value: all (
This sensor displays
true if UV protection (sunscreen, etc.) is recommended at the current date and time; displays
This sensor displays the current ozone level in du (Dobson Units).
This sensor displays the current UV index.
This sensor displays the level of current UV index, which is calculated based on UV Index Levels & Colors.
This sensor displays the maximum UV index that will be encountered that day (at solar noon).
These sensors display the approximate number of minutes a particular skin type can be exposed to the sun before burning/tanning starts. Each sensor depicts a skin type based on the Fitzpatrick scale:
- Skin Type I
- Skin Type II
- Skin Type III
- Skin Type IV
- Skin Type V
- Skin Type VI
The above guidelines constitude estimates and are intended to help informed decision making. They should not replace analysis, advice, or diagnosis from a trained medical professional.