静态信息交换接口包含以下功能。
表 0-2 静态信息交换接口功能
服务名
| 说明
| 服务端实现者
| 客户端调用者
|
getShipInfo
| 获取船舶通信基础信息
| 数据中心/ASP
| ASP/数据中心
|
getGroupInfo
| 获取组织机构信息
| 数据中心
| ASP
|
getShipGroup
| 获取船舶与组织对应关系
| 数据中心
| ASP
|
addShip
| 增加船舶
| 数据中心/ASP
| ASP/数据中心
|
delShip
| 删除船舶
| 数据中心/ASP
| ASP/数据中心
|
服务访问地址： http：//ip：port/shipinfo
说明：
1） IP：服务器IP地址或者域名
2） PORT：端口号
3） shipinfo：web services入口
注：可以通过http：//ip：port/shipinfo?wsdl 获取到该web service的语义xml文件。
3.1.1 获取船舶通信基础信息
函数：getShipInfo
描述：获取船舶的基本通信信息，包括船舶名称，通信终端类型，通信终端代码，以及船舶内部编码等。
表 0-3 函数getShipInfo说明
方向
| 参数
| 类型
|
输入
| username
| string
|
password
| string
|
输出
| GetShipInfoReturn
| Mobile数组
|
Mobile结构定义如下。
表 0-4 Mobile结构
名称
| 字段名
| 类型
| 说明
|
船舶系统id
| mobile_id
| Int
| 内部id
|
船舶名称
| mobilename
| String
| 船舶名称中文
|
通信终端类型
| terminal_type
| Int
| 见表2.2-2通信服务商代码
|
通信终端号码
| terminal_code
| String
| 通信终端号码
|
3.1.2 获取组织机构基本信息
函数：getGroupInfo
描述：获取组织机构的基本信息，包括名称、ID、上级组等。
表 0-5 函数getGroupInfo说明
方向
| 参数
| 类型
|
输入
| username
| String
|
password
| String
|
输出
| getGroupInfoReturn
| MobileGroup数组
|
MobileGroup数据结构如下。
表 0-6 MobileGroup数据结构
名称
| 字段名
| 类型
| 说明
|
组织编码
| group_id
| Int
| 船舶组内部编码
|
船舶组名称
| group_name
| String
| 船舶组名称
|
上级组编码
| parent_id
| Int
| 上级组内部编码
|
3.1.3 获取船舶与组织机构对应关系
函数：getShipGroup
描述：获取终端与组对应关系，包括船舶id，所属组id等。
表 0-7 函数getShipGroup说明
方向
| 参数
| 类型
|
输入
| username
| string
|
password
| string
|
输出
| getShipGroupReturn
| MobileGroupAssign数组
|
MobileGroupAssign数据结构如下。
表 0-8 MobileGroupAssign数据结构
名称
| 字段名
| 类型
| 说明
|
组织编码
| group_id
| Int
| 船舶组内部编码
|
船舶编码
| mobile_id
| Int
| 船舶内部编码
|
3.1.4 增加船舶
函数：addShip
描述：添加船舶的基本通信信息，包括船舶名称，通信终端类型，通信终端代码等。
表 0-9 函数addShip说明
方向
| 参数
| 类型
|
输入
| Username
| string
|
Password
| string
|
Mobilename
| String
|
terminal_type
| Int
|
terminal_code
| String
|
输出
| GetShipInfoReturn
| boolean
|
3.1.5 删除船舶
函数：delShip
描述：删除船舶的基本通信信息，包括船舶名称，通信终端类型，通信终端代码等。
表 0-10函数：delShip说明
方向
| 参数
| 类型
|
输入
| username
| String
|
password
| String
|
mobilename
| String
|
terminal_type
| Int
|
terminal_code
| String
|
输出
| GetShipInfoReturn
| Boolean
|
3.2 历史通信信息交换接口
历史通信信息交换接口用于ASP提供给中心查询历史通信数据功能。历史信息交换接口采用Web Service 方式提供统一的数据接口。历史信息交换接口适用对象为系统平台以及ASP。
表 0-1 系统历史通信信息交换接口
功能
| 服务端
| 客户端
|
数据中心获取通信历史数据
| ASP
| 系统中心
|
历史信息交换接口包含以下功能。
表 0-2 历史信息交换接口功能
服务名
| 说明
| 服务端实现者
| 客户端调用者
|
GetTracksByID
| 获取某一终端的位置信息
| ASP
| 数据中心
|
GetRectTracks
| 获取某一区域的位置信息
| ASP
| 数据中心
|
GetMsgsByID
| 获取某一终端的通信信息
| ASP
| 数据中心
|
GetAllMsgs
| 获取全部的通信信息
| ASP
| 数据中心
|
