服务介绍

查询船舶当前时间点是否挂靠了港口，如果当前正在某一港口挂靠，则可以获得当前挂靠港口的信息以及入港时间。

适用场景

1 物流跟踪。追踪船舶当前挂靠情况，可以结合实时船位推送服务或到离港事件推送服务，监测航速变化以及船舶到港时，查询对应港口的详细信息以及到港、靠泊的具体时间。

请求限制

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

在线调试

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

请求地址

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

请求调用示例

https://api.shipxy.com/apicall/v3/GetShipStatus?key=1F6D701272402D1E7D8D316CCE519123&mmsi=477172700

**注：**例子中的 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": "",
    "total": 1,
    "data": [
        {
            "ship_name": "COSCO SHIPPING LIBRA",
            "call_sign": "VRRV4",
            "imo": 9783538,
            "mmsi": 477172700,
            "ship_type": "货船",
            "current_sea_area": "Persian gulf",
            "sea_area_code": "4266",
            "current_city": "",
            "current_city_code": "",
            "lng": 54.659412,
            "lat": 24.813847,
            "previousport": {
                "port_code": "208866",
                "port_name": "Jebel Ali",
                "port_cnname": "杰贝阿里",
                "port_time_zone": "+4",
                "port_country_name": "United Arab Emirates",
                "port_country_cnname": "阿联酋",
                "port_country_code": "AE",
                "arrive_anchorage": "2025-05-06 18:16:57",
                "ata": "2025-05-06 18:16:57",
                "atb": "2025-05-06 22:14:47",
                "atd": "2025-05-08 16:11:14"
            },
            "currentport": {
                "port_code": "337404",
                "port_name": "Khalifa Port",
                "port_cnname": "哈里发港",
                "port_time_zone": "+4",
                "country_en": "United Arab Emirates",
                "port_country_cnname": "阿联酋",
                "country_code": "AE",
                "arriveanchorage": "2025-05-08 20:39:52",
                "ata": "2025-05-08 20:39:52",
                "atb": "2025-05-08 23:05:22"
            }
        }
    ]
}

4.3 船舶当前挂靠信息

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

4.3 船舶当前挂靠信息

服务介绍#

适用场景#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例