1. 7 Event Dataset
ElaneGlobal
  • 1 AIS Dataset
    • 1.1 Vessel Position
      • 1.1.1 Single Vessel Position
      • 1.1.2 Multi-vessel Position
      • 1.1.3 Fleet Position
    • 1.2 Vessel Search
      GET
    • 1.3 Vessels Nearby
      GET
    • 1.4 Vessels in Zone
      GET
    • 1.5 Vessel Flag Information
      GET
  • 2 Voyage Dataset
    • 2.1 Port Information
      GET
    • 2.2 Currently Berthed Vessels
      GET
    • 2.3 Currently Anchored Vessels
      GET
    • 2.4 Inbound / Expected Arrivals
      GET
  • 3 History Dataset
    • 3.1 Vessel History Track
      GET
    • 3.2 Ship-to-Ship (STS) Events
      GET
    • 3.3 Vessel Port Call History
      GET
    • 3.4 Vessel Port Call Records at Specific Port
      GET
    • 3.5 Vessel Current Port Call
      GET
    • 3.6 Port Calls Records for Port
      GET
  • 4 Prediction Dataset
    • 4.1 Point-to-Point Route Planning
      GET
    • 4.2 Port-to-Port Route Planning
      GET
    • 4.3 ETA Query
      GET
  • 5 Meteorology Dataset
    • 5.1 Global Tropical Cyclone
      • 5.1.1 Global Tropical Cyclones List
      • 5.1.2 Tropical Cyclone Details by Point
    • 5.2 Global Port Tide Predictions
      • 5.2.1 Request parameters for Global Tide Gauge Stations List
      • 5.2.2 Query Single Tide Gauge Station Details
    • 5.3 Global Marine Weather
  • 6 China Region Coastline Warning Dataset
    • 6.1 China Region Navigational Warnings
  • 7 Event Dataset
    • 7.1 Monitored Fleet Management
      • 7.1.1 Create Fleet
      • 7.1.2 Update Fleet Information
      • 7.1.3 Query Fleet
      • 7.1.4 Delete Fleet
      • 7.1.5 Add Vessels to Fleet
      • 7.1.6 Batch Update Vessels in Fleet
      • 7.1.7 Remove Vessels from Fleet
    • 7.2 Geofence Monitoring Push
      • 7.2.1 Geofence Creation
      • 7.2.2 Geofence Update
      • 7.2.3 Geofence Query
      • 7.2.4 Geofence Deletion
      • 7.2.5 Geofence Monitoring Push
    • 7.3 Vessel Speed Alert Push
      • 7.3.1 Add Vessel Speed Alert Subscription
      • 7.3.2 Delete Vessel Speed Alert Subscription
      • 7.3.3 Query Vessel Speed Alert Subscription List
      • 7.3.4 Vessel Speed Anomaly Push
    • 7.4 Real-time Vessel Position Push
      POST
    • 7.5 Arrival/Departure Event Push
      POST
    • 7.6 Vessel Dynamic ETA Push
      POST
    • 7.7 Vessel AIS Signal Loss Event Push
      POST
    • 7.8 Vessel STS Event Push
      POST
  • Appendix
    • Vessel Type Comparison Table
    • Service Return Code
    • Sea Area Reference Table
    • Navigation Status Comparison Table
    • Deviation Node List
    • Aids to Navigation (AtoN) Type Table
  1. 7 Event Dataset

7.2 Geofence Monitoring Push

Description#

The Geofence Monitoring Push service allows you to set geofence boundaries and alert rules. Alerts will be triggered and push notifications sent to the pre-configured URL when vessels enter the designated area.
Three geofence alert modes are supported:
1.
All Vessels: Alerts are triggered for all vessels entering or exiting the area, suitable for port management, supervision and similar scenarios.
2.
Filtered by Criteria: Rules can be set based on vessel type and length. Alerts are triggered when matching vessels enter the area, suitable for bridge anti-collision, illegal fishing supervision, etc.
3.
Fleet Vessels: Monitors your own managed vessels; alerts are triggered when they enter the area, suitable for logistics or internal vessel dynamic supervision.
Geofences can be created and managed via API, or through the web interface in the Dashboard. You may create any number of geofences, but the number of alert rules is controlled by permissions. To add more alert rules, please contact our support team.

Use Cases#

Freight Logistics & Vessel Management
Real-time Vessel Monitoring & Route Optimization
Geofences can be used to define boundaries for waterways, ports or distribution centers. Combined with real-time AIS position data, geofence alerts (e.g., area entry/exit) are automatically triggered to enable real-time vessel tracking.
Port Dispatching
Port Operation & Dispatching
Geofences can mark port anchorage areas and operation zones. Real-time status of vessels entering/exiting anchorages, crossing channels, berthing at docks can be obtained. Combined with vessel type, registry, dimensions, draft and other data, dispatching plans can be adjusted dynamically.
Bridge Anti-Collision
Bridge Anti-Collision Early Warning
Geofence alerts can be configured for areas surrounding bridges to monitor key parameters including vessel type and length. Alerts will be automatically triggered for dangerous goods vessels or vessels exceeding the specified length threshold, enabling early tracking of vessels with collision risks.
Maritime Supervision & Law Enforcement
Illegal Activity Monitoring
Set geofences in sensitive areas such as fishing prohibition zones, offshore wind farms and sand mining areas. Combined with AIS tracks and video surveillance, illegal operations can be automatically detected.
High-Risk Area Monitoring
Define risk levels via geofences for high-risk areas such as the Gulf of Aden (piracy-prone) and military exercise zones, with alerts triggered by real-time AIS positions.
Asset Protection & Theft Prevention
Monitor vessels around offshore oil and gas platforms using geofences; alerts are triggered on abnormal approach.

Request Limits#

This is a premium service that requires advanced permission application prior to use.
An API key must be created in the Dashboard before using this service. The corresponding monitored fleet vessels and push receiving URL must be configured under the API key.
Your current service access permissions can be viewed in the Dashboard. Please contact our support team to activate service permissions.

Endpoint#

Query TypeEndpointHTTP Method
Geofence Creationhttps://api.shipxy.com/apicall/v3/AddAreaPOST
Geofence Updatehttps://api.shipxy.com/apicall/v3/UpdateAreaPOST
Geofence Queryhttps://api.shipxy.com/apicall/v3/GetAreaGET
Geofence Deletionhttps://api.shipxy.com/apicall/v3/DeleteAreaPOST
Geofence Monitoring PushConfigure Data Receiving URL in the DashboardPOST
Previous
7.1.7 Remove Vessels from Fleet
Next
7.2.1 Geofence Creation
Built with