Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
maxLevel3
indent16px
excludeIntroduction|Contents

...

Overview

The Open Weather OpenWeather Map plugin allows you to map different weather states to system profiles so that when the weather state changes it will automatically update the system profile based on the mapping within the Witness software by using an API request to OpenWeatherMap.org.

As the weather conditions change the plugin can be used to dynamically change the sensitivity of the system to maintain an optimal detection performance. This covers weather like high winds which cause a lot more movement in the radar's detection area that we need to ignore, or, there are extreme weather conditions like heavy rain which require different detection parameters.

Here is a link to the Open Weather OpenWeather Map site: https://openweathermap.org/. OpenWeather.

Here is a link to their API information: https://docs.openweather.co.uk/api/one-call-3.

...

You will need to create an account with Open Weather OpenWeather to obtain an API key to enable the plugin to work. https://home.openweathermap.org/users/sign_up

...

Info

The default Update Interval setting of 1800 seconds (30 mins) is currently within the free 1000 requests per day limit.

Configuring the Open Weather OpenWeather Map Plugin in Witness

To configure the Open Weather OpenWeather Map Plugin:

  1. Select the Open Weather OpenWeather Map Plugin from Integration Configurations:

  2. The plugin details will be displayed on the right hand side of the screen. Click Edit:

  3. You can now edit the plugin settings. Please refer to https://navtechradar.atlassian.net/wiki/spaces/TUN/pages/2594406593/Open+Weather+Map+Plugin#Settings.

  4. Click the Plugin Enabled checkbox to enable it and enter your App Id. This can be found in your OpenWeather API keys page:

  5. Then you can start mapping Weather States to System Profiles by clicking the ➕ button:

  6. Select a Weather State from the drop down menu:

  7. Choose an appropriate System Profile for the Weather State:

  8. Repeat the process for other weather conditions and when you have completed the mapping click the Save button:

  9. Once the plugin has been configured and saved the system will also display the Latest Weather Response Info below:

  10. You will receive notifications when a change in the weather triggers a profile change:

...