minigps基站和GPS数据接入指南文档编号2012111101版本号V4.2保密级别保密文档作者terry审核minigps2012-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大大的提高V2.72013-12-14为as接口增加needaddress参数,代表是否需要位置参数,同时as接口terryV2.82014-01-01为了缩短地址描述长度,as接口增加高德地址描述,mt=3terryV2.92014-01-02as接口增加返回标准坐标+高德地址描述,mt=4terryV3.02014-01-15a接口增加对gps的支持terryV3.12014-03-03为了简化接入工作,去掉部分老接口,详细解释新接口terryV3.22014-03-16增加返回值描述,删除其他接口一览表,增加短域名字段(s参数)解释terryV3.32014-04-03增加服务器接入,http注意点:使用get方式,服务器请求最多支持7个基站,短信最多支持6个基站terryV3.42014-04-16增加根据经纬度返回当时的时间参数t(含义time)terryV3.52014-05-24增加62进制终端接入方式b接口terryV3.62014-05-24增加GPS定位接口terryV3.72014-05-28增加62进制GPS服务器接口bs接口terryV3.82014-09-27为了提高服务质量和针对国内外客户要求,增加动态切换接入服务器说明,增加电信数据接入字段对应表terryV3.92015-5-11增加根据当前位置下载ublox星历接口ubterryV4.02015-6-24增加接口ar,返回定位精度参数Terryradius,(取代)删除as接口V4.12015-7-24增加基站wifi混合定位“cw”接口terryV4.22015-8-13删除以前的AR(纯基站定位)接口,统一使用CW(Cell&Wifi混合定位接口)terry目录目录...............................................................................................................................................5一、动态切换接入服务器说明................................................................................................6二、终端基站设备接入16进制(A接口)........................................................................6三、终端基站设备接入62进制(B接口)........................................................................9四、基站+WiFI数据服务器接入(CW接口)................................................................12五、返回数据格式....................................................................................................................14六、短链接举例........................................................................................................................15七、电信数据接入字段对应表..............................................................................................16八、ublox星历下载(UB接口)........................................................................................16版权申明.............................................................................................................................................19一、动态切换接入服务器说明域名物理位置备注minigps.net新加坡和美国服务器组成集群主要为国外客户和需要出口国外的客户提供服务minigps.org阿里云杭州站服务器组成集群主要为国内客户服务agps.co指向minigps.net短域名,为短信定位服务选择策略:1.选择主服务域名贵公司服务器在国外:请选择minigps.net为主域名贵公司服务器在国内:请选择minigps.org为主域名2.动态切换贵公司服务器在国内同时需要给国外客户提供服务:根据终端上报的mcc选择服务器,mcc==460选择minigps.org,其他选择minigps.net3.防意外方案:访问主域名失败,切换到另外一个域名访问,以防万一。4.短信定位客户:请使用agps.co,暂无其他可选域名二、终端基站设备接入16进制(A接口)注意:通过短信地图链接方式直接访问服务器的,为了避免串号重复导致无法定位问题,请设备预留短信更换IMEI功能接口描述:终端设备上报多个基站信息,组成请求链接,发送给对应的服务器或者用短信发送给查询的手机。接口样例:基站定位样例=358688-18918-000000158-1cc-0-6212-2F8C-AC-52EC-28AD-96-6212-2F8B-96-6212-FAD-94-6212-3FB5-93-6212-FAB-93&ta=1GPS定位样例=666666-20732-000088701-2D4-3-200-4E55-93&ta=0&l=-23.314497,-45.986083格式说明:=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-17218918crc的值为unsignedshortcrc(GPS定位)是crc=crc16(m1+m2+n1+l);其中:n1:为主基站信息mcc-mnc-lac1-cellid1-signal1格式10进制组成的基站信息例子格式为:724-3-512-20053-147l:为gps的经纬度-23.314497,-45.98608320732crc的值为unsignedshortmcc是国家编码的16进制1cc必须从基站信息里面动态取出来,不能读取sim卡里面的,更不能写死mnc是运营编码的16进制0必须从基站信息里面动态取出来,不能读取sim卡里面的,更不能写死lac1是基站1的位置区编码(大区)的16进制6212cellid1是基站1的小区编码(小区)的16进制2F8Csignal1是基站1的信号强度16进制AC从设备里面读取对应的rxlev+110然后转换为16进制lac2否基站2的位置区编码(大区)的16进制52ECcellid2否基站2的小区编码(小区)的16进制28ADsignal2否基站2的信号强度16进制96从设备里面读取对应的rxlev+110然后转换为16进制lac3否基站3的位置区编码(大区)的16进制6212cellid3否基站3的小区编码(小区)的16进制2F8Bsignal3否基站3的信号强度16进制96从设备里面读取对应的rxlev+110然后转换为16进制lac4否基站4的位置区编码(大区)的16进制6212cellid4否基站4的小区编码(小区)的16进制FADsignal4否基站4的信号强度16进制94从设备里面读取对应的rxlev+110然后转换为16进制lac5否基站5的位置区编码(大区)的16进制6212cellid5否基站5的小区编码(小区)的16进制3FB5signal5否基站5的信号强度16进制93从设备里面读取对应的rxlev+110然后转换为16进制lac6否基站6的位置区编码(大区)的16进制6212cellid6否基站6的小区编码(小区)的16进制FABsignal6否基站6的信号强度16进制93从设备里面读取对应的rxlev+110然后转换为16进制p否返回数据类型:默认p=3用的默认1:表示纯文字3:文字+图片mt否经纬度纠偏类型:默认mt=10:表示使用标准经纬度1:根据mcc所在的国家自动2:Google地图的经纬度用的默认短信版用1ta是提前到达时间,通过手机终端获取1取值范围0-255l否l=lat,lonGps定位的时候使用s否s=请求返回内容长度70Unicode的短信长度返回短域名格式:地址描述+短地址链接t否是否需要返回当地时间:默认t=00:不需要1:需要用的默认已经增加了世界范围的时区值,格式为24小时:yyyy-MM-ddHH:mm:ss三、终端基站设备接入62进制(B接口)注意:通过短信地图链接方式直接访问服务器的,为了避免串号重复导致无法定位问题,请设备预留短信更换IMEI功能接口描述:终端设备上报多个基站信息,组成请求链接,发送给对应的服务器或者用短信发送给查询的手机。接口样例:基站定位样例=358688-18918-000000158-7Q-0-6Ww-3AK-10&ta=1GPS定位样例http: