7.4 Real-time Vessel Position Push

Description

The Real-time Vessel Position Push service allows you to configure vessels in your monitored fleets. The system automatically monitors the real-time position of your fleet vessels and pushes one packet of real-time position data every 10 minutes. The data format is largely consistent with the Real-time Vessel Positioning API.

You must first create fleets and bind vessels in the Dashboard, or create fleets via the Monitored Fleet Management API. Binding will fail if the number of vessels exceeds your permission quota. You may replace the vessel list within your authorized quota.

Use Cases

Freight Logistics & Vessel Management

Cargo Tracking & Supply Chain Management
Shippers and logistics companies can use real-time vessel position data to accurately track vessel location, navigation status, estimated time of arrival and other key information. This allows better planning of subsequent logistics steps such as port handling, warehousing and transportation, optimizing supply chain management and improving the timeliness and accuracy of cargo delivery.

Route Optimization & Scheduling
Shipping companies can dynamically adjust vessel routes and speed based on real-time position data combined with weather, typhoon, tide and other maritime information. This helps vessels avoid severe weather and congested waterways, select optimal routes, improve transportation efficiency and reduce operating costs.

Vessel Operation Management
Ship owners and vessel management companies can monitor their fleet’s status in real time, including position, speed and heading. Abnormal situations such as off-course sailing or unusual speed can be detected and handled promptly to ensure normal operation.
By analyzing vessel position data, companies can further optimize scheduling and properly arrange vessel tasks and port calls.

Request Limit

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 Type	Endpoint	HTTP Method
Real-time Vessel Position Push	Configure Data Receiving URL in the Dashboard	POST

Responses

⚪0success

application/json

Body

Example

{
    "data": [
        {
            "mmsi": 563018400,
            "imo": 9761463,
            "call_sign": "9V3642",
            "ship_name": "XIN LONG YANG",
            "ship_cnname": null,
            "data_source": 0,
            "last_time": 1748330914,
            "lat": 31.375355,
            "lng": 121.687177,
            "ship_type": 80,
            "length": 333,
            "width": 60,
            "left": 37,
            "trail": 56,
            "draught": 5.6,
            "dest": "CXD",
            "destcode": "",
            "eta": 1746979200,
            "navistat": 5,
            "sog": 0,
            "cog": 360,
            "hdg": 118,
            "rot": 0
        },
        {
            "mmsi": 538007628,
            "imo": 9334143,
            "call_sign": "V7VR3",
            "ship_name": "MATSON LANAI",
            "ship_cnname": null,
            "data_source": 1,
            "last_time": 1748329979,
            "lat": 48.37769,
            "lng": 171.07297,
            "ship_type": 70,
            "length": 260,
            "width": 32,
            "left": 17,
            "trail": 68,
            "draught": 10.2,
            "dest": "LONG BEACH,US",
            "destcode": "USLGB",
            "eta": 1748881800,
            "navistat": 0,
            "sog": 22.2198448,
            "cog": 80.6,
            "hdg": 82,
            "rot": 0
        }
    ]
}

7.4 Real-time Vessel Position Push

Description#

Use Cases#

Freight Logistics & Vessel Management#

Request Limit#

Endpoint#