服务介绍

查询指定船舶在一段时间内是否有搭靠行为，如果有搭靠行为则列出搭靠的船舶详细信息以及搭靠的位置、坐标、搭靠开始时间、结束时间等。根据全球船舶实时位置监控，测算两船贴近停靠或并排行驶超过5分钟，则判定为船舶搭靠。

适用场景

货运物流

正常搭靠过驳：监测大船过驳小船的货物流转环节，结合小船的信息以及后续小船的靠港记录等，监控和分析货物流转的各个环节。

货物偷盗监控：非过驳场景下船舶在航行中检测到搭靠行为，可以重点监控是否有货物偷盗。

海事监管

船舶行为分析：海事监管部门可以利用船舶搭靠数据，分析船舶的行为模式，结合其他综合性数据，识别船舶非法搭靠的异常行为。

请求限制

此服务为高级服务，需要申请高级权限才可使用，使用前需要在控制台创建您应用的key。请求服务时，会根据您所属权限的类型限制访问的数量，您当前使用服务的权限清单在控制台中可以查看。开通服务权限请联系商务。

在线调试

提供无开发经验的用户在线访问接口数据，了解服务获取样例。需要提前创建船讯网API key并具备权限，对应的API Key需要到https://api.shipxy.com/v3/console/overview 获取，参见https://33iwh234s7.apifox.cn/8961339m0

请求地址

请求地址	请求方式
https://api.shipxy.com/apicall/v3/SearchshipApproach	Get

请求调用示例

https://api.shipxy.com/apicall/v3/SearchshipApproach?key=1F6D701272402D1E7D8D316CCE519123&mmsi=477172700&start_time=1749956794&end_time=1751446602&approach_zone=3

**注：**例子中的 1F6D701272402D1E7D8D316CCE519123 是船讯网的官方 key，已经绑定域名 api.shipxy.com，用户无权也无法使用该 key 获取数据，使用该 key 会返回 status 14 的状态码，提示来源域错误。用户如需试用服务，请在控制台创建自己的key。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

⚪0成功

application/json

成功返回船舶搭靠记录

Bodyapplication/json

示例

{
    "status": 0,
    "msg": "",
    "data": {
        "ship_data": {
            "mmsi": 477172700,
            "imo": 9783538,
            "call_sign": "VRRV4",
            "ship_name": "COSCO SHIPPING LIBRA",
            "ship_type": 70
        },
        "approach_data": [
            {
                "approach_ship": {
                    "mmsi": 477947300,
                    "imo": 9493107,
                    "call_sign": "VRKQ6",
                    "ship_name": "CSB HERALD",
                    "ship_type": 70
                },
                "approach_event": {
                    "approach_time": "2025-06-30 13:07:46",
                    "approach_time_utc": 1751260066,
                    "separation_time": "2025-06-30 13:13:49",
                    "separation_time_utc": 1751260429,
                    "duration": 6.05,
                    "approach_zone": 3,
                    "lat": 31.372347,
                    "lng": 121.689075,
                    "port_code": "",
                    "position": "上海市-上海市-崇明区",
                    "sog": 1.75
                }
            }
        ]
    }
}

3.2 船舶互相搭靠记录查询

服务介绍

适用场景

货运物流

海事监管

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

3.2 船舶互相搭靠记录查询

服务介绍#

适用场景#

货运物流#

海事监管#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

货运物流

海事监管

请求限制

在线调试

请求地址

请求调用示例