数据中心与asp接口，分为静态信息交换接口、动态信息交换接口、历史数据查询接口。静态信息交换接口用来与asp同步船舶与船舶通信终端的通信基础数据，以及相关组织结构。动态信息交换接口用于接收asp发送的船舶动态信息（包括但不限于船舶定位终端的位置信息，船舶发送的短信息，船舶发送的报警信息，进出港信息等），同时用于系统平台向船舶定位终端发送指令（包括但不限于单船单次调位，单船设定船舶报位频率，多船单次调位，多船设定报位间隔，单船发送信息，多船发送信息）。历史数据查询接口用于系统中心从asp获取历史通信信息。
　　3.1 系统静态信息交换接口
　　系统静态信息交换接口包含系统中心对外发布静态信息接口以及中心获取外部静态信息接口。静态信息交换接口采用web service 方式提供统一的数据接口。静态信息交换接口适用对象为系统平台以及asp。
　　表 0-1 系统静态信息交换接口
　　
　　

功能	服务端	客户端
数据中心对外发布静态信息	系统平台	asp
数据中心获取外部静态信息	asp	系统平台

　　静态信息交换接口包含以下功能。
　　表 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	数据中心

　　服务访问地址： 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 数组

　　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服务，系统中心以客户机方式访问通信服务商。

此法规有错误，我来纠正。请点击在此提交错误内容或者您纠正的内容！

回到顶部

管理我的法规库

网友们正在搜索

法规提交

第14页 农业部办公厅关于发布《渔船动态监管信息系统平台技术规范(试行)》的通知

相关法规

第14页农业部办公厅关于发布《渔船动态监管信息系统平台技术规范(试行)》的通知