minigps基站和GPS数据接入指南V42.docx
- 文档编号:30006807
- 上传时间:2023-08-04
- 格式:DOCX
- 页数:28
- 大小:25.84KB
minigps基站和GPS数据接入指南V42.docx
《minigps基站和GPS数据接入指南V42.docx》由会员分享,可在线阅读,更多相关《minigps基站和GPS数据接入指南V42.docx(28页珍藏版)》请在冰豆网上搜索。
minigps基站和GPS数据接入指南V42
minigps基站和GPS数据接入指南
文档编号
2012111101
版本号
V4.2
保密级别
保密
文档作者
terry
审核
minigps
2012-11-11
文档变更记录
版本号
变更时间
变更内容
执笔人
V1.0
2012-11-11
建立初稿
terry
V1.1
2012-11-25
改进http网址
terry
V1.2
2012-12-18
增加http请求poi接口
terry
V1.3
2012-12-24
增加http请求的文本格式
terry
V1.4
2013-01-26
增加多基站请求格式
terry
V1.5
2013-02-02
修改示例请求的crc
terry
V1.6
2013-04-09
增加gps设备的接口
terry
V1.7
2013-04-16
把文档改成表格式
terry
V1.8
2013-04-17
增加根据经纬度转换为地址描述的接口
terry
V1.9
2013-04-27
增加l.do接口强制指定为google地图数据
terry
V2.0
2013-05-15
增加mt参数,以便指定返回坐标类型
terry
V2.2
2013-06-24
增加短信内包含短域名支持
terry
V2.3
2013-06-30
增加三基站测试接口,供客户测试三基站准确性
terry
V2.4
2013-07-13
增加基站距离接口mm,供客户做电子围栏功能,添加agps接口,供客户做agps功能
terry
V2.5
2013-10-13
增加6基站定位接口a和as接口,供客户提供多个基站(超过3个)进行定位
terry
V2.6
2013-12-03
6基站接口添加ta参数,定位精度大大的提高
terry
V2.7
2013-12-14
为as接口增加needaddress参数,代表是否需要位置参数,同时as接口
terry
V2.8
2014-01-01
为了缩短地址描述长度,as接口增加高德地址描述,mt=3
terry
V2.9
2014-01-02
as接口增加返回标准坐标+高德地址描述,mt=4
terry
V3.0
2014-01-15
a接口增加对gps的支持
terry
V3.1
2014-03-03
为了简化接入工作,去掉部分老接口,详细解释新接口
terry
V3.2
2014-03-16
增加返回值描述,删除其他接口一览表,增加短域名字段(s参数)解释
terry
V3.3
2014-04-03
增加服务器接入,http注意点:
使用get方式,服务器请求最多支持7个基站,短信最多支持6个基站
terry
V3.4
2014-04-16
增加根据经纬度返回当时的时间参数t(含义time)
terry
V3.5
2014-05-24
增加62进制终端接入方式b接口
terry
V3.6
2014-05-24
增加GPS定位接口
terry
V3.7
2014-05-28
增加62进制GPS服务器接口bs接口
terry
V3.8
2014-09-27
为了提高服务质量和针对国内外客户要求,增加动态切换接入服务器说明,增加电信数据接入字段对应表
terry
V3.9
2015-5-11
增加根据当前位置下载ublox星历接口ub
terry
V4.0
2015-6-24
增加接口ar,返回定位精度参数radius,(取代)删除as接口
Terry
V4.1
2015-7-24
增加基站wifi混合定位“cw”接口
terry
V4.2
2015-8-13
删除以前的AR(纯基站定位)接口,统一使用CW(Cell&Wifi混合定位接口)
terry
一、动态切换接入服务器说明
域名
物理位置
备注
新加坡和美国服务器组成集群
主要为国外客户和需要出口国外的客户提供服务
minigps.org
阿里云杭州站服务器组成集群
主要为国内客户服务
agps.co
指向
短域名,为短信定位服务
选择策略:
1.选择主服务域名
贵公司服务器在国外:
请选择为主域名
贵公司服务器在国内:
请选择minigps.org为主域名
2.动态切换
贵公司服务器在国内同时需要给国外客户提供服务:
根据终端上报的mcc选择服务器,mcc==460选择minigps.org,
其他选择
3.防意外方案:
访问主域名失败,切换到另外一个域名访问,以防万一。
4.短信定位客户:
请使用agps.co,暂无其他可选域名
二、终端基站设备接入16进制(A接口)
注意:
通过短信地图链接方式直接访问服务器的,为了避免串号重复导致无法定位问题,请设备预留短信更换IMEI功能
接口描述:
终端设备上报多个基站信息,组成请求链接,发送给对应的服务器或者用短信发送给查询的手机。
接口样例:
基站定位样例
http:
//agps.co/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
GPS定位样例
http:
//agps.co/a?
x=666666-20732-000088701-2D4-3-200-4E55-93&ta=0&l=-23.314497,-45.986083
格式说明:
http:
//agps.co/a?
x=m1-crc-m2-mcc-mnc-lac1-cellid1-signal1-lac2-cellid2-signal2-lac3-cellid3-signal3-lac4-cellid4-signal4-lac5-cellid5-signal5-lac6-cellid6-signal6&p&mt&ta&l
参数列表:
参数
是否必须
含义
样例
备注
m1
是
终端设备的imei前6位
358688
注意每台设备的imei不能重复
m2
是
终端设备的imei后9位
000000158
注意每台设备的imei不能重复
crc(基站定位)
是
crc=crc16(m1+m2+n1);
其中:
n1:
为主基站信息mcc-mnc-lac1-cellid1-signal1格式10进制组成的基站信息
例子格式为:
460-0-25106-12172-172
18918
crc的值为unsignedshort
crc(GPS定位)
是
crc=crc16(m1+m2+n1+l);
其中:
n1:
为主基站信息mcc-mnc-lac1-cellid1-signal1格式10进制组成的基站信息
例子格式为:
724-3-512-20053-147
l:
为gps的经纬度-23.314497,-45.986083
20732
crc的值为unsignedshort
mcc
是
国家编码的16进制
1cc
必须从基站信息里面动态取出来,不能读取sim卡里面的,更不能写死
mnc
是
运营编码的16进制
0
必须从基站信息里面动态取出来,不能读取sim卡里面的,更不能写死
lac1
是
基站1的位置区编码(大区)的16进制
6212
cellid1
是
基站1的小区编码(小区)的16进制
2F8C
signal1
是
基站1的信号强度16进制
AC
从设备里面读取对应的rxlev+110然后转换为16进制
lac2
否
基站2的位置区编码(大区)的16进制
52EC
cellid2
否
基站2的小区编码(小区)的16进制
28AD
signal2
否
基站2的信号强度16进制
96
从设备里面读取对应的rxlev+110然后转换为16进制
lac3
否
基站3的位置区编码(大区)的16进制
6212
cellid3
否
基站3的小区编码(小区)的16进制
2F8B
signal3
否
基站3的信号强度16进制
96
从设备里面读取对应的rxlev+110然后转换为16进制
lac4
否
基站4的位置区编码(大区)的16进制
6212
cellid4
否
基站4的小区编码(小区)的16进制
FAD
signal4
否
基站4的信号强度16进制
94
从设备里面读取对应的rxlev+110然后转换为16进制
lac5
否
基站5的位置区编码(大区)的16进制
6212
cellid5
否
基站5的小区编码(小区)的16进制
3FB5
signal5
否
基站5的信号强度16进制
93
从设备里面读取对应的rxlev+110然后转换为16进制
lac6
否
基站6的位置区编码(大区)的16进制
6212
cellid6
否
基站6的小区编码(小区)的16进制
FAB
signal6
否
基站6的信号强度16进制
93
从设备里面读取对应的rxlev+110然后转换为16进制
p
否
返回数据类型:
默认p=3
1:
表示纯文字
3:
文字+图片
用的默认
mt
否
经纬度纠偏类型:
默认mt=1
0:
表示使用标准经纬度
1:
根据mcc所在的国家自动
2:
Google地图的经纬度
用的默认
短信版用1
ta
是
提前到达时间,通过手机终端获取
1
取值范围0-255
l
否
l=lat,lon
Gps定位的时候使用
s
否
s=请求返回内容长度
70
Unicode的短信长度
返回短域名格式:
地址描述+短地址链接
t
否
是否需要返回当地时间:
默认t=0
0:
不需要
1:
需要
用的默认
已经增加了世界范围的时区值,格式为24小时:
yyyy-MM-ddHH:
mm:
ss
三、终端基站设备接入62进制(B接口)
注意:
通过短信地图链接方式直接访问服务器的,为了避免串号重复导致无法定位问题,请设备预留短信更换IMEI功能
接口描述:
终端设备上报多个基站信息,组成请求链接,发送给对应的服务器或者用短信发送给查询的手机。
接口样例:
基站定位样例
http:
//agps.co/b?
x=358688-18918-000000158-7Q-0-6Ww-3AK-10&ta=1
GPS定位样例
http:
//agps.co/b?
x=666666-20732-000088701-Bg-3-8G-5DR-b&ta=0&l=-23.314497,-45.986083
格式说明:
http:
//agps.co/b?
x=m1-crc-m2-mcc-mnc-lac1-cellid1-signal1-lac2-cellid2-signal2-lac3-cellid3-signal3-lac4-cellid4-signal4-lac5-cellid5-signal5-lac6-cellid6-signal6&p&mt&ta&l
参数列表:
参数
是否必须
含义
样例
备注
m1
是
终端设备的imei前6位
358688
注意每台设备的imei不能重复
m2
是
终端设备的imei后9位
000000158
注意每台设备的imei不能重复
crc(基站定位)
是
crc=crc16(m1+m2+n1);
其中:
n1:
为主基站信息mcc-mnc-lac1-cellid1-signal1格式10进制组成的基站信息
例子格式为:
460-0-25106-12172-172
18918
crc的值为unsignedshort
crc(GPS定位)
是
crc=crc16(m1+m2+n1+l);
其中:
n1:
为主基站信息mcc-mnc-lac1-cellid1-signal1格式10进制组成的基站信息
例子格式为:
724-3-512-20053-147
l:
为gps的经纬度-23.314497,-45.986083
20732
crc的值为unsignedshort
mcc
是
国家编码的62进制
1cc
必须从基站信息里面动态取出来,不能读取sim卡里面的,更不能写死
mnc
是
运营编码的62进制
0
必须从基站信息里面动态取出来,不能读取sim卡里面的,更不能写死
lac1
是
基站1的位置区编码(大区)的62进制
6212
cellid1
是
基站1的小区编码(小区)的62进制
2F8C
signal1
是
基站1的信号强度62进制
AC
从设备里面读取对应的rxlev然后转换为62进制
lac2
否
基站2的位置区编码(大区)的62进制
52EC
cellid2
否
基站2的小区编码(小区)的62进制
28AD
signal2
否
基站2的信号强度62进制
96
从设备里面读取对应的rxlev然后转换为62进制
lac3
否
基站3的位置区编码(大区)的62进制
6212
cellid3
否
基站3的小区编码(小区)的62进制
2F8B
signal3
否
基站3的信号强度62进制
96
从设备里面读取对应的rxlev然后转换为62进制
lac4
否
基站4的位置区编码(大区)的62进制
6212
cellid4
否
基站4的小区编码(小区)的62进制
FAD
signal4
否
基站4的信号强度62进制
94
从设备里面读取对应的rxlev+110然后转换为16进制
lac5
否
基站5的位置区编码(大区)的62进制
6212
cellid5
否
基站5的小区编码(小区)的62进制
3FB5
signal5
否
基站5的信号强度62进制
93
从设备里面读取对应的rxlev然后转换为62进制
lac6
否
基站6的位置区编码(大区)的62进制
6212
cellid6
否
基站6的小区编码(小区)的62进制
FAB
signal6
否
基站6的信号强度62进制
93
从设备里面读取对应的rxlev然后转换为62进制
p
否
返回数据类型:
默认p=3
1:
表示纯文字
3:
文字+图片
用的默认
mt
否
经纬度纠偏类型:
默认mt=1
0:
表示使用标准经纬度
1:
根据mcc所在的国家自动
2:
Google地图的经纬度
用的默认
短信版用1
ta
是
提前到达时间,通过手机终端获取
1
取值范围0-255
转换为62进制
l
否
l=lat,lon
Gps定位的时候使用
s
否
s=请求返回内容长度
70
Unicode的短信长度
返回短域名格式:
地址描述+短地址链接,转换为62进制
t
否
是否需要返回当地时间:
默认t=0
0:
不需要
1:
需要
用的默认
已经增加了世界范围的时区值,格式为24小时:
yyyy-MM-ddHH:
mm:
ss
四、基站+WiFI数据服务器接入(CW接口)
注意:
1.为了更好最终用户体验,使用wifi服务,需要在最终用户使用的app内置采集sdk
2.请求的服务器ip需要在minigps的服务器的白名单中
3.服务器访问请开启http的keep-alive头字段,底层用长连接
4.支持GET和POST,WIFI数据必须用POST,纯基站用GET
5.最多支持7个基站,请求可以1-7个基站数据之间
6.测试过后,请务必增加needaddress=0参数,加快访问速度
接口描述:
对接服务器发送多个基站信息和WIFI组成的请求链接给minigps服务器。
接口样例:
{"ws":
[{"s":
"xo","r":
81,"m":
804380873802619826},{"s":
"terry","r":
69,"m":
2018924576320342756},{"s":
"TP-LINK_3225EE","r":
53,"m":
674173120793097686},{"s":
"loushangshengyinxiaodian","r":
49,"m":
44590646795096412},{"s":
"MERCURY_zed","r":
42,"m":
1493036308628601666},{"s":
"TP-LINK_B53E","r":
41,"m":
1886798764457115530},{"s":
"Xiaomi.WF","r":
33,"m":
804380873790801898},{"s":
"YYF123","r":
23,"m":
1727168133893408108},{"s":
"737702","r":
32,"m":
29351389594789368},{"s":
"68101","r":
30,"m":
702601139132009148},{"s":
"Tenda_079EC8","r":
29,"m":
1609042850585389016},{"s":
"TP-LINK_A0B894","r":
31,"m":
147508083967379080},{"s":
"qiu","r":
22,"m":
1886798763847597866},{"s":
"Kpt","r":
23,"m":
177047703793291898},{"s":
"huawei","r":
22,"m":
951019280361526896},{"s":
"QING","r":
26,"m":
1609042850656103528},{"s":
"","r":
24,"m":
1477609993926095152},{"s":
"Full-MyHouse","r":
22,"m":
1228675668960445390}]}
格式说明:
参数列表:
参数
是否必须
含义
样例
备注
mcc
是
国家编码的16进制
1cc
必须从基站信息里面动态取出来,不能读取sim卡里面的,更不能写死
mnc
是
运营编码的16进制
0
必须从基站信息里面动态取出来,不能读取sim卡里面的,更不能写死
lac1
是
基站1的位置区编码(大区)的16进制
6212
cellid1
是
基站1的小区编码(小区)的16进制
2F8C
signal1
是
基站1的信号强度16进制
AC
从设备里面读取对应的rxlev+110然后转换为16进制
lac2
否
基站2的位置区编码(大区)的16进制
52EC
cellid2
否
基站2的小区编码(小区)的16进制
28AD
signal2
否
基站2的信号强度16进制
96
从设备里面读取对应的rxlev+110然后转换为16进制
lac3
否
基站3的位置区编码(大区)的16进制
6212
cellid3
否
基站3的小区编码(小区)的16进制
2F8B
signal3
否
基站3的信号强度16进制
96
从设备里面读取对应的rxlev+110然后转换为16进制
lac4
否
基站4的位置区编码(大区)的16进制
6212
cellid4
否
基站4的小区编码(小区)的16进制
FAD
signal4
否
基站4的信号强度16进制
94
从设备里面读取对应的rxlev+110然后转换为16进制
lac5
否
基站5的位置区编码(大区)的16进制
6212
cellid5
否
基站5的小区编码(小区)的16进制
3FB5
signal5
否
基站5的信号强度16进制
93
从设备里面读取对应的rxlev+110然后转换为16进制
lac6
否
基站6的位置区编码(大区)的16进制
6212
cellid6
否
基站6的小区编码(小区)的16进制
FAB
signal6
否
基站6的信号强度16进制
93
从设备里面读取对应的rxlev+110然后转换为16进制
p
否
返回数据类型:
默认p=3
1:
表示纯文字
3:
文字+图片
用的默认
mt
否
经纬度纠偏类型:
默认mt=1
0:
表示使用标准经纬度
1:
根据mcc所在的国家自动
2:
Google地图的经纬度
用的默认
短信版用1
needaddress
否
是否需要位置信息,1代表需要0代表不需要(0访问会快很多),默认为1
用的默认
大量访问请使用0,目前没有开启地址返回
Wifi数据
否
用json数组,请联系客服要对应的数据结构
无
放到post里面发送:
用rxlev格式,请不要出现负数
rssi+110,如果小于0,设置为0
五、返回数据格式
请求返回数据类型p=1的情况下,返回数据为utf8数据格式,可以设置请求返回的数据格式(默认为json格式):
●json格式不设置http头Content-Type,或者强制设置为:
Content-Type:
Application/Json
publicclassLocPoiResponse{
intStatus=0;//0代表成功1代表失败,具体原因查看Cause
StringCause="";//”OK”代表成功或其他原因
StringMap="";//返回的经纬度纠偏格式:
”std”、”baidu”、”google”
DoubleLat=0.0;//纬度,精确到小数点后6位
DoubleLon=0.0;//精度,精确到小数点后6位
StringAddress="";//返回的地址描述,如果传递needaddress=0,此值为空””
IntRadius=0;//定位精度
}
●文本类型,”|”分隔符字符串:
设置http头:
Content-Type:
text/plain
Status|Cause|Map|Lat|Lon|Address|Radius
六、短链接举例
http:
//agps.co/a?
x=358688-18918-
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- minigps 基站 GPS 数据 接入 指南 V42