Xweather Forecast API (formerly AerisWeather) - uajqq/weewx-belchertown-new GitHub Wiki

Xweather's Forecast API (formerly AerisWeather) is where the current observations and forecast data comes from. The skin will work without this integration, however it is used to show current weather observations and icons as well as the forecast.

You must sign up to use their service. This skin does not provide any forecast data. You need to join their website and get a free developer key. In order to get a free developer key, you have to send your weather data to pwsweather.com - which is an integration built into weewx. You just need to activate it! Once enabled, by default the skin will download and cache every hour.

• If you haven't already; sign up for pwsweather at https://www.pwsweather.com/register
• Add a new station, and configure your weewx.conf to start sending your weather data to pwsweather.
• Then sign up for a free Xweather developer account by linking your pwsweather account here https://signup.xweather.com/pws-contributor
• Once you are logged in, you should make a Demo Project as part of the sign up process, then go to https://account.xweather.com/data/apps and and save these keys as forecast_api_id and forecast_api_secret.
• The rest of the options can be found below in the Forecast Options table.

Forecast Units

Xweather provides all units in 1 API call which is great but the skin still needs a way to determine what units you want it to show. This is why I've decided to keep the legacy Dark Sky unit method so you can determine which units you'd like Xweather to show. All of the unit determination is now being done within the skin, not the API.

Here's the differences and what's available.

• us: Imperial units (the default)
• ca: same as si, except that wind speed and wind gust are in kilometers per hour
• uk2: same as si, except that visibility is in miles, and wind speed and wind gust in miles per hour
• si: SI units

SI units are as follows:

• chance of precipitation: Centimeters.
• temperature: Degrees Celsius.
• temperature min: Degrees Celsius.
• temperature max: Degrees Celsius.
• wind speed: Meters per second.
• wind gust: Meters per second.
• visibility: Kilometers.

Forecast Translation

Xweather provides the observations in "weather codes" which allows you to translate these codes to your language. Take a look at the skin.conf and all the forecast_ labels. As with anything in skin.conf, it's advised to copy this to weewx.conf so your changes aren't lost on upgrades. See how to do this in the Translating the Skin section.