鲸云混合定位开放平台在合理范围内向所有个人、企业或组织提供定位能力。

开发者需注册为个人账户或企业账户，并获取API KEYS后才能使用平台能力。

*接口能力，依据帐户对开放平台的贡献值，未能对开发平台贡献的帐户，开放平台有权限制其接口能力或终止提供服务。

如何贡献？

开放平台提供两种定位接口

平台侧定位接口：
  • 由终端将网络基础设施信息上送至业务或产品平台
  • 由业务或产品平台将网络基础信息转发给开发平台
  • 由开放平台根据转发过来的网络基础信息计算后，将位置信息返回给业务或产品平台
接口调用请求说明： 
HTTP请求方式：POST
http://yunapi.zuotoujing.net/loc/01/platform?appKey=APPKEY
调用示例： 
{
    "data": {
        "trackFlag" : false, 
        "lonLatType" : 1, 
        "cell_towers" : [
            {
                "id" : 12,
                "lac" : 3,
                "mcc" : 0,
                "mnc" : 460,
                "rssi" : 0,
                "age" : 0,
                "ta" : 0
            }
            //如果有多个基站，此处应还有几段cell_towers结构
        ],
        "wifi_towers" : [
            {
                "mac" : '00-3a-9a-76-f9-90',
                "rssi" : 0,
                "age" : 0
            }
            //如果有多个WIFI，此处应还有几段wifi_towers结构
        ]      
    }
}
参数说明：
参数 是否必须 说明
trackFlag 否 false:基本模式（默认）
true:详细跟踪模式，返回结果与标准的不同
lonLatType 否 返回数据采用的坐标系
0:WGS84坐标系
1:GCJ02坐标系（默认）
cell_towers 否 基站数据对象数组。查询数据中至少传入cell_tower和wifi_tower中一组数据
wifi_towers 否 wifi数据对象数据。查询数据中至少传入cell_tower和wifi_tower中一组数据
cell_towers数组说明
id 是 基站标识的唯一标识，GSM网络的CID，CDMA网络的BSID
lac 是 小区号标识数据，GSM网络的LAC，CDMA网络的NID
mcc 是 运营商国家编码，GSM网络和CDMA都是MCC
mnc 是 网络标识，GSM网络的MNC，CDMA网络的SID
rssi 是 当前基站广播的信号强度，单位是DBM
age 否 从检测到基站到请求定位服务的时 间，单位：毫秒
ta 否 由基站向移动台发送，移动台据以确定其发往基站的定时超前量，以补偿传播时延的信号。
wifi_towers数组说明
mac 是 WIFI结点（路由器）的MAC地址
rssi 否 当前WIFI广播的信号强度，单位是DBM
age 否 从检测到wifi热点到请求定位服务的时间，单位：毫秒
返回说明：

正确情况下返回JSON数据包的结果如下：

{
    "data": {
        "longitude": 117.53047384999999,
        "latitude": 27.214197675924794
    },
    "description": "成功返回数据！",
    "result": "00"
}
参数 描述
longitude 定位返回的经度
latitude 定位返回的纬度

Track模式下返回JSON数据包的结果如下：

{
    "data": {
        "result": {
            "longitude": 117.53047384999999,
            "latitude": 27.214197675924794
        },
        "wifiList": [
            {
                "id": "56ebad7f549c39f04fc9c4c0",
                "lON": 121.538263,
                "lAT": 31.128211,
                "cITY": "",
                "mAC": "00-3a-9a-76-f9-90",
                "sSID": "3FMeetingRoom2"
            },
            {
                "id": "56ebacea549c39f04fc9c4bc",
                "lON": 121.683582,
                "lAT": 31.234826,
                "cITY": "",
                "mAC": "14-e6-e4-86-85-f6",
                "sSID": "fdf"
            },
            
        ],
        "cellList": [
            {
                "id": "56e804b02f48b6e3613aa8fc",
                "lON": 121.8049132,
                "lAT": 31.1406532,
                "mCC": 460,
                "nET": 0,
                "aREA": 6317,
                "cELL": 12466
            },
            {
                "id": "56e804aa2f48b6e3613a4b16",
                "lON": 113.2560345,
                "lAT": 23.1443762,
                "mCC": 460,
                "nET": 0,
                "aREA": 3,
                "cELL": 12
            }
        ],
        "cWIFIList": [
            {
                "longitude": 121.538263,
                "latitude": 31.128211
            },
            {
                "longitude": 121.537874,
                "latitude": 31.128629
            },
            {
                "longitude": 121.537636,
                "latitude": 31.12876
            }
        ]
    },
    "description": "成功返回数据！",
    "result": "00"
}
参数 描述
result 定位结果
wifiList 所有wifi上传数据匹配结果
cellList 所有cell上传数据匹配结果
cWIFIList 所有wifiList排除掉干扰点后结果
result节点说明
longitude 定位返回的经度
latitude 定位返回的纬度
wifiList节点说明
id 主键ID
lON 经度
lAT 纬度
cITY 所在城市
mAC 物理地址
sSID 服务集标识
cellList节点说明
longitude 经度
latitude 纬度
cWIFIList节点说明
id 主键ID
lON 经度
lAT 纬度
cITY 所在城市
mAC 物理地址
sSID 服务集标识

错误情况下返回JSON数据包的结果如下：

{
    "data": null,
    "result": "01",
    "description": "原因"
}
result返回码说明：
代码 说明
00 成功返回数据！
-10 请求参数错误，请对照文档重新请求！
-20 不存在的wifi或cell数据！
01 其它异常错误
DEMO下载：

JAVA

硬件侧定位接口(推荐)：
  • 由终端将网络基础设施信息直接送至开放平台
  • 开放平台根据网络基础信息计算后，将位置信息返回给终端
  • 终端将位置信息联同其它信息一起返回给业务或产品平台
接口调用请求说明： 
HTTP请求方式：POST
http://yunapi.zuotoujing.net/loc/02/device?appKey=APPKEY
调用示例： 
{
    "data": {
        "appKey" : APPKEY, 
        "lonLatType" : 1, 
        "meid" : "1234567890", 
        "cell_towers" : [
            {
                "id" : 12,
                "lac" : 3,
                "mcc" : 0,
                "mnc" : 460,
                "rssi" : 0,
                "age" : 0,
                "ta" : 0
            }
            //如果有多个基站，此处应还有几段cell_towers结构
        ],
        "wifi_towers" : [
            {
                "mac" : '00-3a-9a-76-f9-90',
                "rssi" : 0,
                "age" : 0
            }
            //如果有多个WIFI，此处应还有几段wifi_towers结构
        ]      
    }
}
参数说明：
参数 是否必须 说明
appKey 是 请求方的唯一标识
lonLatType 否 返回数据采用的坐标系
0:WGS84坐标系
1:GCJ02坐标系（默认）
meid 是 请求方设备的meid
cell_towers 否 基站数据对象数组。查询数据中至少传入cell_tower和wifi_tower中一组数据
wifi_towers 否 wifi数据对象数据。查询数据中至少传入cell_tower和wifi_tower中一组数据
cell_towers数组说明
id 是 基站标识的唯一标识，GSM网络的CID，CDMA网络的BSID
lac 是 小区号标识数据，GSM网络的LAC，CDMA网络的NID
mcc 是 运营商国家编码，GSM网络和CDMA都是MCC
mnc 是 网络标识，GSM网络的MNC，CDMA网络的SID
rssi 是 当前基站广播的信号强度，单位是DBM
age 否 从检测到基站到请求定位服务的时 间，单位：毫秒
ta 否 由基站向移动台发送，移动台据以确定其发往基站的定时超前量，以补偿传播时延的信号。
wifi_towers数组说明
mac 是 WIFI结点（路由器）的MAC地址
rssi 否 当前WIFI广播的信号强度，单位是DBM
age 否 从检测到wifi热点到请求定位服务的时间，单位：毫秒
返回说明：

正确情况下返回JSON数据包的结果如下：

{
    "data": {
        "longitude": 117.53047384999999,
        "latitude": 27.214197675924794
    },
    "description": "成功返回数据！",
    "result": "00"
}
参数 描述
longitude 定位返回的经度
latitude 定位返回的纬度

错误情况下返回JSON数据包的结果如下：

{
    "data": null,
    "result": "01",
    "description": "原因"
}
错误代码说明：

正确情况下返回JSON数据包的结果如下：

{
    "data": {
        "longitude": 117.53047384999999,
        "latitude": 27.214197675924794
    },
    "description": "成功返回数据！",
    "result": "00"
}
result返回码说明：
代码 说明
00 成功返回数据！
-10 请求参数错误，请对照文档重新请求！
-20 不存在的wifi或cell数据！
-30 请求硬件侧定位，meid不能为空！
-40 请求的meid与key不对应！
01 其它异常错误
DEMO下载：

基于STM32L151，SIM900A的示例

硬件开发常用通信模块（2G）获取基站数据：
模块型号 SIM800A
AT指令介绍

AT+CENG=1,1;

AT+CENG?
模块型号 WM9680
AT指令介绍

AT+VCELLTOWER?
硬件开发常用WIFI模块（2G）获取基站数据：
模块型号 ESP8266
AT指令介绍

AT+CWLAP