iobroker.accuweather

ioBroker.accuweather

accuweather adapter for ioBroker

Weather forecast using AccuWeather API.

Adapter receives

• Current Conditions (updated every hour), (24 requests)
• 5 Days daily forecast (update daily at approximately 7am and 8pm), (2 requests)
• and 12 hours forecast (updated every six hours at 12am, 6am, 12pm and 6pm). (4 requests)

By default, the adapter does only update outdated data when restarting. 50 requests per day are allowed, each restart would require 3 requests to update all data.

Getting started

Get API Key

To get API Key, register on https://developer.accuweather.com/ and create application in My Apps menu. Once the application is created, you will have an API key generated. For free use, it is possible to make 50 requests to API per day. It was noted that to get the API working, the following settings are preferred (please choose your country!):

Get Location Key

In order to get location key, go to https://www.accuweather.com/ and enter your city name, or try to enter your coordinates (latitude, longitude) as you have them, e.g., in ioBroker settings. Your location key will be the number at the end of the forecast URL.

Using in Lovelace visualization (starting version 1.1.0)

The summary channel contains a current and by-day forecast with role/types of states supported by type-detector. New feature can be used in order to show weather forecast in Lovelace UI. For better view a custom lovelace card is created - see https://github.com/algar42/IoB.lovelace.accuweather-card

Changelog

2.1.0 (2025-01-22)

• (ticaki) Change: min. js-controller to 6.0.11
• (ticaki) Change: Outdated data is updated at startup.
• (ticaki) New: Photo link added in current weather
• (ticaki) New: Metric and Imperial are available for selection - Will be taken into account with the next data update.
• (ticaki) New: In the event of a data retrieval error, an attempt is made again after 10 minute
• (ticaki) Remove admin option (restart blocking)
• (ticaki) Rewritten in Typescript
• (ticaki) For error codes from the 400 series, do not attempt any unscheduled reconnections.

2.0.1 (2025-01-18)

• (ticaki) BREAKING: Requires Nodejs 20 or higher
• (ticaki) BREAKING: Command states are now buttons and only respond to ack=false.
• (ticaki) admin option: No data is updated on adapter startup (default: true).
• (ticaki) apikey renamed and encrypted
• (ticaki) Dependencies and eslint updated
• (devtronic) Add nextHour.CloudCover

1.5.0 (2024-06-23)

• (xdaamg) limit updates to once an hour, this fixes part of issue #273.
• (mcm1957) Adapter requires js-controller >= 5 and admin >= 6 now
• (mcm1957) Node 22 support has been added to testing
• (mcm1957) Dependencies have been updated

1.4.0 (2024-04-02)

• (mcm1957) Adapter requires node.js 18 and js-controller >= 5 now
• (mcm1957) Dependencies have been updated

1.3.2 (2023-12-04)

• (ticaki) fixed: dependencies
• (ticaki) fixed: error message [object Object]

1.3.1 (2023-08-15)

• (isi07) added the Wind Direction Text und Cloud Cover
• (bluefox) Added json config

1.2.4 (2022-02-08)

• (algar42) Depency updates

1.2.3 (2021-12-29)

• (algar42) HoursOfSun Parameter added to the Daily forecast

1.2.1 (2021-07-22)

• (bluefox) Updated logo

1.2.0 (2021-07-03)

• (Garfonso) adjust roles to properly detect weather forecast in Summary folder. (Summary objects need to be deleted and adapter restarted after that)

1.1.7 (2021-06-24)

• (bluefox) Create device for device-detector

v1.1.6 (2021-05-05)

Minor bug fixes to Object.common section

1.1.5 (2021-01-25)

• (algar42) Resolve log Warning for js-controller 3.2

1.1.4

• (HGlab01) small bugfix regarding setTimeout range

1.1.3 (2020-03-04)

• (algar42) Minor updates for compact mode

1.1.0 (2019-11-09)

• (algar42) Summary channel added to support type-detector and automatic weather device creation

1.0.2 (2019-09-12)

• (algar42) Production Release

License

MIT License

Copyright (c) 2024-2025 iobroker-community-adapters [e-mail] Copyright (c) 2021-2023 algar42 [e-mail]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.