ZENTRA Cloud

Supported technology/Weather Station

metergroup.com/platform/zentra-cloud

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

Setup You, in the portal

ZENTRA Cloud sends weather station readings to EarthRanger through Gundi. Gundi checks ZENTRA Cloud on a schedule for each device you list, and each device shows up as a stationary subject with its readings.

What you'll receive

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

Positions Yes, one stationary subject per device serial number you list in the Route settings, named with the serial number. ZENTRA Cloud doesn't share coordinates, so each device is placed where you set it in Device Locations, or at latitude 0, longitude 0 without one, which EarthRanger doesn't show on the map.
Alerts and events No
Sensor readings Every measurement the device reports, named as ZENTRA Cloud names it (for example air temperature), each with its value, precision and any error flag and description.
Photos and files No
Past data Yes. The first time Gundi sees a device, it fetches the last 24 hours. After that, each check picks up from the last reading sent, up to 1,000 readings per device per check.

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

Data Source

You will need:

  • ZENTRA Cloud authentication token.
  • List of device identifiers.

Data Delivery

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.

Configuration in Gundi

Login to Gundi.

Click on Create Route.

Select ZENTRA Cloud.

Under API URL, choose the ZENTRA Cloud server that hosts your devices (US, EU or TAHMO).

Configure your ZENTRA Cloud account token under Token.

Click  Add Item and input a device serial number. Do this for as many devices as you have.

Under Device Locations, add each device's serial number with its latitude and longitude. ZENTRA Cloud doesn't share coordinates, so a device without a location is placed at 0,0 and doesn't show on the EarthRanger map.

Select your Workspace.

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

Click Next.

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

Next Steps

EarthRanger

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_zentracloud_UUID")

The Source Provider is automatically created after Gundi successfully retrieves data from this integration and pushes it to EarthRanger. 

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.

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.

 
 

Data Pull Frequency

Approximately every 5 minutes.

Other Weather Station

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