OpenWeather

Supported technology/Weather Station

openweathermap.org

Direction Data provider
Data Sensor readings (stationary subjects)
Platform Gundi v2
Type Pull integration

Setup You, in the portal

OpenWeather sends current weather conditions for the places you choose to EarthRanger through Gundi. Gundi checks OpenWeather on a schedule, and each place shows up as a stationary subject with its latest readings.

What you'll receive

We add details here as we confirm what OpenWeather sends. If you know something we're missing, let us know.

Positions Yes, one stationary subject per location you add in the Route settings, named with the name you give it and placed at its latitude and longitude. There is no physical station: the readings are OpenWeather's current conditions for that spot.
Alerts and events No
Sensor readings Temperature (with feels-like, minimum and maximum), pressure, humidity, visibility, wind speed, direction and gusts, cloud cover, rain and snow, a weather description, sunrise and sunset, in the Units System you choose (metric, imperial or standard).
Photos and files No
Past data No. Each check sends only the current conditions, and only when OpenWeather has a newer reading than the last one sent.

How this integration works

This is a pull integration. Gundi checks the data provider for new data on a schedule, using the account details you enter in the Route, and passes what it finds on to your destination.

Who's involved

  • You create the Route in Gundi and enter your provider account details, or give them to Gundi support when the setup badge says so.
  • The data provider keeps your account and devices active.
  • Your destination, for example EarthRanger, is where the data shows up.
  • Gundi support helps only when the setup badge at the top of this page says so.

Historical data

When you first connect, Gundi fetches a limited amount of past data. How far back it goes depends on the integration and is shown under "Past data" above.

When data doesn't show up

Check your Route Activity Logs first: wrong account details and provider outages show up there. Then check with the provider that your devices are reporting.

How often data arrives

Gundi checks on a schedule. Where we know how often, it's shown under "Data Pull Frequency" on this page. New data arrives after the next check, plus the time the device takes to upload it to the provider.

Prerequisites

OpenWeather

You will need:

EarthRanger

To send event data to EarthRanger, you will need:

  • A special EarthRanger user (e.g., “Gundi Service Account”) for this integration. Please refer to EarthRanger's documentation or contact Support.
  • A long-lived token for authentication assigned to the user created in the previous step. Please refer to EarthRanger's documentation or contact Support.

Considerations

OpenWeather’s FAQ notes that new API keys may take a few hours before they become active.

Your API key will be activated automatically, up to 2 hours after your successful registration. We invite you to read the API documentation that explains how to use our APIs.

https://openweathermap.org/faq 

Configuration

GUIDES

I. Gundi Connection Settings

Login to Gundi.

Click on Create Route.

Select OpenWeatherMap.

Select your Workspace.

Enter a name for this Route (e.g., “Weather Station - AccountName”)

Configure your OpenWeatherMap API key.

Under Weather Monitoring Locations, add each place you want weather for: a name (shown as the stationary subject on the EarthRanger map), a latitude and a longitude.

Choose the Units System: metric, imperial or standard.

Click Next.

Click Add destination on the flow map and select a destination. Please consult our guide.

II. EarthRanger Settings

The following configurations are optional:

1. Select the data you want to see in the map.

1.1. Log in to EarthRanger as an admin (site.pamdas.org/admin).
1.2. Go to Source Providers.
1.3. Select the Source Provider created for this integration (e.g., "gundi_openweather_UUID")

The Source Provider is automatically created after Gundi successfully retrieves data from this integration and pushes it to EarthRanger.  If you don't find it, please ensure your Route includes a destination, and review the Route Activity Logs for additional details. You should see some records mentioning that Gundi successfully delivered data to EarthRanger.
Important Note:  OpenWeather API keys may remain inactive for up to two hours after creation (source). Please verify your connection after this period.

1.3. Click on Subject Details Configuration.
1.4. Configure the additional information you would like to see on the map.

2. Configure these Subjects as a “Weather Station”.

3. Assign your Subjects to a Subject Group.

Please refer to EarthRanger's documentation or contact Support.

Screenshots

 

Data Pull Frequency

Approximately every 20 minutes.

Other Weather Station

TAHMO ZENTRA Cloud Stevens Connect
Vital Weather
Back to the integration catalog Need help setting this up? Contact us