Q群:
电话:
邮箱:
地址:
登录OnePos定位服务平台
创建产品
在上方导航栏,找到产品管理,点击右侧添加产品,
产品类型选择服务端,应用场景和启用服务参照以下配置选择对应项:
参数 | 描述 |
---|---|
产品类型 | 服务端:提供云对云接入,通过HTTP接口返回定位结果终端设备:提供设备端接入,通过MQTT返回定位结果 |
应用场景 | 商用:提供商用服务,需要用户申请开通测试:提供免费定位服务,API调用总量和并发量比商用服务低 |
启用服务 | 可选不同的定位服务,包括基站、WiFi定位和已定制的服务,商用和测试分别有不同的服务 |
IP白名单 | 产品类型为服务端时可选 |
产品列表中每个产品对应唯一的Master-Key,云对云调用的API接口中,需要传此参数,可点击获取查看key,发送验证码后,填写收到的验证码,再次点击获取即可查看。
您可以通过发送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
}
}
服务管理对普通开发者和企业用户有着不同页面,想要查看更多内容请前往企业认证。
如果是普通开发者,在服务管理中可以查看服务的使用情况,以及申请服务配额。
当服务的使用额度超出限额时,则可以申请配额。如下:
这时可以点击申请配额,通过验证短信来获取服务额度。
如果是企业用户页,则除了以上业务外,还拥有定制化服务申请和商用服务申请业务。
在定制化服务申请中您可以向我们提交自己的定制化定位需求,不日我们将会联系您进行进一步洽谈。
在页面下方,可以提交我们所提供的商用定位服务的使用申请。在提交申请后,我们将进行审核,审核通过您将可以使用您所申请的服务,该服务也将出现在您的服务管理中。