船舶跟踪数据 API
ship.chinaports.com
基于 Http 请求的船舶跟踪数据
API
2019-10
船舶跟踪数据 API
ship.chinaports.com
发
目录
基于 Http 请求的船舶跟踪数据 API ................................................................................................... 1
1 概述 ...................................................................................................................................................... 1
1.1 约定 .......................................................................................................................................... 1
2 数据接口 ............................................................................................................................................ 1
2.1 获取加密种子 ............................................................................................................................ 1
2.2 船位查询 ................................................................................................................................... 2
2.3 船舶历史轨迹查询 ................................................................................................................... 3
2.4 历史航次查询 ........................................................................................................................... 4
2.5 当前航次查询 ........................................................................................................................... 5
2.6 航行日志查询 ........................................................................................................................... 6
2.7 船舶信息查询 ........................................................................................................................... 7
2.8 进出港查询 ............................................................................................................................... 8
2.9 船舶动态查询 ........................................................................................................................... 9
2.10 区域船舶查询 ......................................................................................................................... 9
2.11 船舶 MMSI 查询 ................................................................................................................... 11
3 调用示例 ............................................................................................................................................ 12
3.1 java 版 md5 加密方法 ....................................................................................................... 12
船舶跟踪数据 API
ship.chinaports.com
基于 Http 请求的船舶跟踪数据 API
1 概述
API 是 Application Program Interface 的缩写,即 程序接口。数据 API 由 Http 接
口组成。使用这套数据 API 接口,会给每个 API 客户分配一个唯一 token,调用数据 api
时先获取加密种子,然后使用 md5 算法进行(token+加密种子)加密,调用每个数据 api 都
需要当前加密的报文(32 位 md5 算法加密后的字符串)当作请求参数传递,用户可以快捷的
获取到船舶数据。
原始的 token:
该文档主要面向项目经理、开发技术人员
1.1 约定
以下数据都采用下表中的约定。
2 数据接口
2.1 获取加密种子
接口功能介绍
此方法返回当前时间年月日字符串,如 20191001。客户在调用 api 接口时,用此字符
串和分发的 token 组合并进行 md5 加密生成新字符串来传递给接口,如分发的 token 为:
test,则用户在使用接口时, 需要先调用该接口得到 20191001,然后调用 md5
(test+20191001)加密生成的 key,调用 数据 API,每个接口都传入该 key
接口 URL
http://shipapi.chinaports.com/dataApi/getComKey
返回结果
{ " seedStr": "20191001", //获取当前日期
"status": 0 //状态 0 为正常,1 为查询异常
}
编码方式
UTF-8
返回值说明
返回值使用 JSON 方式
调用方式
建议使用 HTTP POST 方式
船舶跟踪数据 API
ship.chinaports.com
2.2 船位查询
接口功能介绍
船位包含的信息是由 AIS 设备提供的动态信息,其中包括船舶 MMSI,发出信号的时间,发出信号的精度,
纬度,船舶状态,航首向,船迹象,及是否卫星数据等
接口参数说明
接口 URL
http://shipapi.chinaports.com/shipDataApi/getShipLatest?mmsi=413194000&key=2dbd
c201e4126ff2ff4d7ca6f4d36732
返回结果说明
{
"data": [{
"mmsi": "413194000", //船舶 MMSI 编号
"posttime": "2019-10-01 10:00:00", //时间
"longitude": 122.868896, //精度
"latitude": 30.9709492, //纬度
"navStatu 锚泊", //船舶航行状态
"speed": 0.0, //速度(节)
"heading": 265, //船首向
"course": 353.0, //航迹象
"is_satellite": 0 //是否卫星数据 0 为否,1 为是
}],
"status": "0" //状态 0 成功,-1 查询失败,
} // -2 无权限
参数标识
参数格式
参数含义
备注
mmsi
mmsi=413194000
船舶 MMSI 号
必填,支持多船查询 mmsi
号逗号分隔,最多 20 个
key
key=f344623b2d2c62e66
fb6e3810d976eab
Api 用户 32 位字 符 串
key(使用 md5 加密后的
字符)
必填
评论0