全部文档
OneOS简介 硬件支持 快速开发指南 编译构造工具 API参考文档 高级语言 用户编程手册 OnePos定位 应用笔记 FAQ

服务端产品配置

创建产品

  1. 登录OnePos定位服务平台

  2. 创建产品

    在上方导航栏,找到产品管理,点击右侧添加产品

    1607935722429

产品类型选择服务端应用场景启用服务参照以下配置选择对应项:

参数 描述
产品类型 服务端:提供云对云接入,通过HTTP接口返回定位结果终端设备:提供设备端接入,通过MQTT返回定位结果
应用场景 商用:提供商用服务,需要用户申请开通测试:提供免费定位服务,API调用总量和并发量比商用服务低
启用服务 可选不同的定位服务,包括基站、WiFi定位和已定制的服务,商用测试分别有不同的服务
IP白名单 产品类型为服务端时可选

获取密钥

产品列表中每个产品对应唯一的Master-Key,云对云调用的API接口中,需要传此参数,可点击获取查看key,发送验证码后,填写收到的验证码,再次点击获取即可查看。

1607938116642

API接口

您可以通过发送HTTP请求调用定位服务API。

请求结构如下:

HTTP 1.1 POST

URL: https://${Endpoint}/onepos/api/user/position

ContentType: application/json

请求参数:

参数 类型 是否必须 说明
masterKey String true 由OnePos平台分配的key
imei String true imei号
smac String false mac码
serverip String false 设备接入基站时对应的网关ip
imsi String false 移动用户识别码
macs String false 接收到的热点mac信息,见附表1 (wifi信息的格式:mac,rssi),wifi之间使用\ 分隔开。(macs和cells必填一个)
netType int false 网络制式(1 GSM、2 CDMA、3 WCDMA、4 TD_CDMA、5 LTE)
cells String false 接收到的基站信息,见附表2(基站信息的格式:mcc,mnc,lac,cell_id,rssi),基站之间使用\ 分隔开,基站信息均为10进制。(macs和cells必填一个)

附表1:

参数名称 类型 是否必须 描述
mac String true Wifi热点 mac信息
rssi int true Wifi热点信号强度

附表2:

参数名称 类型 是否必须 描述
mcc int true 移动国家号码,仅支持460
lac int true 地区区域码
mnc int true 移动网号,目前仅支持0
cell_id int true 基站码
rssi int true 信号强度

返回数据:

字段名 类型 是否必须 说明
code int true 响应code,详见状态码
msg String true 响应msg
content Object true 响应数据
pos String true 定位数据
at Long true 定位时间
type Int true 0-无定位数据,1-定位数据正常

状态码

Code 状态描述
0 成功
11004 用户的key不存在
11019 macs和cells不能同时为空
11002 系统内部错误
11020 参数错误,imei长度必须等于15位的描述
10001 参数错误,%s

使用示例

请求示例:

body:

{ 
    "imei":"123112*******21299",
    "masterKey":"e6d98812249bc2************a4b5d21ec938",
    "macs":"00:e0:61:53:c1:f2,-57|06:74:9c:76:b5:c6,-47|8c:a6:df:bf:01:b4,-54"
}

响应示例:

{
    "code": 0,
    "msg": "成功",
    "content": {
        "pos": "30.547853367251793,104.0581215581712",
        "at": 1607939892158,
        "type": 1
    }
}

服务管理

服务管理对普通开发者和企业用户有着不同页面,想要查看更多内容请前往企业认证。

如果是普通开发者,在服务管理中可以查看服务的使用情况,以及申请服务配额。

申请配额

当服务的使用额度超出限额时,则可以申请配额。如下:

image-20201214160831177

这时可以点击申请配额,通过验证短信来获取服务额度。

image-20201214160945939

如果是企业用户页,则除了以上业务外,还拥有定制化服务申请和商用服务申请业务。

定制化服务申请

在定制化服务申请中您可以向我们提交自己的定制化定位需求,不日我们将会联系您进行进一步洽谈。

image-20201214161851319

商用服务申请

在页面下方,可以提交我们所提供的商用定位服务的使用申请。在提交申请后,我们将进行审核,审核通过您将可以使用您所申请的服务,该服务也将出现在您的服务管理中。

image-20201214162049685

results matching ""

    No results matching ""

    返回顶部