minigps基站和GPS数据接入指南

1、minigpsminigps 基站和基站和 GPSGPS 数据接入指南数据接入指南 文档编号 版 本 号 V 4.2 保密级别保 密 文档作者 terry 审 核 minigps 2012-11-112012-11-11 文档变更记录文档变更记录 版本号变更时间变更内容执笔人 V1.02012-11-11 建立初稿 terry V1.12012-11-25 改进 http 网址 terry V1.22012-12-18 增加 http 请求 poi 接口 terry V1.32012-12-24 增加 http 请求的文本格式 terry V1.42013-01-26 增加多基站请求格式 te

2、rry V1.52013-02-02 修改示例请求的 crc terry V1.62013-04-09 增加 gps 设备的接口 terry V1.72013-04-16 把文档改成表格式 terry V1.8 2013-04-17 增加根据经纬度转换为地址描述 的接口 terry V1.9 2013-04-27 增加 l.do 接口强制指定为 google 地图数据 terry V2.02013-05-15 增加 mt 参数，以便指定返回坐标 类型 terry V2.22013-06-24 增加短信内包含短域名支持 terry V2.32013-06-30 增加三基站测试接口，供客户测 试三

3、基站准确性 terry V2.42013-07-13 增加基站距离接口 mm，供客户做 电子围栏功能，添加 agps 接口， 供客户做 agps 功能 terry V2.52013-10-13 增加 6 基站定位接口 a 和 as 接口， 供客户提供多个基站(超过 3 个)进 行定位 terry V2.62013-12-03 6 基站接口添加 ta 参数，定位精 terry 度大大的提高 V2.72013-12-14 为 as 接口增加 needaddress 参数， 代表是否需要位置参数,同时 as 接 口 terry V2.82014-01-01 为了缩短地址描述长度，as 接口 增加高德

4、地址描述，mt=3 terry V2.92014-01-02 as 接口增加返回标准坐标+高德地 址描述, mt=4 terry V3.02014-01-15 a 接口增加对 gps 的支持 terry V3.12014-03-03 为了简化接入工作，去掉部分老 接口，详细解释新接口 terry V3.22014-03-16 增加返回值描述，删除其他接口 一览表,增加短域名字段(s 参数)解 释 terry V3.32014-04-03 增加服务器接入，http 注意点:使 用 get 方式,服务器请求最多支持 7 个基站，短信最多支持 6 个基站 terry V3.42014-04-16 增

5、加根据经纬度返回当时的时间 参数 t(含义 time) terry V3.52014-05-24 增加 62 进制终端接入方式 b 接口 terry V3.62014-05-24 增加 GPS 定位接口 terry V3.72014-05-28 增加 62 进制 GPS 服务器接口 bs 接口 terry V3.82014-09-27 为了提高服务质量和针对国内外 客户要求，增加动态切换接入服 务器说明，增加电信数据接入字 段对应表 terry V3.92015-5-11 增加根据当前位置下载 ublox 星历 接口 ub terry V4.02015-6-24 增加接口 ar,返回定位精度参

6、数 radius, (取代)删除 as 接口 Terry V4.12015-7-24 增加基站 wifi 混合定位 “cw” 接 口 terry V4.22015-8-13 删除以前的 AR(纯基站定位)接口， 统一使用 CW(Cell 其中: n1:为主基站信息 mcc-mnc-lac1- cellid1-signal1 格式 10 进制组成的 基站信息 例子格式为:460-0-25106-12172-172 18918crc 的值为 unsigned short crc(GPS 定位定位)是crc=crc16(m1+m2+n1+l); 其中: n1:为主基站信息 mcc-mnc-lac1-

7、 cellid1-signal1 格式 10 进制组成的 基站信息 例子格式为:724-3-512-20053-147 l:为 gps 的经纬度-23.,-45. 20732crc 的值为 unsigned short mcc是国家编码的 16 进制1cc必须从基站信息 里面动态取出来， 不能读取 sim 卡 里面的，更不能 写死 mnc是运营编码的 16 进制0必须从基站信息 里面动态取出来， 不能读取 sim 卡 里面的，更不能 写死 lac1是基站 1 的位置区编码(大区)的 16 进 制 6212 cellid1是基站 1 的小区编码(小区)的 16 进制2F8C signal1是基站

8、 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 然后转换

9、为 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

10、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,lonGps 定位的时候 使用 s否s=请求返回内容长度70 Unicode 的 短信长度 返回短域名格式：

11、 地址描述+短地址 链接 t否是否需要返回当地时间：默认 t=0 0:不需要 1：需要 用的默认已经增加了世界 范围的时区值,格 式为 24 小时： yyyy-MM-dd HH:mm:ss 三、终端 基站 设备 接入 62 进制 （B 接口） 注意：通过短信地图链接方式直接访问服务器的，为了避免串号重复导致无法定位问 题，请设备预留短信更换 IMEI 功能 接口描述： 终端设备上报多个基站信息，组成请求链接，发送给对应的服务器或者用短信发 送给查询的手机。 接口样例： 基站定位样例 http:/agps.co/b?x=-18918-7Q-0-6Ww-3AK-10 其中: n1:为主基站信息 m

12、cc-mnc-lac1- cellid1-signal1 格式 10 进制组成的 基站信息 例子格式为:460-0-25106-12172-172 18918crc 的值为 unsigned short crc(GPS 定位定位)是crc=crc16(m1+m2+n1+l); 其中: n1:为主基站信息 mcc-mnc-lac1- cellid1-signal1 格式 10 进制组成的 基站信息 例子格式为:724-3-512-20053-147 l:为 gps 的经纬度-23.,-45. 20732crc 的值为 unsigned short mcc是国家编码的 62 进制1cc必须从基站信

13、息 里面动态取出来， 不能读取 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 的信号强度

14、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

15、 的位置区编码(大区)的 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用的默

16、认短信版用 1 0：表示使用标准经纬度 1：根据 mcc 所在的国家自动 2：Google 地图的经纬度 ta是提前到达时间，通过手机终端获取1取值范围 0-255 转换为 62 进制 l否l=lat,lonGps 定位的时候 使用 s否s=请求返回内容长度70 Unicode 的 短信长度 返回短域名格式： 地址描述+短地址 链接，转换为 62 进制 t否是否需要返回当地时间：默认 t=0 0:不需要 1：需要 用的默认已经增加了世界 范围的时区值,格 式为 24 小时： yyyy-MM-dd HH:mm:ss 四、基站 +WIFI 数据服务器接入（ CW 接口） 注意： 1. 为了更好最终

17、用户体验，使用 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 服务器。 接口样例： 6212-FAD-94-6212-3F

18、B5-93-6212-FAB-93 ws:s:xo,r:81,m:,s:terry,r:69,m:,s:TP- LINK_3225EE,r:53,m:,s:loushangshengyinxiaodian,r:49,m:,s:MER CURY_zed,r:42,m:,s:TP- LINK_B53E,r:41,m:,s:Xiaomi.WF,r:33,m:,s:YYF123,r:23,m:, s:,r:32,m:,s:68101,r:30,m:,s:Tenda_079EC8,r:29,m:,s:T P- LINK_A0B894,r:31,m:,s:qiu,r:22,m:,s:Kpt,r:23,m:

19、,s:huaw ei,r:22,m:,s:QING,r:26,m:,s:,r:24,m:,s:Full- MyHouse,r:22,m: 格式说明： cellid3-signal3-lac4-cellid4-signal4-lac5-cellid5-signal5-lac6-cellid6- signal6/0 代表成功 1 代表失败，具体原因查看 Cause String Cause = ;/”OK” 代表成功或其他原因 String Map = ;/返回的经纬度纠偏格式:”std”、”baidu”、”google” Double Lat = 0.0;/纬度，精确到小数点后 6 位 Doub

20、le Lon = 0.0;/精度，精确到小数点后 6 位 String Address = ;/返回的地址描述，如果传递 needaddress=0, 此值为空” Int Radius=0; /定位精度 文本类型,”|”分隔符字符串: 设置 http 头: Content-Type:text/plain Status|Cause|Map|Lat|Lon|Address|Radius 六、短链接举例 http:/agps.co/a?x=-18918-1cc-0-6212-2F8C-AC-52EC-28AD-96-6212-2F8B-96- 6212-FAD-94-6212-3FB5-93-621

21、2-FAB-93恒泽堂食妆 店 NO.068、太平洋大酒店、鱼米之乡 http:/agps.co/Ij6nI3,map:baidu,status:0,lat:31.846,lon:1 20.855 发送以下内容给最终用户，从而在一条短信内显示地址和地图链接： 江苏省无锡市北塘区解放西路 418;恒泽堂食妆店 NO.068、太平洋大酒店、 鱼米之乡 http:/agps.co/Ij6nI3 七、电信数据接入字段对应表 参数参数对应采集参数对应采集参数含义含义备注备注 mccmcc国家编码必须从基站信息 里面动态取出来， 不能读取 sim 卡 里面的，更不能 写死 mncsid是系统识别码，每个地

22、级市只 有一个 sid，是一般是唯一的， 但也有几个地市共用一个 sid 情况，尤其是近年划分出来的 地市。 必须从基站信息 里面动态取出来， 不能读取 sim 卡 里面的，更不能 写死 lacnid网络识别码，由各本地网管理， 也就是由地级分公司分配。每 个地级市可能有 1 到 3 个 nid cellidbid网络中的某一个小区，可以理 解为基站 八、UBLOX 星历下载 （UB 接口） 注意： 1.用终端直接接入，不限制 ip 和 IMEI 2.不计费用，为了跟进售后服务，需要登记厂商名字(factoryname) 3.请使用 GET 方式 4.最多支持 7 个基站，请求可以 1-7 个

23、基站数据之间 5.星历更新周期，建议 2 小时更新一次 接口描述： 对接终端或者服务器发送最后一次经纬度和多个基站信息组成的请求链接给 agps.co 服务器, 返回当前位置所在的星历数据。 接口样例： http:/agps.co/ub?x=1cc-0-6212-2F8C-AC-52EC-28AD-96-6212-2F8B-96-6212- FAD-94-6212-3FB5-93-6212-FAB-93&l=31.,120.&f=888 格式说明： http:/agps.co/ub? x=mcc-mnc-lac1-cellid1-signal1-lac2-cellid2-signal2-lac

24、3-cellid3- signal3-lac4-cellid4-signal4-lac5-cellid5-signal5-lac6-cellid6-signal6-lac7- signal7&l=lat,lon&f=888 参数列表： 参数参数是否必须是否必须含义含义样例样例备注备注 mcc是国家编码的 16 进制1cc必须从基站信息 里面动态取出来， 不能读取 sim 卡 里面的，更不能 写死 mnc是运营编码的 16 进制0必须从基站信息 里面动态取出来， 不能读取 sim 卡 里面的，更不能 写死 lac1是基站 1 的位置区编码(大区)的 16 进 制 6212 cellid1是基站

25、1 的小区编码(小区)的 16 进制2F8C signal1是基站 1 的信号强度 16 进制AC从设备里面读取 对应的 rxlev+110 然后转换为 16 进 制 lac2否基站 2 的位置区编码(大区)的 16 进 制 cellid2否基站 2 的小区编码(小区)的 16 进制 signal2否基站 2 的信号强度 16 进制从设备里面读取 对应的 rxlev+110 然后转换为 16 进 制 lac3否基站 3 的位置区编码(大区)的 16 进 制 cellid3否基站 3 的小区编码(小区)的 16 进制 signal3否基站 3 的信号强度 16 进制从设备里面读取 对应的 rxl

26、ev+110 然后转换为 16 进 制 lac4否基站 4 的位置区编码(大区)的 16 进 制 cellid4否基站 4 的小区编码(小区)的 16 进制 signal4否基站 4 的信号强度 16 进制从设备里面读取 对应的 rxlev+110 然后转换为 16 进 制 lac5否基站 5 的位置区编码(大区)的 16 进 制 cellid5否基站 5 的小区编码(小区)的 16 进制 signal5否基站 5 的信号强度 16 进制从设备里面读取 对应的 rxlev+110 然后转换为 16 进 制 lac6否基站 6 的位置区编码(大区)的 16 进 制 cellid6否基站 6 的小区编码(小区)的 16 进制 signal6否基站 6 的信号强度 16 进制从设备里面读取 对应的 rxl