Release Version: AlphaRelease VersionAlpha

Setup Instructions

1. Creating the Credentials

Before creating an integration, you must first add your GeoExplorer API credentials.

You will need:

  • API address – The base URL of your GeoExplorer API server.
    Example: http://192.168.1.10:1100/api
  • API Key – A key generated from GeoExplorer in the Admin > Projects menu.

IMSURGE uses these values to authenticate and request a session from the GeoExplorer API.

2. Creating the Integration

After the credentials are added, select the following:

  • Sensor – The sensor ID you wish to pull processed measurements from.

Once selected, IMSURGE automatically handles authorization, data retrieval, timestamp sync, and parsing.

Concerns & Limitations

  • Session-Based Authentication
    GeoExplorer requires a temporary SessionID created from your API Key. If the SessionID expires or becomes invalid, the integration may fail until the next pipeline run re-authenticates.

  • Processed Measurements Only
    This integration uses GetSensorMeasurementsRequest and returns processed measurement values. Raw unprocessed telemetry is not supported.

  • Timestamp Requirements
    GeoExplorer expects UTC timestamps in ISO 8601 format. IMSURGE handles this automatically, but custom system clocks or non-UTC sensor metadata may affect results.

Reference

GeoExplorer sensors typically update at fixed internal intervals. Choose a polling rate consistent with your sensor’s reporting frequency.

Data TypesMinimumRecommendedMaximum
All15min30min24hr
FieldDescriptionRequired
API addressThe GeoExplorer API base URL (e.g., http://IP:PORT/api). Must include protocol.✓
API Key16-character key required to authorize a session.✓
FieldDescriptionRequired
SensorThe sensor ID returned by the api’s sensor list.✓

External References