SMART Connect

Important

Connections between SMART and EarthRanger will be available through the new Gundi Portal soon. To configure your integration, kindly reach out to Gundi Support  (support@projectgundi.org) for their assistance. 

 

SMART Connect to EarthRanger

Description

The “SMART Connect to EarthRanger” integration automatically syncs observations recorded in SMART Connect as Events within EarthRanger.

Scope

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

 

Prerequisites 

EarthRanger

  • EarthRanger site URL.
  • Event Types created for each relevant query. 
 
 

SMART Connect

  • Server URL.
  • Server credentials configured for this integration.
  • List of queries to be mapped to EarthRanger Event Types.
 
 

 

Configurations

EarthRanger

1 Create a Special User

  1. Log in to EarthRanger.
  2. Create a user with the username smart_to_er.
  3. Assign superuser status to this special user.

2 Create an Event Provider

  1. Navigate to Event Providers in the EarthRanger admin interface.
  2. Create a new event provider with the following details:
  3. Description: SMART Connect
  4. User: smart_to_er
  5. Provider: SMART Connect
  6. URL: https://mountelgonconnect.smartconservationtools.org/server
  7. Provider API Username: [Provided by the requester]
  8. Provider API Password: [Provided by the requester]
 
 

SMART

None required.

 
 

Gundi

1 Log in to Gundi

  1. Navigate to Gundi v1.

2 Verify Organization

  1. Confirm that an organization exists for the smart_to_er user under Organizations.

3 Create a New Inbound Connection

  1. Create a connection:
    1. Name: Provide an appropriate name for this connection.
    2. Organization: Select the relevant organization.
    3. Type: Choose “SMART Connect Query”.
    4. Endpoint: (e.g., https://sandbox.pamdas.org/api/v1.0)
  2. Authentication Token: Use the token linked to the smart_to_er EarthRanger user.
 
 

 

Limitations

Observations older than 30 days will not be processed.

The following functionalities are not supported:

  • Updates and deletions
  • Attachments
  • Movement data

The integration operates on a 30-minute cycle for collecting new SMART observations.

 

Next Steps

Once the configuration is complete, wait 30 minutes and perform the following actions in EarthRanger:

  1. Verify that the list of event sources accurately represents the available queries.
  2. Map the relevant event sources with existing event types.
  3. 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.

 

Future Plans

 This integration will soon be available in the new portal.

 

Resources

Guide for Support and Deployment Partners Link

 

 
 

EarthRanger to SMART

Coming soon.

 
 

 

Was this article helpful?