Message数据格式定义如下。
表 0-8 Message数据格式定义
名称
| 字段名
| 类型
| 说明
|
信息ID
| msg_id
| String
| 数据序列号，在整个系统中是唯一的，规则：由通信服务商代码（4位10进制数，系统分配）、表示数据中心的用户id“0000”、UTC日期戳（14位10进制数，格式YYYYMMDDHH24MISS）和5位唯一的十进制序列号串联而成，如：110100002009013011552311111
|
通信终端号码
| terminal_code
| string
| 通信终端号码
|
通信终端类型
| terminal_type
| Int
| 见表 2.2-2
|
信息类型
| msg_type
| Int
| 见表 2.3-2
|
通信时间
| UTC
| Int
| 定位UTC时间
|
通信内容
| msg
| String
| 信息内容
|
3.2.4获取所有终端历史通信信息
函数：GetAllMsgs
描述：获取所有船舶在一定时间内的通信信息。
表 0-9函数GetAllMsgs说明
方向
| 参数
| 类型
| 说明
|
输入
| username
| string
| 用户名
|
password
| string
| 密码
|
Begin_UTC
| Int
| 起始UTC时间
|
End_UTC
| int
| 结束UTC时间
|
输出
| GetAllMsgsResponse
| Message 数组
|
|
Message数据格式定义如下。
表 0-10 Message数据格式定义
名称
| 字段名
| 类型
| 说明
|
信息ID
| msg_id
| String
| 数据序列号，在整个系统中是唯一的，规则：由通信服务商代码（4位10进制数，系统分配）、表示数据中心的用户id”0000”、UTC日期戳（14位10进制数，格式YYYYMMDDHH24MISS）和5位唯一的十进制序列号串联而成，如：110100002009013011552311111
|
通信终端号码
| terminal_code
| string
| 通信终端号码
|
通信终端类型
| terminal_type
| Int
| 见表 2.2-2
|
信息类型
| msg_type
| Int
| 见表 2.3-2
|
通信时间
| UTC
| Int
| 定位UTC时间
|
通信内容
| msg
| String
| 信息内容
|
3.3 动态数据交换协议
动态信息交换接口用于接收ASP发送的船舶动态信息（包括单不限于船舶定位终端的位置信息，船舶发送的短信息，船舶发送的报警信息，进出港信息等），同时用于系统平台向船舶定位终端发送指令（包括但不限于单船单次调位，单船设定船舶报位频率，多船单次调位，多船设定报位间隔，单船发送信息，多船发送信息）。动态信息交换接口采用TCP自定义协议实现数据接口。通信服务商提供TCP服务，系统中心以客户机方式访问通信服务商。
通信服务商提供服务所在IP以及端口，用户名密码等必须数据。
动态信息交换接口包含以下功能：
表 0-1 动态信息交换接口
序号
| 功能
| 说明
|
1
| 登录
| 登录ASP服务，不登录无法进行后续操作
|
2
| 退出登录
| 退出ASP服务
|
3
| 连接保持
| 保持当前连接，如无数据通信，需定期发送连接保持信息
|
4
| 发送请求
| 发送指令，包括但不限于单船单次调位，单船设定船舶报位频率，多船单次调位，多船设定报位间隔，单船发送信息，多船发送信息
|
5
| 位置数据
| 定位终端的位置信息
|
6
| 短信数据
| 定位终端发送的信息
|
3.3.1 通信格式
动态信息交换接口采用类Telnet终端的命令应答方式通信，以\r\n为结束符的字符串为通信指令基本单元。其中逗号作为通信指令中的字段分隔符。字符编码英文采用ASCII，中文编码采用GBK。
具体指令类型见下表。
表 0-2 指令类型表
序号
| 指令符
| 定义
| 方式
| 发送方
| 接收方
| 说明
|
1
| w
| 欢迎标识，连接服务
|
| S
| C
| 登陆服务后，服务端首先发送此信息
|
2
| i
| 登录
| 同步
| C
| S
| 登录服务端
|
i
| 登录返回
| 同步
| S
| C
| 登陆返回
|
3
| o
| 退出登录
| 同步
| C
| S
| 退出
|
o
| 退出登录返回
| 同步
| S
| C
| 退出返回
|
4
| k
| 连接保持
| 同步
| C
| S
|
|
k
| 连接保持返回
| 同步
| S
| C
|
|
5
| s
| 发送请求
| 同步
| C
| S
| 客户端发出命令请求
|
s
| 发送请求返回
| 同步
| S
| C
| 服务端返回请求处理结果
|
6
| p
| 位置数据
| 异步
| S
| C
| 服务端推送位置数据
|
7
| m
| 短信数据
| 异步
| S
| C
| 服务端推送信息数据
|
8
| r
| 回执信息
| 异步
| S
| C
| 服务端推送发送命令异步回执
|
9
| x
| 错误信息返回
| 同步
| S
| C
|
|
