openapi: 3.2.0 info: title: ShipFinder Global Maritime Data 6 China Region Coastline… description: Verbatim assembly of the per-endpoint OpenAPI 3.0.1 fragments ShipFinder publishes on docs.shipfinder.com (one fragment per endpoint page, indexed by the provider llms.txt). Path items are reproduced exactly as published; only the enclosing document (info/servers/tags) is API Evangelist assembly. No operation content was altered. version: 1.0.0 servers: [] tags: - name: 6 China Region Coastline Warning Dataset paths: /v1/Warning/NavigationalWarnings: get: summary: 6.1 China Region Navigational Warnings deprecated: false description: '## 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 | Endpoint | HTTP Method | |----------|-------------| | `https://api.elaneglobal.com/v1/Warning/NavigationalWarnings` | GET | ## 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.' tags: - 6 China Region Coastline Warning Dataset parameters: - name: key in: query description: Your personal Shipfinderer API key to verify service permissions required: true example: 1F6D701272402D1E7D8D316CCE519123 schema: type: string - name: start_time in: query description: Used to filter the publish time of navigation warnings. required: true example: 2024-07-21 20:00 schema: type: string - name: end_time in: query description: Used to filter the publish time of navigation warnings. required: true example: 2024-09-21 20:00 schema: type: string - name: warning_type in: query description: 'Filter by warning type. 0=Default (all types returned); 1=Military operations; 2=Vessel drills; 3=Live-fire exercises; 4=Vessel operations; 5=AtoN (Aids to Navigation) dynamics; 6= Vessel grounding; 7=Vessel sea trials; 8=Sinking / Shipwreck; 9=Casualties; 10=Construction operations; 11=Navigation warning cancellation; 12=Others' required: false schema: type: string responses: '0': description: '' content: application/json: schema: type: object properties: status: type: integer msg: type: string total: type: integer description: Total number of navigation warnings within the query period data: type: array items: type: object properties: warning_type: type: integer description: 1=Military operations; 2=Vessel drills; 3=Live-fire exercises; 4=Vessel operations; 5=AtoN (Aids to Navigation) dynamics; 6= Vessel grounding; 7=Vessel sea trials; 8=Sinking / Shipwreck; 9=Casualties; 10=Construction operations; 11=Navigation warning cancellation; 12=Others source: type: string description: China Maritime Safety Administration (MSA) title: type: string description: Navigation warning title range_type: type: integer description: 1=Single coordinate point; 2=Polygon area; 3=Circular area; 4=No coordinate information range_points: type: string description: 'Coordinate system WGS84. Longitude and latitude are separated by comma , . Multiple coordinates are separated by semicolon ;.Multiple areas are separated by &.' expire_time: type: string description: 'Format: YYYY-MM-DD HH:MM, UTC+8' pub_time: type: string description: 'Format: YYYY-MM-DD HH:MM, UTC+8' content: type: string description: Navigation warning content required: - warning_type - source - title - range_points - pub_time - content - range_type - expire_time x-apifox-orders: - warning_type - source - title - range_type - range_points - expire_time - pub_time - content description: Navigation warning information required: - status - msg - total - data x-apifox-orders: - status - msg - total - data example: "{\n \"status\": 0,\n \"msg\": \"\",\n \"total\": 158,\n \"data\": [\n {\n \"warning_type\": 12,\n \"source\": \"中国海事局\",\n \"title\": \"TRIAL VOYAGE-H561-SD442/25\",\n \"range_type\": 2,\n \"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\",\n \"expire_time\": \"2025-07-14 12:00:00\",\n \"pub_time\": \"2025-07-09 13:40:00\",\n \"content\": \"

SD442/25，BOHAI STRAIT, FROM  092200UTC  TO  111400UTC  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 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  111400UTC  TO  120200UTC  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.

\"\n },\n {\n \"warning_type\": 12,\n \"source\": \"中国海事局\",\n \"title\": \"黄浦江7月11日水上交通管制-沪航警455/25\",\n \"range_points\": \"\",\n \"pub_time\": \"2025-07-09 13:15:00\",\n \"content\": \"

沪航警455/25黄浦江7月11日0815时至0945时，在黄浦江苏州河口至轮渡泰公线之间水域范围内进行帆船展示，届时实行水上交通管制，请过往船舶注意。

\"\n },\n {\n \"warning_type\": 12,\n \"source\": \"中国海事局\",\n \"title\": \"中华人民共和国重庆海事局航行警告（渝航警50/25）\",\n \"pub_time\": \"2025-07-09 13:00:00\",\n \"content\": \"

渝航警50/25“长江救捞一号”轮拖带“航道趸03604”由猪圈门航道码头（长江上游航道里程723km）至扁担石航道基地（长江上游航道里程731km）。

\\n\\n

计划运行时刻：拟定于2025年7月10日1000时船队在猪圈门航道码头编队开航上行，1100时抵达扁担石航道基地。

\\n\\n

请过往船舶加强瞭望，主动与该拖带船队联系，辨明动态，提早统一会让意图，谨慎操作，以策安全。

\"\n },\n {\n \"warning_type\": 3,\n \"source\": \"中国海事局\",\n \"title\": \"冀航警379/25 军事任务\",\n \"range_points\": \"\",\n \"pub_time\": \"2025-07-09 11:28:00\",\n \"content\": \"

冀航警379/25，渤海，7月10日0000时至7月11日2400时，

\\n\\n

以N 39°24′35″、E 119°13′44″为顶点，正东方向至N 39°24′35″、E 119°17′32″，再至N 39°19′21″、E 119°29′47″端点，顶点正南偏西6°方向至N 39°11′16″、E 119°11′54″端点，以顶点为中心半径25公里的部分圆弧将两个端点连接，形成不规则的闭合范围。该区域内进行实弹射击活动。禁止驶入。

\"\n },\n {\n \"warning_type\": 12,\n \"source\": \"中国海事局\",\n \"title\": \"MILITARY MISSION——LN222/25\",\n \"range_type\": 2,\n \"range_points\": \"121.636667,38.861667;121.636667,38.570000;121.131667,38.565000;121.235000,38.803333\",\n \"expire_time\": \"2025-07-27 16:00:00\",\n \"pub_time\": \"2025-07-09 11:00:00\",\n \"content\": \"

LN222/25 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.

\"\n },\n {\n \"warning_type\": 1,\n \"source\": \"中国海事局\",\n \"title\": \"军事任务——辽航警222/25\",\n \"range_type\": 2,\n \"range_points\": \"121.636667,38.861667;121.636667,38.570000;121.131667,38.565000;121.235000,38.803333\",\n \"expire_time\": \"2025-07-27 16:00:00\",\n \"pub_time\": \"2025-07-09 10:59:00\",\n \"content\": \"

辽航警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诸点连线范围内执行军事任务。禁止驶入。

\"\n },\n {\n \"warning_type\": 12,\n \"source\": \"中国海事局\",\n \"title\": \"YANGANGRONGHEQIHAO AND YANGANGRONGHEBAHAO TOWING ZHAOSHANGZHONGGONG3-SD441/25\",\n \"range_type\": 4,\n \"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\",\n \"expire_time\": \"2025-07-11 16:00:00\",\n \"pub_time\": \"2025-07-09 10:53:00\",\n \"content\": \"

SD441/25,BOHAI SEA,FROM 090800UTC TO  110800UTC JUL,TUG YANGANGRONGHEQIHAO AND YANGANGRONGHEBAHAO TOWING ZHAOSHANGZHONGGONG3,FROM 37-36.00N 121-27.00E 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.

\"\n },\n {\n \"warning_type\": 12,\n \"source\": \"中国海事局\",\n \"title\": \"拖带作业-烟港融合七号、烟港融合八号拖带招商重工3-鲁航警494/25\",\n \"range_type\": 4,\n \"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\",\n \"expire_time\": \"2025-07-11 16:00:00\",\n \"pub_time\": \"2025-07-09 10:52:00\",\n \"content\": \"

鲁航警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节。注意避让。

\"\n },\n {\n \"warning_type\": 4,\n \"source\": \"中国海事局\",\n \"title\": \"水深测量—津航警242/25\",\n \"expire_time\": \"2025-07-25 18:00:00\",\n \"pub_time\": \"2025-07-09 09:36:00\",\n \"content\": \"

津航警242/25 天津港 自7月10日至25日，每天0600时至1800时，由顺航测11轮在大沽口港区大沽沙航道及附近水域进行水深测量作业。希各航船注意。

\"\n },\n ......\n ]\n}" headers: {} x-apifox-name: success security: [] x-apifox-folder: 6 China Region Coastline Warning Dataset x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/7948067/apis/api-431872073-run operationId: getV1WarningNavigationalWarnings x-operation-id-source: derived x-evidence: harvested: '2026-08-09' index: https://docs.shipfinder.com/llms.txt index_http_status: 200 fragments: 40 note: Each path item was extracted verbatim from the "## OpenAPI Specification" yaml block on the corresponding docs page. The provider publishes no consolidated OpenAPI document. sources: - path: /v1/AIS/FleetPosition method: GET title: 1.1.3 Fleet Position source: https://docs.shipfinder.com/430293359e0.md - path: /v1/AIS/VesselFlagInfo method: GET title: 1.5 Vessel Flag Information source: https://docs.shipfinder.com/429919472e0.md - path: /v1/AIS/VesselPositionMulti method: GET title: 1.1.2 Multi-vessel Position source: https://docs.shipfinder.com/430292321e0.md - path: /v1/AIS/VesselPositionSingle method: GET title: 1.1.1 Single Vessel Position source: https://docs.shipfinder.com/428990613e0.md - path: /v1/AIS/VesselSearch method: GET title: 1.2 Vessel Search source: https://docs.shipfinder.com/428749512e0.md - path: /v1/AIS/VesselsInZone method: GET title: 1.4 Vessels in Zone source: https://docs.shipfinder.com/429583708e0.md - path: /v1/AIS/VesselsNearby method: GET title: 1.3 Vessels Nearby source: https://docs.shipfinder.com/429003024e0.md - path: /v1/Event/AddFleet method: POST title: 7.1.1 Create Fleet source: https://docs.shipfinder.com/432035260e0.md - path: /v1/Event/AddGeofence method: POST title: 7.2.1 Geofence Creation source: https://docs.shipfinder.com/433382008e0.md - path: /v1/Event/AddVesselSpeedAlert method: POST title: 7.3.1 Add Vessel Speed Alert Subscription source: https://docs.shipfinder.com/433460139e0.md - path: /v1/Event/AddVesselToFleet method: POST title: 7.1.5 Add Vessels to Fleet source: https://docs.shipfinder.com/432100231e0.md - path: /v1/Event/DeleteFleet method: POST title: 7.1.4 Delete Fleet source: https://docs.shipfinder.com/432076110e0.md - path: /v1/Event/DeleteFleetVessel method: POST title: 7.1.7 Remove Vessels from Fleet source: https://docs.shipfinder.com/432106004e0.md - path: /v1/Event/DeleteGeofence method: DELETE title: 7.2.4 Geofence Deletion source: https://docs.shipfinder.com/433422419e0.md - path: /v1/Event/DeleteVesselSpeedAlert method: POST title: 7.3.2 Delete Vessel Speed Alert Subscription source: https://docs.shipfinder.com/433471968e0.md - path: /v1/Event/GetFleet method: GET title: 7.1.3 Query Fleet source: https://docs.shipfinder.com/432057101e0.md - path: /v1/Event/GetGeofence method: GET title: 7.2.3 Geofence Query source: https://docs.shipfinder.com/433414777e0.md - path: /v1/Event/UpdateFleetInfo method: POST title: 7.1.2 Update Fleet Information source: https://docs.shipfinder.com/432048484e0.md - path: /v1/Event/UpdateFleetVessel method: POST title: 7.1.6 Batch Update Vessels in Fleet source: https://docs.shipfinder.com/432080706e0.md - path: /v1/Event/UpdateGeofence method: POST title: 7.2.2 Geofence Update source: https://docs.shipfinder.com/433396710e0.md - path: /v1/Event/VesselSpeedAlertList method: GET title: 7.3.3 Query Vessel Speed Alert Subscription List source: https://docs.shipfinder.com/433473614e0.md - path: /v1/History/PortCallRecordsByPort method: GET title: 3.6 Port Calls Records for Port source: https://docs.shipfinder.com/430531632e0.md - path: /v1/History/PortCallRecordsByVessel method: GET title: 3.3 Vessel Port Call History source: https://docs.shipfinder.com/430426234e0.md - path: /v1/History/PortCallRecordsByVesselAtPort method: GET title: 3.4 Vessel Port Call Records at Specific Port source: https://docs.shipfinder.com/430484162e0.md - path: /v1/History/VesselCurrentPortCall method: GET title: 3.5 Vessel Current Port Call source: https://docs.shipfinder.com/430498718e0.md - path: /v1/History/VesselHistoryTrack method: GET title: 3.1 Vessel History Track source: https://docs.shipfinder.com/430346103e0.md - path: /v1/History/VesselStsEvents method: GET title: 3.2 Ship-to-Ship (STS) Events source: https://docs.shipfinder.com/430352093e0.md - path: /v1/Meteorology/CycloneInfo method: GET title: 5.1.2 Tropical Cyclone Details by Point source: https://docs.shipfinder.com/431698143e0.md - path: /v1/Meteorology/CyclonesList method: GET title: 5.1.1 Global Tropical Cyclones List source: https://docs.shipfinder.com/431698053e0.md - path: /v1/Meteorology/MarineWeather method: GET title: 5.3 Global Marine Weather source: https://docs.shipfinder.com/431272522e0.md - path: /v1/Meteorology/TideStationInfo method: GET title: 5.2.2 Query Single Tide Gauge Station Details source: https://docs.shipfinder.com/431865286e0.md - path: /v1/Meteorology/TideStationList method: GET title: 5.2.1 Request parameters for Global Tide Gauge Stations List source: https://docs.shipfinder.com/431857907e0.md - path: /v1/Prediction/ETA method: GET title: 4.3 ETA Query source: https://docs.shipfinder.com/431244206e0.md - path: /v1/Prediction/RoutePlanPointToPoint method: GET title: 4.1 Point-to-Point Route Planning source: https://docs.shipfinder.com/431124483e0.md - path: /v1/Prediction/RoutePlanPortToPort method: GET title: 4.2 Port-to-Port Route Planning source: https://docs.shipfinder.com/431244012e0.md - path: /v1/Voyage/PortAnchoredVessels method: GET title: 2.3 Currently Anchored Vessels source: https://docs.shipfinder.com/430236145e0.md - path: /v1/Voyage/PortBerthedVessels method: GET title: 2.2 Currently Berthed Vessels source: https://docs.shipfinder.com/430197412e0.md - path: /v1/Voyage/PortExpectedArrivals method: GET title: 2.4 Inbound / Expected Arrivals source: https://docs.shipfinder.com/430249182e0.md - path: /v1/Voyage/PortInfo method: GET title: 2.1 Port Information source: https://docs.shipfinder.com/429932201e0.md - path: /v1/Warning/NavigationalWarnings method: GET title: 6.1 China Region Navigational Warnings source: https://docs.shipfinder.com/431872073e0.md