7.2船舶AIS定位
# 1. 描述
- 接口功能 可根据MMSI获取船舶档案信息
# 2. 请求URL
https://openapi.1datatech.net/ocean/api/vessel/ais/detail
# 3. 请求方式
- POST
- Content-Type :application/json
# 4.请求头
参数 | 说明 |
---|---|
accessToken | 调用接口的凭证,通过获取Token 接口获得 |
nonce | 签名时生成的随机数 |
timestamp | 签名时生成的时间戳 |
sign | 接口签名 |
# 5. 请求入参
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
mmsi | 是 | string | MMSI |
# 6. 查询参数示例
{
"mmsi": "219210000"
}
1
2
3
2
3
# 7. 响应参数
参数名 | 类型 | 说明 |
---|---|---|
vesselBaseInfo | object | 船舶基础信息 |
vesselName | string | 船名 |
vesselNameCn | string | 船名(中文) |
vesselNameEn | string | 船名(英文) |
mmsi | string | MMSI号 |
imo | string | imo编号号 |
callsign | string | 呼号 |
grt | string | 总吨 |
dwt | string | 载重吨 |
length | string | 长度,单位分米 |
width | string | 宽度,单位分米 |
draught | string | 吃水,单位毫米 |
speed | string | 航速,单位毫米/s |
teu | string | 箱量 |
flagName | string | 船籍 |
vesselType | string | 船舶类型 |
vesselTypeNameCn | string | 船舶类型 (中文) |
vesselTypeNameEn | string | 船舶类型 (英文) |
buildDateTime | string | 建造日期 |
operatorBody | string | 经营主体 |
ownerBody | string | 所有者主体 |
vesselLocationInfo | object | 定位信息 |
hdg | string | 船艏向,单位度 |
cog | string | 航迹向,单位度 |
lon | string | 经度, 1:1000000 |
lat | string | 纬度, 1:1000000 |
dest | string | 目的地 |
nameEn | string | 目的港英文 |
nameCn | string | 目的港中文 |
portCode | string | 目的港标准五字码 |
eta | string | 预计到达当地时间 |
postime | string | AIS定位时间(年月日时分秒) |
# 8. 响应示例
# 8.1 无数据响应示例
{
"success": true,
"code": 200,
"message": "请求成功",
"data": null
}
1
2
3
4
5
6
2
3
4
5
6
# 8.2 有数据响应示例
{
"success": true,
"code": 200,
"message": "请求成功",
"data": {
"vesselLocationInfoVO": {
"eta": "2022-12-26 08:00:00",
"nameCn": null,
"hdg": "25200",
"cog": "14160",
"lon": "135463344",
"nameEn": null,
"dest": "USOAK CNQND",
"portCode": null,
"ctryCode": null,
"lat": "31447996",
"postime": "2022-12-16 14:46:29"
},
"vesselBaseInfoVO": {
"dwt": "148723",
"mmsi": "219210000",
"teu": "13092",
"grt": "141716",
"length": "3665.0",
"imo": "9456783",
"vesselTypeNameCn": "集装箱",
"speed": "12706",
"vesselTypeNameEn": "Full Container Ship",
"ownerBody": "Bank of Communications",
"vesselType": "20000",
"draught": "16000.0",
"vesselNameCn": "马士基埃森",
"callsign": "OYID2",
"width": "482.0",
"flagName": "DK",
"buildDateTime": "201008",
"operatorBody": "Maersk A/S",
"vesselNameEn": "MAERSK ESSEN",
"vesselName": "MAERSK ESSEN"
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
最近更新时间: {
"value": "2023-09-21",
"effect": true
}