船舶定位接口

＊建议请求参数MMSI和船名二选一，若都传入参数，优先根据MMSI进行查询＊

请求参数

Query 参数

companyCode

string

必需

公司编码（需向云当网申请）

orgCode

string

组织编码

可选

token

string

必需

获取token接口返回的token值

mmsi

string

可选

船舶MMSI代码（MMSI/船名，二选一）

示例值:

414700000

vessel

string

可选

船名（MMSI/船名，二选一）

返回响应

🟢200成功

application/json

Body

code

integer

请求状态

必需

200=请求成功，其他=请求失败

codeDesc

string

请求状态代码

必需

success=成功，其他=失败

message

string

失败信息

必需

result

object

结果

必需

shipId

string

船舶ID

可选

<= 12 字符

imo

string

船舶IMO代码

可选

<= 7 字符

mmsi

string

船舶MMSI代码

可选

<= 9 字符

vslName

string

船名

可选

<= 20 字符

callSign

string

船舶呼号

可选

<= 5 字符

shipType

integer

船舶类型

可选

60=客轮，70=货轮，80=油轮，90=其他

length

integer

船舶长度

可选

单位：米

width

integer

船舶宽度

可选

单位：米

draught

integer

船舶吃水

可选

单位：毫米

dest

string

下一港

可选

<= 64 字符

destCode

string

下一港代码

可选

<= 18 字符

nationality

string

船籍二字码

可选

<= 2 字符

builtYear

string

建造年份

可选

<= 4 字符

dwt

string

载重

可选

单位：KG

<= 12 字符

capacity

string

装载量

可选

单位：TEU

<= 12 字符

eta

string <date-time>

下一港预计到达时间

可选

零时区时间（UTC）

naviStatus

integer

航行状态

可选

0=在航，1=靠泊

latitude

number <double>

纬度

可选

单位：度

longitude

number <double>

经度

可选

单位：度

hdg

string

航艏向

可选

单位：度

<= 12 字符

cog

string

航向

可选

单位：度*10

<= 12 字符

sog

string

航速

可选

单位：节*10

<= 12 字符

lastTime

string <date-time>

更新时间

可选

北京时间（UTC+8）

示例

{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": {
        "shipId": "9794",
        "imo": "9523005",
        "mmsi": "414700000",
        "vslName": "XIN QIN ZHOU",
        "callSign": "BPKF",
        "shipType": 70,
        "length": 255,
        "width": 37,
        "draught": 135000,
        "dest": "CNNSA",
        "destCode": "CNNSA",
        "nationality": "CN",
        "builtYear": "2012",
        "dwt": "66904",
        "capacity": "4738",
        "eta": "2025-04-27 17:30:00",
        "naviStatus": 1,
        "latitude": 22.649851666667,
        "longitude": 113.68082333333,
        "hdg": "340",
        "cog": "36",
        "sog": "0",
        "lastTime": "2025-04-28 17:04:29"
    }
}

请求参数

示例代码

返回响应