关于M6311模组基于位置服务能力平台（LBS）的API进一步测试

最近在研究关于GSM模块定位的问题，之前一直使用了模块的LBS功能中间最基本的关于基站定位接口测试，后来也测试混合定位的接口，在此总结一下，很多内容引用自中移动的论坛，在此感谢

首先需要的流程

1.帐号注册，获取APIKey

位置服务能力平台提供多种API接口，但在使用API接口前，您需要在本站点完成帐号注册。登录后您可以在[账户信息]页面查看您的APIKEY。APIKEY是您调用API接口的核心数据，请妥善保存，并注意保密。

2.查看API介绍，选取所需接口进行业务开发

获取到APIKEY后，您可以继续查看[API接口]页面的调用说明、接口分类、示例代码等部分的介绍，并按照相关说明选取您需要使用的接口，并按照说明进行封装开发。系统还免费赠送了部分使用次数供您进行开发测试。

关于接口有以下几种

1、基站定位：该接口支持对移动、联通手机号码进行位置定位，特别适合手机仅获取到1个基站信息的场景。调用后接口返回该手机所在位置的地理坐标信息，其中包含普通经纬度和针对特定地图纠偏后的经纬度信息，用户可根据实际情况选择特定的返回值进行使用。

基本信息

URL：http://api.lbs.heclouds.com/api/gsmlbs

支持格式：json

http请求方式：GET POST

http://api.lbs.heclouds.com/api/gsmlbs?mcc=460&mnc=0&cell=28655&lac=17695&apikey=您申请的apikey

返回信息：

{

    "lng" : 106.453056,

    "lat" : 29.546194,

    "g_lng" : 106.457052,

    "g_lat" : 29.543613,

    "b_lng" : 106.463494,

    "b_lat" : 29.549861

}

接口说明如图

2、混合定位：混合定位：该接口支持对移动、联通手机号码进行位置定位，适合手机获取到多个基站信息的场景，调用后接口返回该手机所在位置的地理坐标信息，其中包含普通经纬度和针对特定地图纠偏后的经纬度信息，用户可根据实际情况选择特定的返回值进行使用。

基本信息

URL：http://api.lbs.heclouds.com/api/lbs

支持格式：json

http请求方式：GET POST

http://api.lbs.heclouds.com/api/lbs?celltowers=多组基站&type=0&apikey=您申请的APIKEY

返回信息：

{

    "lng" : 93.514483,

    "lat" : 42.840632

}

接口说明如图

在这里注意的是关于type的选择，根据你所需要的地图，选择相应的类型，不然地址会有一些的偏差。

3、地图纠偏

地图纠偏：该接口用于对定位结果的纠偏处理，以解决坐标点在不同地图上显示位置的差异问题。传入定位结果坐标，并选择目标地图类型后，接口就能将坐标数据进行特定转换处理，并返回与该地图对应的坐标。

基本信息

URL：http://api.lbs.heclouds.com/api/jiupian

支持格式：json

http请求方式：GET POST

http://api.lbs.heclouds.com/api/jiupian?lng=113.042773&lat=23.050769&type=0&apikey=您申请的APIKEY

返回信息：

{ 

    "lng" : 113.048154, 

    "lat" : 23.048157

}

然后查询小区和基站信息

使用AT+CCED命令查询小区和基站信息

a)查询当前小区和基站信息（适用于基站定位接口）
[TX] - AT+CCED=0,1        
[RX] - 
+CCED: 460,00,13153,30071,40,75,22,255
OK
说明：当前小区lac=13153  cell id=30071

b)查询临近小区和基站信息（使用于混合定位接口）
[TX] - AT+CCED=0,2        
[RX] – 
+CCED: 
460,00,13153,30231,44,60,22,460,00,13153,30073,20,59,20,460,00,13071,50371,30,65,15,460,00,13153,32011,25,72,16,460,00,13153,30031,12,63,16
OK
说明：红色字体为邻近小区的lac以及cellid
          高亮字体为接受信号强度rxlev

1.使用基站定位接口

a)基站定位接口：http://lbs.heclouds.com/api/gsmlbs.jsp 

报文形式：
GET
http://api.lbs.heclouds.com/api/gsmlbs?mcc=460&mnc=0&cell=30071&lac=13153&apikey=90084BEC3959298F54C6F080EFA6238B HTTP/1.1
Host: api.lbs.heclouds.com

2. 使用混合定位接口

使用M6311时  SS(信号强度)可以由以下公式计算：
ss = -113dBm + (rxlev * 2 - 3)

参数 celltowers：
不带信号强度(ss)的形式

[{"mcc":"460","mnc":"0","lac":"13153","cell":"30231"},{"mcc":"460","mnc":"0","lac":"13153","cell":"30073"},{"mcc":"460","mnc":"0","lac":"13071","cell":"50371"},{"mcc":"460","mnc":"0","lac":"13153","cell":"32011"},{"mcc":"460","mnc":"0","lac":"13153","cell":"30031"}]

报文形式：
GET
/api/lbs?celltowers=[{"mcc":"460","mnc":"0","lac":"13153","cell":"30231"},{"mcc":"460","mnc":"0","lac":"13153","cell":"30073"},{"mcc":"460","mnc":"0","lac":"13071","cell":"50371"},{"mcc":"460","mnc":"0","lac":"13153","cell":"32011"},{"mcc":"460","mnc":"0","lac":"13153","cell":"30031"}]&type=0&apikey=90084BEC3959298F54C6F080EFA6238B HTTP/1.1
Host: api.lbs.heclouds.com

带信号强度(ss)的形式

[{"mcc":"460","mnc":"0","lac":"13153","cell":"30231","ss":"-72"},{"mcc":"460","mnc":"0","lac":"13153","cell":"30073","ss":"-76"},{"mcc":"460","mnc":"0","lac":"13071","cell":"50371","ss":"-86"},{"mcc":"460","mnc":"0","lac":"13153","cell":"32011","ss":"-84"},{"mcc":"460","mnc":"0","lac":"13153","cell":"30031","ss":"-84"}]

报文形式：
GET
/api/lbs?celltowers=[{"mcc":"460","mnc":"0","lac":"13153","cell":"30231","ss":"-72"},{"mcc":"460","mnc":"0","lac":"13153","cell":"30073","ss":"-76"},{"mcc":"460","mnc":"0","lac":"13071","cell":"50371","ss":"-86"},{"mcc":"460","mnc":"0","lac":"13153","cell":"32011","ss":"-84"},{"mcc":"460","mnc":"0","lac":"13153","cell":"30031","ss":"-84"}]&type=0&apikey=90084BEC3959298F54C6F080EFA6238B HTTP/1.1
Host: api.lbs.heclouds.com