手机定位用户使用手V5.0.docVIP

短信及定位业务XML系统用户使用手册 版本号〈〉 发布时间〈200-8-5〉 编写人〈〉 周涛 定稿 2006-1-25 2.0 范长发 增加运单定位 2008-6-3 3.0 范长发 增加获取车辆资料 2009-3-3 4.0 范长发 增加精确定位 2009-11-5 5.0 V5.0 调整点： 增加精确定位的功能接口； 调整短信、城市定位的接口，在上下行内容中增加“external_note”元素，由接口用户自行定义； 概要 为管车宝用户提供短信及定位功能，包括发送下行短信、城市定位、精确定位以及获取车辆资料等功能。 本文档描述上述功能接口的相关信息，包括调用方式、通讯报文、错误处理及注意事项等。 术语定义 31 端口：5100 报文定义 请求报文定义 ?xml version=1.0 encoding=GB2312? yhjx_init request typeopen_session/type client id******/id pwd******/pwd /client /request /yhjx_init 返回报文 ?xml version=1.0 encoding=GB2312? yhjx_result response type open_session /type result result_id0008/result_id result_info连接建立成功/result_info datetime2005-06-23 12:00:00/datetime /result /response /yhjx_result 心跳报文 功能描述 GCBER发起，向YHJX的接口程序发送心跳报文，用于保持连接不中断。心跳发送间隔时间5分钟。 接口描述 提交方式：GCBER向接口发送请求报文，提交到对应的接口地址。 接口地址： 31 端口：5100 报文定义 请求报文定义 ?xml version=1.0 encoding=GB2312? yhjx_init request typeheart_beat/type /request /yhjx_init 2.返回报文定义 ?xml version=1.0 encoding=GB2312? yhjx_result response typeheart_beat/type /response /yhjx_result 发送短信 功能概述 GCBER发起，向YHJX的接口程序发送请求报文，YHJX的接口程序回复发送结果报文。 接口描述 提交方式：GCBER向接口发送请求报文，提交到对应的接口地址。 接口地址： 31 端口：5100 报文定义 1.请求报文示例 ?xml version=1.0 encoding=GB2312? yhjx_init request typesms_submit/type info msid13*********/msid content短信内容/content datetime2005-06-23 12:00:00/datetime external_note*****/external_note /info /request /yhjx_init 2.结果报文示例 ?xml version=1.0 encoding=GB2312? yhjx_result response typesms_submit/type result result_id1001/result_id result_info下行短信发送成功/result_info datetime2005-06-23 12:00:00/datetime external_note*****/external_note /result /response /yhjx_result 城市定位 功能概述 GCBER发起，向YHJX的接口程序发送请求报文，YHJX的接口程序连接定位网关，请求最新的位置信息，同步回复对应的位置信息报文或者错误报文。 接口描述 提交方式：GCBER向接口发送请求报文，提交到对应的接口地址。 接口地址： 31 端口：5100 报文定义 1.请求报文示例 ?xml version=1.0 encoding=GB2312? yhjx_init request t