《江苏电信定位应用平台通讯协议及数据格式V1.3.7(精)》由会员分享，可在线阅读，更多相关《江苏电信定位应用平台通讯协议及数据格式V1.3.7(精)（18页珍藏版）》请在金锄头文库上搜索。
1、江苏电信定位业务平台(通讯协议及数据格式)Ver1.3.7江苏电信/亚信联创2012年摘要：本协议规范了江苏电信定位业务平台和定位手机（终端）之间的接口，主要实现定位业务平台与定位手机（终端）的各类指令及位置数据的通信传送，并根据各类服务应用对数据格式进行定义。日期版本号修改人备注2010-09-01V1.0-jsct魏阳对协议的实现方式根据江苏电信需求进行了订制化改动2011-3-2V1.1-jsct魏阳2011-3-3V1.2-jsct侯逸文将e家关爱改名为翼通宝2011-3-30V1.3-jsct侯逸文增加了老人机的指令格式2011-4-20V1.3.1侯逸文修改了定时定位指令2011-
2、4-30V1.3.2侯逸文新增了参数上报页面2011-5-4V1.3.3侯逸文去掉了JT（监听）的短信指令2011-6-8V1.3.4侯逸文增加了注意事项，去掉了短信错误回复2011-6-9V1.3.5侯逸文修改了老人机指令2011-12-22V1.3.6侯逸文修改了定时定位和SOS指令2012-3-9V1.3.7侯逸文增加了基站定位页面目 录1.概述51.1.通讯协议概述51.2.编写目的51.3.指令交互流程51.4.平台访问地址61.5.SMS方式61.6.HTTP方式61.7.鉴权62.总体规范62.1.报文类型62.2.报文格式72.3.参数73.基本协议体详细说明73.1.上行指令
3、（定位手机（终端）发往中心平台指令）73.1.1.上报定位信息73.1.2.上报手机参数73.1.3.获取配置参数83.1.4.获取亲友号码83.1.5.获取免打扰时段(老人机无此功能)93.1.6.位置查询93.2.下行指令（定位业务平台发往定位手机（终端）指令）93.2.1.点名93.2.2.实时跟踪（连续汇报）103.2.3.停止跟踪103.2.4.更新亲友号码103.2.5.更新免打扰时段(老人机无此功能)113.2.6.更新定时定位时间表113.2.7.更新终端设置信息（按键设置及终端密码等）123.2.8.查询版本信息123.2.9.获取IMSI号码123.2.10.锁定设备133
4、.2.11.解除设备锁定状态133.2.12.更新设备密码133.3.短信指令143.3.1.短信查询位置143.3.2.SOS紧急呼叫143.3.3.定时定位143.3.4.短信设置号码153.3.5.短信查询电量153.3.6.短信查询密码153.3.7.短信更改密码163.3.8.SIM卡更换报警163.3.9.低电量报警163.3.10.查询终端型号163.3.11.短信指令错误163.4.注意事项163.4.1.手机定位方式163.4.2.注意事项171. 概述1.1. 通讯协议概述通讯协议为实现江苏电信定位业务终端与定位业务平台数据通信过程而设计。协议建立在HTTP/SMS协议之上
5、。如下图所示定位平台定位手持终端HSGPSHSGPSHTTP/SMSHTTP/SMSMS底层承载底层承载由于定位手机（终端）有多种功能应用，不单是定位业务，同时受语音通话的影响，不能实现网络通讯与语音通话同时使用，因而需持多种通道进行数据传输，本协议定义SMS/HTTP这两种方式进行数据传输协议。1.2. 编写目的规定定位手机（终端）和定位业务平台数据传送的格式协议，软件设计应按照此协议进行。1.3. 指令交互流程流程一：翼通宝平台与关爱终端指令交互流程1）翼通宝平台发送下行指令（短信格式）至关爱终端2）关爱终端在获取短信后解析指令3）根据指令要求，使用CTWAP拨号访问翼通宝指定接口页面4）
6、从页面中获取关爱终端的配置信息或上报结果流程二：家庭成员手机与关爱终端指令交互流程1）首先在翼通宝平台上将家庭成员号码配置在关爱终端按键上2）家庭成员使用配置过的号码发送短信指令至关爱终端3）关爱终端在获取短信后解析指令3）根据指令要求，按照协议中规定格式回复短信至家庭成员手机1.4. 平台访问地址平台业务使用界面可以通过域名http:/访问，ip地址为58.223.0.153，开通80端口在下文举例中我们以ip地址为58.223.0.153为数据举例，如果需要通过域名使用平台通讯接口，接口机的域名为例如：访问http:/58.223.0.153/position/ reportPositio
7、n.jsp等同于访问http:/ SMS方式手机客户端与服务器通过短信的方式进行数据通信。注意：绝大部份上下行指令都走短信通道备注：终端必须默认处于手机短信接收可覆盖状态，以确保下行指令的正常接收。当一条短信不足以表述完指令时，使用多条短信，服务器和设备均按此处理，关爱终端为电信天翼手机，家人终端为电信、移动、联通手机。1.6. HTTP方式定位手机平时处于下线，当本地由于数据需要传输或达到定时上线时间等类似策略时，定位手机作为客户端以客户-服务器方式建立通信过程，通过POST请求向服务器指定页面传递数据，通过GET方法获取服务器返回，传送数据完成后，结束该过程。1.7. 鉴权走短信通道时，只
8、对短信中心号码和亲情电话号码的指令进行解释执行。（即只有短信中心号码和设定的几个亲情号码有权下指令）。Http方式暂时不用鉴权。2. 总体规范2.1. 报文类型短信通道：所有下行指令及相应的回复指令（除定位信息）走短信通道，短信通道的内容是可识别明文字符串。例如：短信内容为Query2.2. 报文格式HTTP请求与短信内容均采用明文字符串，Unicode编码2.3. 参数服务器端配置参数采用键值对的方式，依不同指令，格式定义不同。具体请参阅协议体详细说明。3. 基本协议体详细说明3.1. 上行指令（定位手机（终端）发往中心平台指令） 收到每条上行指令，平台都返回一个执行结果3.1.1. 上报定
9、位信息调用接口reportPosition.jsp指令说明上传终端的位置信息参数终端上报标准格式为: 时间纬度+经度指令通道触发条件网络通道（HTTP）收到内容为Query的短信指令附加说明如http:/58.223.0.153/position/reportPosition.jsp?param=纬度经度&battery=电量各参数定义如下：纬度：浮点数，精确到小数点后7位，单位：度 例：32.0244813度经度：浮点数，精确到小数点后7位，单位：度 例：118.7753499度电量：表示电量的百分比，100以内的整数注意：某次定位如果第1次失败，则等待5秒再进行第2次定位，如果第2次定位再
10、失败，则再等待5秒进行第3次定位，如果第3次定位也失败，则认为定位完全失败，不再尝试。如果定位失败不用访问平台网页。3.1.2. 上报手机参数调用接口setGuardUp.jsp指令说明上传终端的参数信息参数指令通道触发条件网络通道（HTTP）在收到短信修改按键号码、密码指令时，如SZMM、SZBB、XGMM等，除了更改手机本身参数外，需要访问页面将终端当前参数上报到平台上附加说明如ttp:/58.223.0.153/position/setGuardUp.jsp?skty=XX&xzms=xx&pwd=xx&jt=xx&bb=xx&mm=xx&zj=xx&yj=xx各参数定义如下：skty-
11、上课停用 skty=0表示上课不停用，skty=1表示上课停用，该字段预留不使用xzms-限制陌生 xzms=1表示不允许陌生人打入，xzms=0表示允许陌生人打入pwd-终端密码 jt-家庭按键 bb-爸爸按键 mm-妈妈按键 zj-左键 yj-右键5个按键在终端上的位置由终端厂家根据终端的具体情况自行决定。3.1.3. 获取配置参数调用接口setGuardDown.jsp指令说明获取服务端配置参数。参数不含参数则平台返回所有参数值，如参数为Param=SmsCenter, IpAddress服务端则返回对应参数例：如果请求成功：则返回参数名与参数值的键值对指令通道触发条件网络通道（HTTP
12、）收到内容为DownloadGuard的短信指令附加说明通过访问 http:/58.223.0.153/position/setGuardDown.jsp所有参数都是通过该接口获取，返回的参数采用键值对的方式以下为服务端返回的键值对参数名1) 短信中心号码: SmsCenter，该号码为翼通宝平台的短信特服号码，在更新超级用户密码及锁定设备时，关爱终端都需验证该号码2) 报警中心号码：AlertCenter，当关爱终端产生紧急呼叫时，同时将呼叫短信发送至家庭成员以及报警中心号码，该字段预留不使用3) 电话号码：mdn，当关爱终端需要获取自身电话号码时，可通过此方式获取4) 上课停用开关：skt
13、y，skty=0表示上课不停用，skty=1表示上课停用，该字段预留不使用5) 限制陌生电话开关：xzms，xzms=1表示不允许陌生人打入，xzms=0表示允许陌生人打入6) 快捷按键设置：jt(按键1),bb(按键2),mm(按键3),zj(按键4),yj(按键例如得到的返回为jt=13311111111&bb=18911111111&mm=18900000000&zj=&yj=7) 终端密码：pwd，例如pwd=1234563.1.4. 获取亲友号码调用接口setFriendsDown.jsp指令说明获取亲友号码列表参数无入参指令通道触发条件网络通道（HTTP）收到内容为Download
14、Friends的短信指令附加说明如http:/58.223.0.153/position/setFriendsDown.jsp平台返回的格式为号码1,号码2,号码3,号码4例如:13311111111,13311111112,13311111113,133111111143.1.5. 获取免打扰时段(老人机无此功能)调用接口setClassTimeDown.jsp指令说明获取免打扰时段表参数无入参指令通道触发条件网络通道（HTTP）收到内容为DownloadClassTime的短信指令附加说明如http:/58.223.0.153/position/ setClassTimeDown.jsp平台返回结果为pssd=0830-091
