快速开始

接口概述

华为智简园区网络（CloudCampus）解决方案提供位置服务类接口，包括iMaster NCE-Campus 位置服务类接口和WLAN 设备南北向位置接口，主要应用场景是华为提供Wi-Fi/蓝牙位置数据给LBS服务器，由LBS服务器解析位置数据，为最终客户提供热力图、轨迹跟踪、客流分析等增值业务应用。

目前CloudCampus解决方案支持基于Wi-Fi和蓝牙两种方案提供位置服务。

基于Wi-Fi的位置服务

基于Wi-Fi的位置服务有两种方式上报位置数据至第三方服务器：

• WLAN AP直接上报终端位置数据

• iMaster NCE-Campus中继上报终端位置数据

更多方案请参考：生态合作

WLAN AP直接上报终端位置数据

数据上报流程与报文格式

WLAN AP周期性扫描其他Wi-Fi终端，并以固定间隔向第三方位置服务器上送定位报文。

WLAN（AP/AC）设备与定位服务器间采用UDP报文上报定位信息，由于本版本的接口支持TLV扩展的方式，服务器需要保持前向与后向兼容的能力：

1. 对于不支持的TLV扩展参数，服务器需要支持忽略它。

2. 对于服务器需要的TLV扩展参数，而设备没有上报的话，要有缺省值以正常处理接口消息。

定位数据从AP或者AC发送给定位服务器，报文类型为普通的UDP报文：

AP/AC根据配置的上报周期参数周期性上报检测到所有Wi-Fi终端的信息，Payload数据报文部分结构如下：

可选参数定义：

配置流程

1. 使用华为云帐号登录沙箱预约系统。

2. 请参考沙箱使用指导，登录iMaster NCE-Campus。

3. 在iMaster NCE-Campus上，打开“配置 > 站点配置”。

4. 选择“站点 > 业务配置”，在配置详情页面选择“AP增值业务”。

   在该界面下使能“开启上传功能”开关，并正确填写第三方位置服务器的IP/域名以及端口号。根据实际场景配置“周期”和“阈值”。

   
   

   

5. 单击“应用”。

iMaster NCE-Campus中继上报终端位置数据

iMaster NCE-Campus支持将云AP采集的终端位置数据汇聚，周期性的发送给第三方位置服务器。由第三方位置服务器解析位置数据后，经过一些列算法和数据分析，为最终客户提供热力图、轨迹跟踪、客流分析等增值业务应用。

数据上报流程

华为iMaster NCE-Campus中继上报位置数据方案，为增强数据传输的安全性，采用了安全校验机制。

iMaster NCE-Campus中继上报终端位置组网

安全机制

安全校验机制的认证凭据，主要包括如下两类字段：

• secret : secret由第三方系统生成，用于iMatser NCE-Campus发送的数据时的身份校验。secret为16进制字符且最大字符数为32。

• validator : iMaster NCE-Campus在发送数据前校验对端返回的validator是否正确，若与记录的URL关联的validator不匹配，则不会发送Wi-Fi终端位置数据。UUID格式，由iMatser NCE-Campus生成。

流程图

数据接口定义

iMaster NCE-Campus通过POST方法通知第三方位置分析平台，请求体中的终端位置数据采用如下JSON格式：

{     "data": [         {             "apMac": "4C:FA:CA:D8:23:A0",              "terminalList": [                {                     "terminalMac": "88:19:08:F1:88:45",                      "rssi": -68,                      "timestamp": 1557460789000                 },                {                    "terminalMac": "90:2E:1C:6A:2A:57",                     "rssi": -57,                     "timestamp": 1557460789000                 }              ]         }     ],     "secret": "Test@1234",      "type": "ApLocation" }

上述请求示例中的字段说明如下：

配置流程

iMaster NCE-Campus中继上报终端位置数据的配置流程请参考云平台中继位置服务云平台配置。

基于蓝牙的位置服务

目前CloudCampus解决方案支持两种方式进行蓝牙定位：

• 终端侧定位(AP进行Beacon广播)

• 服务器侧定位(AP做定位基站)

更多方案请参考：生态合作

终端侧定位(AP进行Beacon广播)

云AP周期性广播蓝牙Beacon报文，蓝牙终端收到AP广播报文进行定位，并将位置上报至服务器。

华为AP的蓝牙广播报文遵从标准的Beacon协议定义，具体如下：

其中Data部分结构如下：

在需要蓝牙导航的场景，为了提高导航效果，可能需要在AP之间增加蓝牙Beacon基站，使覆盖更加全面。

华为AP提供了可以管理蓝牙Beacon基站的API，增加的Beacon基站若适配API，可实现AP对Beacon基站的管理。

服务器侧定位(AP做定位基站)

AP周期性扫描其他Wi-Fi终端，并以固定间隔向第三方位置服务器上送定位报文。

目前暂不支持iMaster NCE-Campus集中转发蓝牙报文至第三方服务器。

南向接口定义

华为WLAN AP为以下蓝牙模式提供蓝牙Beacon管理、蓝牙Tag定位和蓝牙数据透传3种南向接口：

• 标准Beacon模式：管理提供Beacon管理接口的基站，适用于终端侧定位方案。

• Tag标签模式：基于华为私有接口定义对BLE tag进行定位，适用于资产定位等服务器侧定位场景。

• BLE透传模式：AP仅作通道，不对广播帧内容解析，适用于客户不希望内容被网络设备解析的场景。

标准Beacon模式

此模式下的终端(包括Beacon基站和其他设备)需要满足此接口：

• 对于broadcasting广播帧，遵从标准的Beacon协议定义。

• 对于scan response广播帧，需要携带Beacon设备的电池电量信息；电池电量信息应携带在Service Data的AD Structure中。

  scan response格式定义如下：

需要携带的AD Structure定义如下：

Tag标签模式

空口broadcasting广播帧必须遵从华为私有接口定义格式，支持标签电池电量检测和脱落告警；从省电和传输效率考虑不使用scan response；主要用于BLE资产定位场景。

报文结构定义如下：

BLE透传模式

华为WLAN设备仅为一个传输管道，不对广播帧内容进行解析，适用于客户不希望内容被网络设备解析的场景；主要用于蓝牙数据回传场景。

该模式下华为设备对空口广播帧结构没有任何要求，任何符合BLE协议定义的内容都可以处理。

另外注意以下约束项：

• 为保持接口的简洁性当前只支持透传broadcasting frame中的data部分，不支持透传scan response中的data部分。

• 由于不支持解析广播帧内容所以不支持电量监控、脱落告警，但是支持设备掉线告警。

北向接口定义

AP/AC通过UDP报文主动向服务器上报检测到的BLE标签设备的相关信息，分为两种上报方式：

• 实时上报：空口收到BLE广播帧后立即上报给服务器。

• 周期上报：根据配置的上报周期，对于来自同一个BLE标签设备的广播帧一个周期只上报一次。

实时上报方式

AP/AC每检测到一个BLE标签设备就实时上报UDP报文。UDP报文只包含一个BLE标签设备信息。UDP报文数据部分结构如下：

周期聚合上报方式

AP/AC根据配置的上报周期参数周期性上报检测到所有BLE标签设备的信息，UDP报文数据部分结构如下：

参考

• CloudCampus位置服务文档

• 华为室内定位合作应用

• 智简网络开发者视频教程

• 生态合作成功案例

您可以前往智简网络开发者社区，了解更多相关的信息。