1. 1 AIS Dataset
ShipFinder
  • Global Maritime Data API Documentation
  • 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
      GET
  • 6 China Region Coastline Warning Dataset
    • 6.1 China Region Navigational Warnings
      GET
  • 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
    • 7.5 Arrival/Departure Event Push
    • 7.6 Vessel Dynamic ETA Push
    • 7.7 Vessel AIS Signal Loss Event Push
    • 7.8 Vessel STS Event Push
  • 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. 1 AIS Dataset

1.1 Vessel Position

Description#

The Vessel Position retrieves the basic static information and real-time dynamic information of a vessel by its MMSI, including the vessel’s IMO number, call sign, vessel name , vessel type, length and breadth, as well as the real-time position, navigation status, destination port, real-time speed, estimated time of arrival (ETA), heading and course over ground (COG) from the latest AIS report.

Use Cases#

Single Vessel Position Search enables you to track the real-time position and status information of a single vessel. For a fixed fleet, you may also use Multi-Vessel Position Search or Fleet Position Search to return identical results. This single-vessel search is more suitable if your monitored vessels change frequently (e.g., frequent chartering of temporary vessels).
This service is subject to access volume limits. If you require high-frequency vessel position updates, the Vessel Position Push is recommended—it updates vessel position data every 10 minutes and monitors all vessels in a designated fleet list.

Request Limits#

An API key must be created before using this service. This API has no access frequency limits—unlimited calls are allowed once access permission is granted. To apply for or inquire about your access permission, please contact our support team: support@elaneglobal.com.

Endpoint#

APIEndpointHTTP Method
Single Vessel Positionhttps://api.elaneglobal.com/v1/AIS/VesselPositionSingle GET
Multi-vessel Positionhttps://api.elaneglobal.com/v1/AIS/VesselPositionMulti GET
Fleet Positionhttps://api.elaneglobal.com/v1/AIS/FleetPositionGET

Example API call#

Single Vessel Position
https://api.elaneglobal.com/v1/AIS/VesselPositionSingle?key=1F6D701272402D1E7D8D316CCE519123&mmsi=413961925
Multi-vessel Position
https://api.elaneglobal.com/v1/AIS/VesselPositionMulti?key=1F6D701272402D1E7D8D316CCE519123&mmsis=413961925,477232800,477172700
Fleet Position
https://api.elaneglobal.com/v1/AIS/FleetPosition?key=1F6D701272402D1E7D8D316CCE519123&fleet_id=3e42a3db-6cdf-4c62-9473-8ad00348d646
Note:
The key 1F6D701272402D1E7D8D316CCE519123 is the official key of elaneglobal.com, bound to the domain api.elaneglobal.com.
Users are not authorized to use this key for data access—utilizing it will return a status code 14, indicating an error in the source domain.
To trial the service, please contact our support team: support@elaneglobal.com. To use Fleet Position Search, you must first create your designated fleet. The fleet’s association with the correct application API key will be verified at query time. A validation will run at query time to confirm the fleet is linked to the proper application API key. For more information about Fleet Position Search, please contact our support team: support@elaneglobal.com.
Previous
Global Maritime Data API Documentation
Next
1.1.1 Single Vessel Position