定位平台接口协议V2.6.doc

minigps-定位平台接口协议文档编号2012111101版 本 号V 2.6保密级别保 密文档作者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修改示例请求的crcterryV1.62013-04-09增加gps设备的接口terryV1.72013-04-16把文档改成表格式terryV1.82013-04-17增加根据经纬度转换为地址描述的接口terryV1.92013-04-27增加l.do接口强制指定为google地图数据terryV2.02013-05-15增加mt参数，以便指定返回坐标类型terryV2.22013-06-24增加短信内包含短域名支持terryV2.32013-06-30增加三基站测试接口，供客户测试三基站准确性terryV2.42013-07-13增加基站距离接口mm，供客户做电子围栏功能，添加agps接口，供客户做agps功能terryV2.52013-10-13增加6基站定位接口a和as接口，供客户提供多个基站(超过3个)进行定位terryV2.62013-12-036基站接口添加ta参数，定位精度大大的提高terry目 录目 录3一、市场需求4二、技术接口4三、技术要求5版权申明5一、 市场需求1.1 通过短信超链接里面的基站信息和其他相关信息，打开相应的网页，展示当前位置地图和相关位置信息。1.2 目标设备通过联网把数据提交到定位平台，定位平台下发相应的经纬度和地址描述信息二、 接口总揽编号路径调用方式基站个数样例作用是否支持GPS1loc.do短信1/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=3智能简化地图显示否2locpoi.do联网1/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程序内部使用否3m.dop=3短信&p=1联网1-3/m.do?x=388930&y=32052&z=306000472&n1=460-0-10168-3863-45&n2=460-0-10168-3862-37&n3=460-0-10168-3861-31&s=100&l=zh_CN&p=3智能简化地图显示&程序内部使用否4ms.dop=3短信&p=1联网1-3/ms.do?n1=460-0-9779-3721-65&n2=460-0-9779-3722-78&n3=460-0-9779-3723-80&l=en_ZN&p=1&mt=0程序内部使用,可以返回标准坐标否5g.do短信1/g.do?y=46803&m=888888000000002&c=460&n=0&a=9779&e=3721&s=100&l=22.587806,113.856216Google动态地图显示是6l.do联网1/l.do?c=454&n=6&a=8010&e=6652663程序内部使用，主要用于更新数据否7w.dop=3短信&p=1联网0/w.do?y=47220&l=22.249997,114.1666819&c=460&p=1用于gps定位，显示位置是8mt.dop=3短信&p=1联网1-3/mt.do?x=666666&y=1892&z=000094535&n1=460-1-9529-21541-151&n2=460-1-9529-21542-158&n3=460-1-9529-21241-143&p=1&l=22.576610,113.861011用于测试三基站的准确性必须9mm.dop=3短信&p=1联网1-3/mm.do?x=358688&y=24827&z=000000158&n1=460-0-9779-3721-65&n2=460-0-9779-3724-65&n3=460-0-9779-3723-65&l=en_ZN&p=1&m1=460-0-9779-3721-65&m2=460-0-9779-3722-65&m3=460-0-9779-3723-65用于查询2个基站之间的距离否10agps.dop=3短信&p=1联网1-3/agps.do?x=388930&y=32052&z=306000472&n1=460-0-10168-3863-45&n2=460-0-10168-3862-37&n3=460-0-10168-3861-31&s=100&l=zh_CN&p=3用于辅助agps定位，输出的经纬经过混淆，不能用于定位否11ap=3短信&p=1联网1-6/a?x=358688-18918-000000158-1cc-0-6212-2F8C-AC-52EC-28AD-96-6212-2F8B-96-6212-FAD-94-6212-3FB5-93-6212-FAB-93&ta=1用于6个基站进行定位，设备调用否12asp=3短信&p=1联网1-6/as?x=1cc-0-6212-2F8C-AC-52EC-28AD-96-6212-2F8B-96-6212-FAD-94-6212-3FB5-93-6212-FAB-93&ta=1用于6个基站定位，服务器程序调用否三、 技术接口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&mt=0注意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 为电池电量比 mt: 为地图类型，其中0:为自动 1:百度 2:为google1.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&l=zh_CN&p=3&mt=0注意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 mt: 可不填，默认0 代表地图坐标所用的地图,0:根据mcc自动适配baidu, google,2:强制用google地图的坐标 S: 为信号强度 取值范围为：0-113，由rssi+113而得到 在android智能机上取值为：S= 2*asu 测试网站输入/map3.html：S= 2*asu 113; 1.4 p= 各种参数，比如要不要地图之类的：1 表示纯文字2 图片3 文字+图片1.5 s= 用于返回短信的内容字数限制4 返回数据格式是字符串格式，字段用|进行分隔，中文用utf8格式Status:0 /0代表成功，其他是出错原因Cause:OK/原因 出错原因Map:baidu /google 等地图供应商Lat: 22.3245Lon: 114.2456Address:中国深圳湖田例子：0|OK|baidu|22.3245|114.2456|中国深圳湖田2.5 经纬度+基站信息Google地图 带GPS的设备的请使用下面链接 Google地图:1. 用户发送“W”给定位器2. 定位器回复google地图: 2.1 battery=67%,/g.do?y=46803&m=888888000000002&c=460&n=0&a=9779&e=3721&s=100&l=22.587806,113.8562162.2 m=888888000000002是IMEI2.3 其中y: crc16计算(注意y用unsigned short)n:mnc c:mcc a:Lac e:cellid s: 为信号强度比 battery 为电池电量比 l=lat,lng lat: 纬度 latitudes 取值范围从-90到90 建议保留小数后6位 lng: 经度 longitude 取值范围从-180到180 建议保留小数后6位 crc=str(m+c+n+a+e+l); 如果没有l crc=str(m+c+n+a+e) 用户点击超连接，在默认浏览器里面打开位置信息2.6 基站信息转换为经纬度 主要用于服务器查询更新基站经纬坐标：1. 服务器请求或终端请求2. 定位器回复google地图: 2.1 battery=67%,/l.do?y=46803&m=888888000000002&c=460&n=0&a=9779&e=3721&mt=02.2 m=888888000000002是IMEI2.3 其中y: crc16计算(注意y用unsigned short)n:mnc c:mcc a:Lac e:cellid mt: 可不填，默认0 代表地图坐标所用的地图,0:根据mcc自动适配baidu, google,2:强制用google地图的坐标 crc=str(m+c+n+a+e); 如果没有m,就不需要y3. 支持txt和json格式，4. 注意请求json,请把http的ContentType: application/json;charset=UTF-82.7 获取poi带GPS的设备，不报基站信息的接口，主要用于poi请求：1. 用户发送“W”给定位器a) 定位器回复google地图: b) battery=67%,/w.do?y=47220&m=888888000000002&l=22.249997,114.1666819&c=460&p=1c) m=888888000000002是IMEId) 其中y: crc16计算(注意y用unsigned short) c:mcc battery 为电池电量比 l=lat,lng lat: 纬度 latitudes 取值范围从-90到90 建议保留小数后6位 lng: 经度 longitude 取值范围从-180到180 建议保留小数后6位 crc=str(m+l+c+p); 如果没有m crc=str(l+c+p) 用户点击超连接，在默认浏览器里面打开位置信息e) 1.4 p= 各种参数，比如要不要地图之类的：1 表示纯文字2 图片3文字+图片2.8 测试三基站接口 带GPS的设备，测试三基站的准确性，完全用于测试。1. 设备通过GPRS或短信提交到服务器，格式如下/mt.do?x=666666&y=1892&z=000094535&n1=460-1-9529-21541-151&n2=460-1-9529-21542-158&n3=460-1-9529-21241-143&p=1&l=22.576610,113.8610112. 使用请参考m.do接口3. 添加标准gps坐标提交参数l=lat,lng4. 测试流程：a) 与minigps管理员沟通，申请测试串号b) 设备把定位信息提交给/mt.doc) 提交完成后，在网页里面输入：/mt.do?m=666666000094535其中m为自己的申请的测试串号2.9 基站距离接口用于获取基站信息和获取与参考基站的距离，单位为米1. 设备通过GPRS提交到服务器，格式如下:2. /mm.do?x=358688&y=24827&z=000000158&n1=460-0-9779-3721-65&n2=460-0-9779-3724-65&n3=460-0-9779-3723-65&l=en_ZN&p=1&m1=460-0-9779-3721-65&m2=460-0-9779-3722-65&m3=460-0-9779-3723-653. 使用请参考 m.do 接口4. 返回添加 distance 字段，如果距离失败返回 -1 3.0 多基站定位a接口(最多支持6个)短信版(设备使用)设备上报多个基站，组成短信发送给外部手机1. 用户发送“W”给定位器a) 定位器回复短信链接, 用户点击超连接，在默认浏览器里面打开位置信息b) battery=67%,/a?x=358688-18918-000000158-1cc-0-6212-2F8C-AC-52EC-28AD-96-6212-2F8B-96-6212-FAD-94-6212-3FB5-93-6212-FAB-93&ta=1c) 358688为imei的前6位(表示为m1) 000000158为i