服务访问地址: http://ip:port/track
说明:
1) IP:服务器IP地址或者域名
2) PORT:端口号
3) track:web services入口
注:可以通过http://ip:port/track?wsdl 获取到该web service的语义xml文件。
3.2.1获取某一终端历史位置
函数:GetTracksByID
描述:获取某一船舶在一定时间内的位置信息。
表 0-3函数GetTracksByID说明
方向
| 参数
| 类型
| 说明
|
输入
| username
| string
| 用户名
|
password
| string
| 密码
|
terminal_code
| String
| 终端号码
|
Begin_UTC
| Int
| 起始UTC时间
|
End_UTC
| int
| 结束UTC时间
|
输出
| GetTracksByIDResponse
| Track 数组
|
|
Track数据格式定义。
表 0-4 Track数据格式定义
名称
| 字段名
| 类型
| 说明
|
信息ID
| msg_id
| String
| 数据序列号,在整个系统中是唯一的,规则:由通信服务商代码(4位10进制数,系统分配)、表示数据中心的用户id“0000”、UTC日期戳(14位10进制数,格式YYYYMMDDHH24MISS)和5位唯一的十进制序列号串联而成,如:110100002009013011552311111
|
通信终端号码
| terminal_code
| string
| 通信终端号码
|
通信终端类型
| terminal_type
| Int
| 见表 2.2-2
|
位置类型
| pos_type
| Int
| 见表 2.3-1
|
定位时间
| UTC
| Int
| 定位UTC时间
|
经度
| longitude
| Int
| 经度
|
纬度
| latitude
| Int
| 纬度
|
方向
| course
| Int
| 对地运动方向
|
船艏向
| trueheading
| Int
| 船首方向
|
速度
| speed
| Int
| 对地运动速度
|
状态
| status
| Int
| 状态定义见表 2.3-3
|
描述
| vdesc
| string
| 船舶状态描述
|
3.2.2获取某一区域历史位置
函数:GetRectTracks
描述:获取某一区域在一定时间内的位置信息。
表 0-5 函数GetRectTracks说明
方向
| 参数
| 类型
| 说明
|
输入
| username
| string
| 用户名
|
password
| string
| 密码
|
Begin_UTC
| Int
| 起始UTC时间
|
End_UTC
| int
| 结束UTC时间
|
begin_long
| int
| 起始经度
|
end_long
| int
| 结束经度
|
begin_lat
| int
| 起始纬度
|
end_lat
| int
| 结束纬度
|
输出
| GetRectTracksResponse
| Track 数组
|
|
Track数据格式定义如下。
表 0-6 Track数据格式定义
名称
| 字段名
| 类型
| 说明
|
信息ID
| msg_id
| String
| 数据序列号,在整个系统中是唯一的,规则:由通信服务商代码(4位10进制数,系统分配)、表示数据中心的用户id“0000”、UTC日期戳(14位10进制数,格式YYYYMMDDHH24MISS)和5位唯一的十进制序列号串联而成,如:110100002009013011552311111
|
通信终端号码
| terminal_code
| string
| 通信终端号码
|
通信终端类型
| terminal_type
| int
| 见表 2.2-2
|
位置类型
| pos_type
| int
| 见表 2.3-1
|
定位时间
| UTC
| int
| 定位UTC时间
|
经度
| longitude
| int
| 经度
|
纬度
| latitude
| int
| 纬度
|
方向
| course
| int
| 对地运动方向
|
船艏向
| trueheading
| int
| 船首方向
|
速度
| speed
| int
| 对地运动速度
|
状态
| status
| int
| 状态定义见表 2.3-3
|
描述
| vdesc
| string
| 船舶状态描述
|
3.2.3获取某一终端历史通信信息
函数:GetMsgsByID
描述:获取某一船舶在一定时间内的通信信息。
表 0-7 函数GetMsgsByID说明
方向
| 参数
| 类型
| 说明
|
输入
| username
| string
| 用户名
|
password
| string
| 密码
|
terminal_code
| String
| 终端号码
|
Begin_UTC
| Int
| 起始UTC时间
|
End_UTC
| int
| 结束UTC时间
|
输出
| GetMsgsByIDResponse
| Message 数组
|
|