智能调度平台接口(地图服务系统分册).docxVIP

智能调度配送管理平台接口规范（地图服务系统分册）二〇一四年十一月修订历史版本类型成稿日期责任人备注概述编写目的为统一智能调度管理配送平台与地图服务系统的集成接口，特制定本接口规范，以指导智能调度管理配送平台集成的设计、开发、测试及部署实施工作。预期读者本接口规范预期读者为智能调度管理配送平台和地图服务系统接口设计开发人员。术语Webservice集成：通过WebService的方式进行数据传递的接口集成方式。交互示意图接口需求场站标注信息接口需求描述根据智能调度平台业务开展的要求，需要从GIS系统中获取场站位置数据，为销售管理、气源采购管理、运力采购管理、智能匹配管理、运输执行等业务开展提供数据支撑。数据类清单智能调度配送管理平台：数据类型数据类交互频度场站位置信息场站位置明细信息实时接口交互流程图流程图说明1、智能调度管理平台在业务过程中，标注场站地图信息并存储场站地图信息。2、智能调度管理平台调用地图服务系统Webservice接口，通知地图服务系统将，并产生的场站位置信息发送到地图服务系统。3、地图服务系统接收到智能调度平台发送过来的场站位置信息和Webservice通知后，存储相关信息。4、地图服务系统将结果反馈给智能调度平台。WebService服务清单服务提供者服务分类服务名称地图服务系统??气源地标注信息接口需求描述根据智能调度平台业务开展的要求，需要从GIS系统中获取气源地位置数据，为销售管理、气源采购管理、运力采购管理、智能匹配管理、运输执行等业务开展提供数据支撑。数据类清单智能调度配送管理平台：数据类型数据类交互频度气源地位置信息气源地位置明细信息实时接口交互流程图流程图说明1、智能调度管理平台在业务过程中，标注气源地地图信息并存储气源地地图信息。2、智能调度管理平台调用地图服务系统Webservice接口，通知地图服务系统，并将产生的气源地位置信息发送到地图服务系统。3、地图服务系统接收到智能调度平台发送过来的气源地位置信息和Webservice通知后，存储相关信息。4、地图服务系统将结果反馈给智能调度平台。WebService服务清单服务提供者服务分类服务名称地图服务系统??Webservice集成场站标注信息接口场站标注信息接口服务接口说明接口说明根据智能调度平台业务开展的要求，需要从GIS系统中获取场站位置数据，为销售管理、气源采购管理、运力采购管理、智能匹配管理、运输执行等业务开展提供数据支撑。接口方式Webservice方法名称?服务端地图服务系统调用端智能调度管理配送平台数据频度实时输入参数中文名输入参数英文名参数格式非空含义?????返回值中文名称返回值英文名称返回值格式非空含义成功/失败标志RLT_FLAGSTRING(8)1成功0失败失败原因FAIL_MEMOSTRING(256)数据交互说明气源地标注信息接口气源地标注信息接口服务接口说明接口说明根据智能调度平台业务开展的要求，需要从GIS系统中获取气源地位置数据，为销售管理、气源采购管理、运力采购管理、智能匹配管理、运输执行等业务开展提供数据支撑。接口方式Webservice方法名称?服务端地图服务系统调用端智能调度管理配送平台数据频度实时输入参数中文名输入参数英文名参数格式非空含义?????返回值中文名称返回值英文名称返回值格式非空含义成功/失败标志RLT_FLAGSTRING(8)1成功0失败失败原因FAIL_MEMOSTRING(256)数据交互说明WebService接口规约技术架构技术架构概述智能调度平台WebService接口采用Xfire技术实现。客户端和服务器用SOAP协议通过HTTP来交互，客户端根据WSDL描述文档生成SOAP请求消息发送到服务端，服务端解析收到的SOAP请求，调用Web service，然后再生成相应的SOAP应答送回到客户端。认证机制智能调度平台的所有WebService服务均需要认证通过（部分需要授权）才能够被调用。智能调度平台WebService服务接收到请求后首先从消息上下文中获取用户名和密码，进行认证，认证通过后再调用具体服务。作为客户端，应用程序代码(使用Xfire的客户端编程模型来编写的)需要将用户名和密码设置到MessageContext中进行调用。根据客户端程序语言及调用方式不同，设置的方法也不同，下面列举出客户端程序语言为java的两种设置方式：客户端调用平台使用xfire技术发布webservice服务，建议客户端也使用XFire来访问外部服务，以下客户端调用示例代码都是基于xfire技术来编写的。一、调用方式客户端可以通过如下两种方式调用外部服务：根据WSDL创建客户端调用如果服务端没有提供接口，可以使用这种简单的方式来调用，如下为客户端调用示例代码：public stat