定位平台接口协议V1.5.docx

定位平台接口协议文档编号2012111101版 本 号V 1.5保密级别保 密文档作者terry审 核2012-11-11文档变更记录版本号变更时间变更内容执笔人V1.02012-11-11建立初稿terryV1.12012-11-25改进http网址terryV1.22012-12-18增加http请求poi接口terryV1.32012-12-24增加http请求的文本格式terryV1.42013-01-26增加多基站请求格式terryV1.52013-02-02修改示例请求的crcterry目 录目 录3一、市场需求4二、技术接口4三、技术要求5版权申明5一、 市场需求1.1 通过短信超链接里面的基站信息和其他相关信息，打开相应的网页，展示当前位置地图和相关位置信息。1.2 目标设备通过联网把数据提交到定位平台，定位平台下发相应的经纬度和地址描述信息二、 技术接口2.1 短信接口1. 用户发送“W”给定位器2. 定位器回复: 2.1 battery=67%,/loc.do?x=358688&y=56690&z=000000158&n=0&c=460&a=9347&e=3932&s=100&v=m1.0&l=zh_CN&p=32.2 x=358688是IMEI的前六位y=56690是经过计算的CRCz=000000158是IMEI后9位2.3 CRC的计算要求：Str=x+n+z+c+a+e+s+vCrc=CRC16(str)2.4 其中N:mnc C:mcc A:Lac E:Cellid V: 为版本号(控制6位以内) S: 为信号强度比 L:语言 battery 为电池电量比2.5 p= 各种参数，比如要不要地图之类的：1 表示纯文字2 图片 3 文字+图片 用户点击超连接，在默认浏览器里面打开位置信息2.2 联网接口 1. 终端设备通过联网提交基站信息给到平台2. 请求格式/locpoi.do?x=358688&y=56690&z=000000158&n=0&c=460&a=9347&e=3932&s=100&v=m1.0&l=zh_CN&p=3注意ContentType: application/json;charset=UTF-81.1 x=358688是IMEI的前六位y=56690是经过计算的CRCz=000000158是IMEI后9位1.2 CRC的计算要求：Str=x+n+z+c+a+e+s+vCrc=CRC16(str)1.3 其中N:mnc C:mcc A:Lac E:Cellid V: 为版本号(控制6位以内) S: 为信号强度比 L:语言 battery 为电池电量比1.4 p= 各种参数，比如要不要地图之类的：1 表示纯文字2 图片3 文字+图片3. 返回数据格式json格式Status:0 /0代表成功，其他是出错原因Cause:OK/原因 出错原因Map:baidu /google 等地图供应商Lat: 22.3245Lon: 114.2456Address:中国深圳湖田例子： Status :0, Cause :OK, Map :baidu, Lat :22.579239885, Lon :113.873464775, Address :广东省深圳市宝安区新湖路; 2.3 联网接口 1. 终端设备通过联网提交基站信息给到平台2. 请求格式/locpoi.do?x=358688&y=56690&z=000000158&n=0&c=460&a=9347&e=3932&s=100&v=m1.0&l=zh_CN&p=3注意ContentType: text/plain1.5 x=358688是IMEI的前六位y=56690是经过计算的CRCz=000000158是IMEI后9位1.6 CRC的计算要求：Str=x+n+z+c+a+e+s+vCrc=CRC16(str)1.7 其中N:mnc C:mcc A:Lac E:Cellid V: 为版本号(控制6位以内) S: 为信号强度比 L:语言 battery 为电池电量比1.8 p= 各种参数，比如要不要地图之类的：1 表示纯文字2 图片3文字+图片3 返回数据格式是字符串格式，字段用|进行分隔，中文用utf8格式Status:0 /0代表成功，其他是出错原因Cause:OK/原因 出错原因Map:baidu /google 等地图供应商Lat: 22.3245Lon: 114.2456Address:中国深圳湖田例子：0|OK|baidu|22.3245|114.2456|中国深圳湖田2.4 多基站定位1. 终端设备通过联网提交基站信息给到平台2. 请求格式/m.do?x=358688&y=24827&z=000000158&n1=460-0-9779-3721-65&n2=460-0-9779-3721-78&n3=460-0-9779-3721-80&s=100&l=zh_CN&p=3注意ContentType: text/plain1.1 x=861612是IMEI的前六位y=12345678是经过计算的CRCz=011639475是IMEI后9位1.2 CRC的计算要求：Str=x+z+n1Crc=CRC16(str)1.3 其中n1 C:mccN:mnc A:Lac E:Cellid S: 为信号强度 取值范围为：0-113，由rssi+113而得到 在android智能机上取值为：S= 2*asu 测试网站输入/map3.html：S= 2*asu 113; 1.4 p= 各种参数，比如要不要地图之类的：1 表示纯文字2 图片3 文字+图片4 返回数据格式是字符串格式，字段用|进行分隔，中文用utf8格式Status:0 /0代表成功，其他是出错原因Caus