Supported technology/Marine Domain Awareness
| Platform | Gundi v2 |
| Type | Pull integration |
| Data | Events |
| Direction | Data provider |
Skylight sends vessel alerts for your marine Areas of Interest to EarthRanger through Gundi. Gundi checks your Skylight account on a schedule, and each alert shows up as an event on the map.
What you'll receive
We add details here as we confirm what Skylight sends. If you know something we're missing, let us know.
| Positions | No |
| Alerts and events | Yes, for the event types you pick: fishing_alert_rep (Fishing), detection_alert_rep (Vessel Detection, from satellite), speed_range_alert_rep, entry_alert_rep (Marine Entry), dark_rendezvous_alert_rep and standard_rendezvous_alert_rep. Gundi updates an event when Skylight updates it. See Skylight Event Types. |
| Sensor readings | No. Each event carries details on the vessels involved (name, MMSI, type, flag, length), speed, heading, distance and duration, time spent in the area for entries, Skylight's scores as percentages, the satellite source, and a link to the event in Skylight. |
| Photos and files | Yes. When Skylight has a satellite image for the event, such as a vessel detection, it is attached to the event. |
| Past data | Yes. Each check covers events that started in the last 30 days, and picks up new events and changes since the last check. You can change this with Days to fetch data from in the Route settings, up to 540 days. |
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:
- Skylight account.
- At least one Area of Interest (AOI) defined in that Skylight account. You no longer need its unique identifier — Gundi lists the AOIs your account can see and you pick one from a dropdown.
Data Delivery
EarthRanger
- 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.
- Confirm that the required event types and schemas are configured in EarthRanger. Consult our references here.
- Update the EarthRanger user (e.g., “Gundi Service Account”) to give it permission to the event type.
Smart Connect
- Ensure that the necessary categories and attributes are established in your SMART CA data model beforehand. Consult our references here.
Supported Skylight Event Types
The event types Skylight sends, and the EarthRanger event types they become, are listed in Skylight Event Types.
For more information, visit Skylight's knowledge base.
Configuration in Gundi
Login to Gundi.
Click on Create Route.
Select Skylight.
Configure your Skylight credentials under Username and Password. Enter these first: Gundi uses them to look up the Areas of Interest your account can see.
Under Area of Interest (AOI) IDs, click Add Item and choose an AOI from the dropdown. The list shows every AOI your Skylight account has access to, by name and size (for example, Maputo — 5,743 km²), so there is no need to copy an identifier across from Skylight. Repeat for each AOI you want to pull events from.
Pasting an identifier still works. If you already have an AOI identifier, you can type or paste it instead of picking from the list, and existing configurations keep working unchanged.
The identifier must belong to the same Skylight account as the credentials above. If it does not, Gundi skips that AOI and records a warning rather than pulling events, so double-check it against the dropdown.
Select the Skylight event types of interest.
- By default select “Dark Rendezvous”, “Standard Rendezvous”, “Vessel Detection”, and “Fishing”.
- Visit Entry (Skylight Help Center) to learn more about the user needs and conditions that benefit from Entry events.
- Visit Speed Range (Skylight Help Center) to learn more about the user needs and conditions that benefit from Speed Range events.
Select your Workspace.
Enter a name for this Route (e.g., “Skylight - AccountName”)
Click Next.
Click Add destination on the flow map and select a destination. Please consult our guide.
Next Steps
EarthRanger
Coming soon..
SMART Connect
Coming soon..
Data Pull Frequency
Approximately every 10 minutes.
Other Marine Domain Awareness
| CSIRO |
| Back to the integration catalog | Need help setting this up? Contact us |
