Website: https://smartconservationtools.org/en-us/
Tags: Conservation Software, SMART to EarthRanger, SMART Queries, Pull Integration
This integration require 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!
Prerequisites
SMART
- List of SMART Connect queries to integrate.
- SMART Connect Server URL.
- SMART Connect Server username and password set up for this integration.
EarthRanger
- Admin access to EarthRanger.
- Create an event type for each SMART Connect query to be connected to EarthRanger
- Create a special EarthRanger user (e.g.,
smart_to_er) with 'Admin User Events' permission.- Please refer to EarthRanger's documentation or contact Support.
- Create a long-lived token for the special user.
- Please refer to EarthRanger's documentation or contact Support.
- Create an Event Provider. Consult this guide:
Description: “SMART Connect”
Owner: smart_to_er
Provider API: [Provided by the requester] e.g., “https://example.smartconservationtools.org/server”
Provider API Username: [Provided by the requester]
Provider API Password: [Provided by the requester]
Scope
Supported
When a query is linked to an EarthRanger Event Type, the results are transferred and stored in EarthRanger as Events. The attributes and details of these Events are determined by the data within the query results.
Supported query types include:
- patrolobservation
- patrolwaypoint
- observationobservation
- observationwaypoint
- entityobservation
- patrolquery
Notes:
Observations older than 30 days will not be processed.
The integration operates on a 30-minute cycle for collecting new SMART observations.
Not Supported
This integration does not support:
- Movement data.
- Deletes.
- Updates.
- Attachments.
Resources
Configure Gundi
Go to Gundi v1
Go to the Inbound Integrations and select Add Integration
Inbound Configuration
Name: Enter a suitable name (e.g., "Sitename - SMART to EarthRanger")
Owner: Select the integration's owner
Type: SMART Connect Query
Provider Key: Leave empty. It will automatically give it a name.
Default Device Group: Leave empty. Gundi will automatically create a default group.
Endpoint: EarthRanger site URL (e.g., https://sandbox.pamdas.org/api/v1.0)
Token: Use the token linked to the smart_to_er EarthRanger user.
Login/Password: Leave empty
State:
{}Internal Documentation for Support
Next Steps
Once the configuration is complete, wait 30 minutes and perform the following actions in EarthRanger:
- Verify that the list of event sources accurately represents the available queries in the SMART Connect server.
- Map the relevant event sources with existing event types.
- Verify that the SMART observations are created as events in EarthRanger. Note that it may take up to 30 minutes for data to appear or for the schema to adjust. The integration operates on a 30-minute cycle for collecting new SMART observations.
Need Help?
Contact Support
If you need help with Gundi, here are some resources to try.
Contact the Gundi team
Send an email to support@earthranger.com with your questions or a description of the issue you have been experiencing.
Help Us Improve Gundi
If you have comments, corrections or suggestions regarding our guides, website, or the Gundi portal, please email them to support@earthranger.com.
Feel free to explore our website for more contact information.
Last Update: Feb 26, 2025