室内外融合定位器开放能力说明

更新时间:2024-06-13 10:32:43下载pdf

本文介绍 室内外融合定位器 开放能力接入的相关说明。

API 说明

室内外融合定位器设备管理:

API 名称 接口地址
设置上报频率 POST:/v1.0/fusion-locator/{device_id}/actions/set/frequency

事件格式

云开发项目 开启消息订阅 后,可以收到设备端上报的事件消息。消息队列接入流程的详细介绍,请参考 消息队列

签到

功能描述

室内外融合定位器上报签到事件给接入方。事件 Code:check_in

value 参数说明

参数名 类型 说明 必填
t Long 签到时间,13 位时间戳

数据示例

{
    "dataId": "AAXRV4BrtW9BRB9A2JYW****",
    "devId": "6ca****",
    "productKey": "e6rz6vba81wm****",
    "status": [
        {
            "5": "{\"t\":1637548630452}",
            "code": "check_in",
            "t": 1637548630455,
            "value": "{\"t\":1637548630452}"
        }
    ]
}

签退

功能描述

室内外融合定位器上报签退事件给接入方。事件 Code:sign_out

value 参数说明

参数名 类型 说明 必填
t Long 签退时间,13 位时间戳

数据示例

{
    "dataId": "AAXRV4BrtW9BRB9A2JYW****",
    "devId": "6ca****",
    "productKey": "e6rz6vba81wm****",
    "status": [
        {
            "6": "{\"t\":1637548630452}",
            "code": "sign_out",
            "t": 1637548630455,
            "value": "{\"t\":1637548630452}"
        }
    ]
}

告警

功能描述

室内外融合定位器上报告警事件给接入方。事件 Code:alarm_info_report

value 参数说明

参数名 类型 说明 必填
t Long 触发时间,13 位时间戳
type Integer 告警类型:
1 表示 SOS 告警
2 表示 低电量
3 表示 关机
4 表示 SOS 取消
info String 告警内容

数据示例

{
    "dataId": "AAXRV4BrtW9BRB9A2JYW****",
    "devId": "6ca****",
    "productKey": "e6rz6vba81wm****",
    "status": [
        {
            "2": "{\"t\":1637548630452,\"type\":1,\"info\":\"SOS\"}",
            "code": "alarm_info_report",
            "t": 1637548630455,
            "value": "{\"t\":1637548630452,\"info\":\"SOS\"}"
        }
    ]
}

电池电量

功能描述

室内外融合定位器上报电池电量事件给接入方。事件 Code:battery_info

value 参数说明

参数名 类型 说明 必填
t Long 触发时间,13 位时间戳
battery Double 电池电量百分比(精度 2)
version String 固件版本号

数据示例

{
    "dataId": "AAXRV4BrtW9BRB9A2JYW****",
    "devId": "6ca****",
    "productKey": "e6rz6vba81wm****",
    "status": [
        {
            "3": "{\"t\":1637548630452,\"battery\":20.00}",
            "code": "battery_info",
            "t": 1637548630455,
            "value": "{\"t\":1637548630452,\"battery\":20.00,\"version\":\"G805.9.1023\"}"
        }
    ]
}

计步数据

功能描述

室内外融合定位器上报计步数据事件给接入方。事件 Code:count_steps

value 参数说明

参数名 类型 说明 必填
t Long 触发时间,13 位时间戳
steps Integer 步数

数据示例

{
    "dataId": "AAXRV4BrtW9BRB9A2JYW****",
    "devId": "6ca****",
    "productKey": "e6rz6vba81wm****",
    "status": [
        {
            "3": "{\"t\":1637548630452,\"steps\":100}",
            "code": "count_steps",
            "t": 1637548630455,
            "value": "{\"t\":1637548630452,\"steps\":100}"
        }
    ]
}

定位数据

室内外融合定位器上报定位事件给接入方。事件 Code:position_event

目前有如下定位类型:

  • 1:GPS 定位
  • 2:Wi-Fi 定位
  • 3:基站 LBS 定位
  • 4:蓝牙信标定位

您可根据 type 字段区分定位数据类型。

  • GPS 定位

    value 参数说明

    参数名 类型 说明 必填
    t Long 触发时间,13 位时间戳
    type Integer GPS 定位,type 取值为 1
    lat Double 经度,精度为 6
    lng Double 纬度,精度为 6

    数据示例

    {
        "dataId": "AAXRV4BrtW9BRB9A2JYW****",
        "devId": "6ca****",
        "productKey": "e6rz6vba81wm****",
        "status": [
            {
                "1": "{\"t\":1637548630452,\"lat\":31.210463,\"lng\":121.606855}",
                "code": "position_event",
                "t": 1637548630455,
                "value": "{\"t\":1637548630452,\"lat\":31.210463,\"lng\":121.606855}"
            }
        ]
    }
    
  • Wi-Fi 定位

    value 参数说明

    参数名 类型 说明 必填
    t Long 触发时间,13 位时间戳
    type Integer Wi-Fi 定位,type 取值为 2
    lat Double 经度,精度为 6
    lng Double 纬度,精度为 6

    数据示例

    {
        "dataId": "AAXRV4BrtW9BRB9A2JYW****",
        "devId": "6ca****",
        "productKey": "e6rz6vba81wm****",
        "status": [
            {
                "1": "{\"t\":1637548630452,\"lat\":31.210463,\"lng\":121.606855}",
                "code": "position_event",
                "t": 1637548630455,
                "value": "{\"t\":1637548630452,\"lat\":31.210463,\"lng\":121.606855}"
            }
        ]
    }
    
  • 基站 LBS 定位

    value 参数说明

    参数名 类型 说明 必填
    t Long 触发时间,13 位时间戳
    type Integer 基站 LBS 定位,type 取值为 3
    bsId String 基站 CID
    db Integer 信号强度(支持正负值)
    lac String 基站位置区码

    数据示例

    {
        "dataId": "AAXRV4BrtW9BRB9A2JYW****",
        "devId": "6ca****",
        "productKey": "e6rz6vba81wm****",
        "status": [
            {
                "1": "{\"t\":1637548630452,\"bsId\":\"1\",\"lac\":\"2\",\"db\":12}",
                "code": "position_event",
                "t": 1637548630455,
                "value": "{\"t\":1637548630452,\"bsId\":\"1\",\"lac\":\"2\",\"db\":12}"
            }
        ]
    }
    
  • 蓝牙信标定位

    value 参数说明

    参数名 类型 说明 必填
    t Long 触发时间,13 位时间戳
    type Integer 蓝牙信标定位,type 取值为 4
    bleId String 蓝牙设备 CID
    bleDeviceId String 蓝牙设备 ID
    db Integer 信号强度(支持正负值)

    数据示例

    {
        "dataId": "AAXRV4BrtW9BRB9A2JYW****",
        "devId": "6ca****",
        "productKey": "e6rz6vba81wm****",
        "status": [
            {
                "1": "{\"t\":1637548630452,\"bleId\":\"1\",\"bleDeviceId\":\"2\",\"db\":12}",
                "code": "position_event",
                "t": 1637548630455,
                "value": "{\"t\":1637548630452,\"bleId\":\"1\",\"bleDeviceId\":\"2\",\"db\":12}"
            }
        ]
    }
    

事件 1.0 格式

室内外融合定位器设备事件消息兼容 1.0 版本格式,如需开通 1.0 版本格式,请 提交工单 联系涂鸦。接入流程请参考 公区设备事件 1.0 格式接入

签到

功能描述

触发室内外融合定位器签到,室内外融合定位器会上报签到事件给接入方。

参数说明

参数名 类型 说明 必填
bizCode String 事件业务 code,取值固定为 edge_device
eventType String 事件类型,取值固定为 edge_report_data
mode String 事件 mode,取值固定为 sign_in
deviceId String 涂鸦设备 ID
t Long 签到时间,13 位时间戳

数据示例

{
    "data": "{\"mode\":\"sign_in\",\"data\":\"{\\\"deviceId\\\":\\\"6ca****\\\",\\\"t\\\":1612514362591}}",
    "bizCode": "edge_device",
    "eventType": "edge_report_data"
}

签退

功能描述

触发室内外融合定位器签退,室内外融合定位器会上报签退事件给接入方。

参数说明

参数名 类型 说明 必填
bizCode String 事件业务 code,取值固定为 edge_device
eventType String 事件类型,取值固定为 edge_report_data
mode String 事件 mode,取值固定为 sign_out
deviceId String 涂鸦设备 ID
t Long 签退时间,13 位时间戳

数据示例

{
    "data": "{\"mode\":\"sign_out\",\"data\":\"{\\\"deviceId\\\":\\\"6ca****\\\",\\\"t\\\":1612514362591}}",
    "bizCode": "edge_device",
    "eventType": "edge_report_data"
}

告警

功能描述

室内外融合定位器上报告警事件给接入方。

参数说明

参数名 类型 说明 必填
bizCode String 事件业务 code,取值固定为 edge_device
eventType String 事件类型,取值固定为 edge_report_data
mode String 事件 mode,取值固定为 alarm_info_report
deviceId String 涂鸦设备 ID
t Long 触发时间,13 位时间戳
type Integer 告警类型,1 表示 SOS 告警
info String 告警内容

数据示例

{
    "data": "{\"mode\":\"alarm_info_report\",\"data\":\"{\\\"deviceId\\\":\\\"6ca****\\\",\\\"t\\\":1612514362591,\\\"type\\\":1,\\\"info\\\":\\\"SOS\\\" }}",
    "bizCode": "edge_device",
    "eventType": "edge_report_data"
}

电池电量

功能描述

室内外融合定位器上报电池电量事件给接入方。

参数说明

参数名 类型 说明 必填
bizCode String 事件业务 code,取值固定为 edge_device
eventType String 事件类型,取值固定为 edge_report_data
mode String 事件 mode,取值固定为 battery_info
deviceId String 涂鸦设备 ID
t Long 触发时间,13 位时间戳
battery Double 电池电量百分比(精度 2)

数据示例

{
    "data": "{\"mode\":\"battery_info\",\"data\":\"{\\\"deviceId\\\":\\\"6ca****\\\",\\\"t\\\":1612514362591,\\\"battery\\\":20.00}}",
    "bizCode": "edge_device",
    "eventType": "edge_report_data"
}

计步数据

功能描述

室内外融合定位器上报计步数据事件给接入方。

参数说明

参数名 类型 说明 必填
bizCode String 事件业务 code,取值固定为 edge_device
eventType String 事件类型,取值固定为 edge_report_data
mode String 事件 mode,取值固定为 step
deviceId String 涂鸦设备 ID
t Long 触发时间,13 位时间戳
steps Integer 步数

数据示例

{
    "data": "{\"mode\":\"step\",\"data\":\"{\\\"deviceId\\\":\\\"6ca****\\\",\\\"t\\\":1612514362591,\\\"steps\\\":100}}",
    "bizCode": "edge_device",
    "eventType": "edge_report_data"
}

定位数据

室内外融合定位器上报定位数据事件给接入方。目前有如下定位类型:

  • 1:GPS 定位
  • 2:Wi-Fi 定位
  • 3:基站 LBS 定位
  • 4:蓝牙信标定位

您可根据 type 字段区分定位数据类型。

  • GPS 定位

    参数说明

    参数名 类型 说明 必填
    bizCode String 事件业务 code,取值固定为 edge_device
    eventType String 事件类型,取值固定为 edge_report_data
    mode String 事件 mode,取值固定为 position_event
    deviceId String 涂鸦设备 ID
    t Long 触发时间,13 位时间戳
    type Integer GPS 定位,type 取值为 1
    lat Double 经度,精度为 6
    lng Double 纬度,精度为 6

    数据示例

    {
        "data": "{\"mode\":\"position_event\",\"data\":\"{\\\"deviceId\\\":\\\"6ca****\\\",\\\"t\\\":1612514362591,\\\"type\\\":1,\\\"lat\\\":31.210463,\\\"lng\\\":121.606855}}",
        "bizCode": "edge_device",
        "eventType": "edge_report_data"
    }
    
  • Wi-Fi 定位

    参数说明

    参数名 类型 说明 必填
    bizCode String 事件业务 code,取值固定为 edge_device
    eventType String 事件类型,取值固定为 edge_report_data
    mode String 事件 mode,取值固定为 position_event
    deviceId String 涂鸦设备 ID
    t Long 触发时间,13 位时间戳
    type Integer Wi-Fi 定位,type 取值为 2
    lat Double 经度,精度为 6
    lng Double 纬度,精度为 6

    数据示例

    {
        "data": "{\"mode\":\"position_event\",\"data\":\"{\\\"deviceId\\\":\\\"6ca****\\\",\\\"t\\\":1612514362591,\\\"type\\\":2,\\\"lat\\\":31.210463,\\\"lng\\\":121.606855}}",
        "bizCode": "edge_device",
        "eventType": "edge_report_data"
    }
    
  • 基站 LBS 定位

    参数说明

    参数名 类型 说明 必填
    bizCode String 事件业务 code,取值固定为 edge_device
    eventType String 事件类型,取值固定为 edge_report_data
    mode String 事件 mode,取值固定为 position_event
    deviceId String 涂鸦设备 ID
    t Long 触发时间,13 位时间戳
    type Integer 基站 LBS 定位,type 取值为 3
    bsId String 基站 CID
    db Integer 信号强度(支持正负值)
    lac String 基站位置区码

    数据示例

    {
        "data": "{\"mode\":\"position_event\",\"data\":\"{\\\"deviceId\\\":\\\"6ca****\\\",\\\"t\\\":1612514362591,\\\"type\\\":3,\\\"bsId\\\":\\\"1\\\",\\\"lac\\\":\\\"2\\\",\\\"db\\\":12}}",
        "bizCode": "edge_device",
        "eventType": "edge_report_data"
    }
    
  • 蓝牙信标定位

    参数说明

    参数名 类型 说明 必填
    bizCode String 事件业务 code,取值固定为 edge_device
    eventType String 事件类型,取值固定为 edge_report_data
    mode String 事件 mode,取值固定为 position_event
    deviceId String 涂鸦设备 ID
    t Long 触发时间,13 位时间戳
    type Integer 蓝牙信标定位,type 取值为 4
    bleId String 蓝牙设备 CID
    bleDeviceId String 涂鸦蓝牙设备 ID
    db Integer 信号强度(支持正负值)

    数据示例

    {
        "data": "{\"mode\":\"position_event\",\"data\":\"{\\\"deviceId\\\":\\\"6ca****\\\",\\\"t\\\":1612514362591,\\\"type\\\":4,\\\"bleId\\\":\\\"1\\\",\\\"bleDeviceId\\\":\\\"6ca****\\\",\\\"db\\\":12}}",
        "bizCode": "edge_device",
        "eventType": "edge_report_data"
    }