基站查询api文档

约定

  1. 所有请求参数,以json形式发送
  2. 返回参数中包含code和msg,code非0则为失败,msg记录失败信息。失败时,http状态码为非200的值
  3. 所有的时间以秒级的时间戳形式传递

host

https://api.openluat.com

认证

认证方式为HTTP Basic Authorization,即在headers中增加Basic auth认证,填入appkey和appsecret。appkey和appsecret可在openluat项目页面查看。

公共headers

{"Content-Type": "application/json"}

接口详细

多基站查询接口

  • 请求URL

iot/cell_location

  • 请求方式

POST

  • 请求参数
请求参数 参数类型 是否必须 参数说明
cell 数组 传入的数据
  • cell数组,元素为键值对
参数 参数类型 是否必须 参数说明
mcc Integer mcc值
mnc Integer mnc值
lac Integer lac值
ci Integer ci值
csq Integer ASU, 0-31 从AT指令CSQ查到的,与rssi选填一个
rssi Integer 信号强度dBm, 负值, 与csq选填一个 2 * csq - 113 = dBm
  • 返回参数
返回参数 参数类型 是否必须 参数说明
code Integer 执行结果code
msg String 执行结果消息
result 键值对 返回结果,详细描述见下表
  • result
返回参数 参数类型 是否必须 参数说明
lng Float 经度
lat Float 纬度
error String 如果输入的数据有误或查询不到,此处返回第一个输入是错误的 e.g '1,3'表示,第一个和第三个错误
  • 错误码说明
code msg 说明
1 操作失败 常规错误
2 参数错误 传参有误或传参非json
  • python请求示例
import requests
from requests.auth import HTTPBasicAuth
requests.post('http://api.openluat.com/iot/cell_location',
             json={
                "cell": [   # 穿一组就是单基站查询,多组就是多基站查询
                    {
                        'mcc': 460,
                        'mnc': 0,
                        'lac': 25303,
                        'ci' : 23444,
                        'rssi': -51
                    },
                ]
             },
             auth=HTTPBasicAuth('appkey', 'appsecret')
)
print(r.content)
  • 返回示例
{
  "code": 0,
  "msg": "",
  "result": {
    "lat": 32.054748538825955,
    "lng": 118.89016725419843
  }
}

基站查询主页

http://bs.openluat.com