1. 6 China Region Coastline Warning 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
      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
      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. 6 China Region Coastline Warning Dataset

6.1 China Region Navigational Warnings

GET
https://api.elaneglobal.com/v1/Warning/NavigationalWarnings

Description#

The China Region Navigational Warnings is used to query navigation warning data in China’s coastal areas, including military operations, vessel drills, live-fire exercises, vessel operations, buoy dynamics, vessel grounding, vessel sea trials, shipwrecks, casualties, construction operations and other events.
The data is sourced from the China Maritime Safety Administration (MSA).

Use Cases#

Vessel Navigation Safety
Hazard Area Avoidance
Navigation warning data helps vessels stay away from dangerous zones, such as military exercise areas, shipwreck areas, sand mining operation areas, etc.
For example, when the maritime authority issues a navigation warning for military exercises in a certain sea area, vessels can adjust their routes according to the data to avoid entering the zone, thus reducing risks such as collisions and accidental intrusion into hazardous areas.
Port Management
Port Operation Optimization
Port authorities can use navigation warning data to grasp the dynamics of incoming vessels in advance and arrange port operations reasonably, including berth allocation, pilotage services, etc.
Port Safety Assurance
Timely access to navigation warnings around ports helps port authorities monitor navigation safety in surrounding waters and prevent accidents such as vessel collisions and groundings.
Maritime Big Data Analysis
Risk Assessment
Shipping companies can conduct risk assessments using navigation warning data, analyze the risk level of specific routes or areas, and provide a basis for insurance pricing and risk management.

Request Limits#

This is a premium service that requires advanced permission application prior to use.
An API key must be created before using this service. The corresponding monitored fleet vessels and push receiving URL must be configured under the API key.
To view your current service access permissions, please contact our support team: support@elaneglobal.com.

Endpoint#

EndpointHTTP Method
https://api.elaneglobal.com/v1/Warning/NavigationalWarningsGET

Example API Call#

https://api.elaneglobal.com/v1/Warning/NavigationalWarnings?key=1F6D701272402D1E7D8D316CCE519123&start_time=2024-07-21%2020:00&end_time=2024-09-21%2020:00
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.

Request

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.elaneglobal.com/v1/Warning/NavigationalWarnings?key=1F6D701272402D1E7D8D316CCE519123&start_time=2024-07-21 20:00&end_time=2024-09-21 20:00&warning_type'

Responses

⚪0success
application/json
Body

Example
{
    "status": 0,
    "msg": "",
    "total": 158,
    "data": [
        {
            "warning_type": 12,
            "source": "中国海事局",
            "title": "TRIAL VOYAGE-H561-SD442/25",
            "range_type": 2,
            "range_points": "120.233333,38.416667;120.450000,38.416667;120.450000,38.208333;120.233333,38.279167&121.716667,38.500000;121.916667,38.500000;121.916667,38.250000;121.716667,38.333333&123.166667,37.800000;123.191667,37.800000;123.191667,37.783333;123.166667,37.783333",
            "expire_time": "2025-07-14 12:00:00",
            "pub_time": "2025-07-09 13:40:00",
            "content": "<p align=\"justify\">SD442/25,BOHAI STRAIT,&nbsp;FROM &nbsp;092200UTC&nbsp;&nbsp;TO &nbsp;111400UTC&nbsp;&nbsp;JUL,H561 TRIAL VOYAGE IN AREA 1 BOUNDED BY THE LINES JOINING 38-25.00N 120-14.00E、38-25.00N 120-27.00E、38-12.50N 120-27.00E、38-16.75N 120-14.00E&nbsp;AND AREA 2 BOUNDED BY THE LINES JOINING 38-30.00N 121-43.00E、38-30.00N 121-55.00E、38-15.00N 121-55.00E、38-20.00N 121-43.00E.FROM &nbsp;111400UTC&nbsp;&nbsp;TO &nbsp;120200UTC&nbsp;&nbsp;JUL,H561 TRIAL VOYAGE IN AREA 3 BOUNDED BY THE LINES JOINING 37-48.00N 123-10.00E、37-48.00N 123-11.50E、37-47.00N 123-11.50E、37-47.00N 123-10.00E.FROM 120200UTC TO 141200UTC JUL,H561 TRIAL VOYAGE IN AREA 2 BOUNDED BY THE LINES JOINING 38-30.00N 121-43.00E、38-30.00N 121-55.00E、38-15.00N 121-55.00E、38-20.00N 121-43.00E.CAUTION TO AVOID. SHANDONG MSA CHINA.</p>"
        },
        {
            "warning_type": 12,
            "source": "中国海事局",
            "title": "黄浦江7月11日水上交通管制-沪航警455/25",
            "range_points": "",
            "pub_time": "2025-07-09 13:15:00",
            "content": "<p style=\"text-indent: 2em;\">沪航警455/25黄浦江7月11日0815时至0945时,在黄浦江苏州河口至轮渡泰公线之间水域范围内进行帆船展示,届时实行水上交通管制,请过往船舶注意。</p>"
        },
        {
            "warning_type": 12,
            "source": "中国海事局",
            "title": "中华人民共和国重庆海事局航行警告(渝航警50/25)",
            "pub_time": "2025-07-09 13:00:00",
            "content": "<p><strong>渝航警</strong><strong>50</strong><strong>/25</strong>“长江救捞一号”轮拖带“航道趸03604”由猪圈门航道码头(长江上游航道里程723km)至扁担石航道基地(长江上游航道里程731km)。</p>\n\n<p>计划运行时刻:拟定于2025年7月10日1000时船队在猪圈门航道码头编队开航上行,1100时抵达扁担石航道基地。</p>\n\n<p>请过往船舶加强瞭望,主动与该拖带船队联系,辨明动态,提早统一会让意图,谨慎操作,以策安全。</p>"
        },
        {
            "warning_type": 3,
            "source": "中国海事局",
            "title": "冀航警379/25 军事任务",
            "range_points": "",
            "pub_time": "2025-07-09 11:28:00",
            "content": "<p>冀航警379/25,渤海,7月10日0000时至7月11日2400时,</p>\n\n<p>以N&nbsp;39°24′35″、E&nbsp;119°13′44″为顶点,正东方向至N&nbsp;39°24′35″、E&nbsp;119°17′32″,再至N&nbsp;39°19′21″、E&nbsp;119°29′47″端点,顶点正南偏西6°方向至N&nbsp;39°11′16″、E&nbsp;119°11′54″端点,以顶点为中心半径25公里的部分圆弧将两个端点连接,形成不规则的闭合范围。该区域内进行实弹射击活动。禁止驶入。</p>"
        },
        {
            "warning_type": 12,
            "source": "中国海事局",
            "title": "MILITARY MISSION——LN222/25",
            "range_type": 2,
            "range_points": "121.636667,38.861667;121.636667,38.570000;121.131667,38.565000;121.235000,38.803333",
            "expire_time": "2025-07-27 16:00:00",
            "pub_time": "2025-07-09 11:00:00",
            "content": "<p>LN222/25&nbsp;BOHAI STRAIT AND NORTH YELLOW SEA MILITARY MISSION IN AREA BOUNDED BY THE LINES JOINING 38-51.7N121-38.2E,38-34.2N121-38.2E,38-33.9N121-07.9E,38-48.2N121-14.1E FROM 130800UTC TO 270800UTC JUL.ENTERING PROHIBITED. LIAONING MSA CHINA.</p>"
        },
        {
            "warning_type": 1,
            "source": "中国海事局",
            "title": "军事任务——辽航警222/25",
            "range_type": 2,
            "range_points": "121.636667,38.861667;121.636667,38.570000;121.131667,38.565000;121.235000,38.803333",
            "expire_time": "2025-07-27 16:00:00",
            "pub_time": "2025-07-09 10:59:00",
            "content": "<p>辽航警222/25,渤海海峡黄海北部,自7月13日1600时至27日1600时在38-51.7N121-38.2E、38-34.2N121-38.2E、38-33.9N121-07.9E、38-48.2N121-14.1E诸点连线范围内执行军事任务。禁止驶入。</p>"
        },
        {
            "warning_type": 12,
            "source": "中国海事局",
            "title": "YANGANGRONGHEQIHAO AND YANGANGRONGHEBAHAO   TOWING ZHAOSHANGZHONGGONG3-SD441/25",
            "range_type": 4,
            "range_points": "121.450000,37.600000;121.583333,37.666667;122.158333,37.666667;122.275000,37.520833;122.263333,37.507000;122.228333,37.480000",
            "expire_time": "2025-07-11 16:00:00",
            "pub_time": "2025-07-09 10:53:00",
            "content": "<p>SD441/25,BOHAI SEA,FROM 090800UTC TO &nbsp;110800UTC JUL,TUG YANGANGRONGHEQIHAO AND YANGANGRONGHEBAHAO TOWING ZHAOSHANGZHONGGONG3,FROM 37-36.00N 121-27.00E&nbsp;TO 37-28.25N 122-13.83E,MAINLY VIA:37-40.00N 121-35.00E, 37-40.00N 122-09.50E,37-31.24N 122-16.50E,37-30.42N 122-15.80E, 37-28.80N 122-13.70E,TOWING LENGTH 400 METERS,SPEED 5 KNOTS.CAUTION TO AVOID.SHANDONG MSA CHINA.</p>"
        },
        {
            "warning_type": 12,
            "source": "中国海事局",
            "title": "拖带作业-烟港融合七号、烟港融合八号拖带招商重工3-鲁航警494/25",
            "range_type": 4,
            "range_points": "121.45,37.6;122.230556,37.470833;121.583333,37.666667;122.158333,37.666667;122.275,37.404;122.263333,37.390333;122.228333,37.363",
            "expire_time": "2025-07-11 16:00:00",
            "pub_time": "2025-07-09 10:52:00",
            "content": "<p>鲁航警494/25,渤海海峡,7月9日1600时至11日1600时,烟港融合七号、烟港融合八号拖带招商重工3,自37-36.00N 121-27.00E至37-28.25N 122-13.83E,主要经过以下各点:37-40.00N 121-35.00E、37-40.00N 122-09.50E、37-31.24N 122-16.50E、37-30.42N 122-15.80E、37-28.80N 122-13.70E,拖带长度400米,航速5节。注意避让。</p>"
        },
        {
            "warning_type": 4,
            "source": "中国海事局",
            "title": "水深测量—津航警242/25",
            "expire_time": "2025-07-25 18:00:00",
            "pub_time": "2025-07-09 09:36:00",
            "content": "<p>津航警242/25&nbsp;天津港 自7月10日至25日,每天0600时至1800时,由顺航测11轮在大沽口港区大沽沙航道及附近水域进行水深测量作业。希各航船注意。</p>"
        },
        ......
    ]
}
Previous
5.3 Global Marine Weather
Next
7.1 Monitored Fleet Management
Built with