Supported technology/IoT Systems and Device Management
| Data | Movement data |
| Type | Push integration |
| Direction | Data provider |
Devices on The Things Network send their positions to EarthRanger through Gundi. Positions show up as tracks on the map.
What you'll receive
We add details here as we confirm what The Things Network sends. If you know something we're missing, let us know.
| Positions | Yes |
| Alerts and events | Not documented yet |
| Sensor readings | Not documented yet |
| Photos and files | No |
| Past data | No |
How this integration works
This is a push integration. The data provider sends data to Gundi whenever it has something new, on its own schedule. Gundi passes each piece on to your destination as soon as it arrives.
Who's involved
- You create the Route in Gundi and share its API key with the data provider.
- The data provider turns on sending to Gundi with that key.
- 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
Gundi passes on whatever the provider sends, old or new. Gundi can't ask the provider for past data, so if you need history, ask the provider whether they can send it again.
When data doesn't show up
Gundi doesn't check the provider for new data; it waits for the provider to send it. If nothing arrives, check with the provider first that they are sending, then look at your Route Activity Logs.
How often data arrives
That depends on how often the provider sends it. Some send each reading right away, others in batches every few minutes or hours.
Overview
Prerequisites
Analysis
- Information about the devices connected to The Things Network (brand, model).
- Information about the data sent by these devices. Our team can help in exploring the data.
- Access to The Things Network
Data Fetch
- Access to The Things Network.
- Devices configured and sending data through the network.
Data Delivery
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 our Support team. -
A long-lived token for authentication assigned to the user created in the previous step.
Please refer to EarthRanger's documentation or contact our Support team.
Configuration
This integration requires assistance from our support team for setup and configuration. Please contact our support team at support@earthranger.com and we’ll guide you through the process to ensure everything is set up correctly.
We are actively working to make this integration self-service in the future. Stay tuned for updates!
GUIDES
1. Configuration in Gundi
These steps can only be performed by the development team. We are actively working to make this integration self-service in the future. Stay tuned for updates!
Tasks:
- Set up a connection using a Custom Webhook.
- Visit the Connection and take note of its API key, as it will be required in the next step.
- Configure the webhook using JQ* (requires help from the Gundi Development team).
2. Configuration in The Things Network
- Log in to The Things Network using your account.
- Find the “Application” containing the device(s).
- Navigate to “Webhooks”.
- Click on +Add webhook.
- Select Custom webhook.
-
Write a name for your webhook under “Webhook ID” (for example:
gundi-webhook). -
Select
JSONas the Webhook format. -
Type
https://hooks.gundiservice.orgas the Base URL. -
Add two header entries:
- apikey. Value provided by the Gundi Team.
-
x-gundi-integration-type. Value:
generic_webhooks
Example:
- Select the box “Uplink message”
- Click on Add webhook.
3. Configuration in EarthRanger
The following configurations are optional:
3.1. Select the data you want to see in the map.
3.1.1 Log in to EarthRanger as an admin (site.pamdas.org/admin).
3.1.2 Go to
Source Providers.
3.1.3 Select the
Source Provider created for this integration (e.g.,
"webhook_the_things_network")
3.1.4 Click on Subject Details Configuration.
3.1.5 Configure the
additional information you would like to see on the map.
3.2 Assign your Subjects to a Subject Group.
3.3 Rename your Subjects
Please refer to EarthRanger's documentation or contact Support.
Troubleshooting
If your devices are not showing in the destination system (e.g., EarthRanger), please check if your devices are sending their location to The Things Network.
- Navigate to the appropriate Application and click on “Message Storage”. Confirm if the decoded payload includes location. Example:
-
Navigate to the appropriate Application and click on “Live Data”. Confirm if the decoded
payload includes location.
Notice the lack of location data in the following example:
Other IoT Systems and Device Management
| Liquid Intelligence Technologies | Sigfox | JVA |
| Connected Conservation Foundation | Kerlink |
| Back to the integration catalog | Need help setting this up? Contact us |
