1 概述

提供融合定位等接口。协议默认规格有：

1、 时间戳为 int64，采用 unix 时间戳（Unix epoch），单位为毫秒；

2、 字符串都为 UTF8 格式；

3、 HTTP Headers：Content-Type 设置为：application/json

鉴权方式：

采用 access_key 的方式，在 URL 的 Query Param 中添加 access_key。

2 融合定位接口

2.1 请求参数

定位结果的获取，通过POST 请求下面的 URL :

https://api.newayz.com/location/hub/v1/track_points?access_key={YOUR_ACCESS_KEY}&response_sprf=wgs84

查询 params 参数含义：

调用 WAYZ 的 API，需要提前获取 KEY 信息。请求参数如下：

Asset 设备信息参数如下：

OS 参数如下：

Location 字段如下：

Gnss参数如下：

Cellular参数如下：

WIFI 参数如下：

当请求体中有且仅有 WiFi 信息列表时，提供至少4 个 WiFi 信息，才能获得定位结果。如果要更准确且稳定的服务，请至少提供10 个 WiFi 信息，以确保定位的成功率和准确性。

整体请求示例如下：

{
    "timestamp": 1515743846505,
    "id": "xxxxxxxxxxxxxxxxxxxxxxxxxx",
    "asset": {
        "id": "390928a0-06d4-11e9-a952-024cxxxxxxxx",
        "manufacturer": "xiaomi",
        "model": "Note",
        "imeiMd5": "234567890",
        "macAddress": "1a:2b:3c:4d:5e:6f",
        "serialNumber": "xxxxxxxx",
        "uniqueId": "xxxxxxxx",
        "os": {
            "type": "Android",
            "version": "MI UI 9.6"
        }
    },
    "location": {
        "timestamp": 1515743846504,
        "gnss": {
            "timestamp": 1515743846504,
            "point": {
                "longitude": 116.248634,
                "latitude": 36.334663,
                "altitude": 34.54
            },
            "accuracy": 25,
            "velocity": 3.2,
            "heading": 0
        },
        "cellulars": [
            {
                "timestamp": 1515743846504,
                "cellId": 12338443,
                "connected": true,
                "signalStrength": 97,
                "radioType": "lte",
                "mobileCountryCode": 460,
                "mobileNetworkCode": 1,
                "locationAreaCode": 6380
            },
            {
                "timestamp": 1515743846504,
                "cellId": 12338443,
                "signalStrength": 97,
                "radioType": "lte",
                "mobileCountryCode": 460,
                "mobileNetworkCode": 1,
                "locationAreaCode": 6380
            }
        ],
        "wifis": [
            {
                "signalStrength": 43,
                "macAddress": "88:25:93:6f:df:bb",
                "connected": true
            },
            {
                "signalStrength": 43,
                "macAddress": "94:77:2b:65:1a:00"
            },
            {
                "signalStrength": 57,
                "macAddress": "88:25:93:6f:df:ba"
            },
            {
                "signalStrength": 60,
                "macAddress": "94:77:2b:65:1a:04"
            },
            {
                "signalStrength": 60,
                "macAddress": "d4:68:ba:03:34:b8"
            },
            {
                "signalStrength": 70,
                "macAddress": "a8:0c:ca:81:76:86"
            },
            {
                "signalStrength": 70,
                "macAddress": "a8:0c:ca:89:76:86"
            },
            {
                "signalStrength": 71,
                "macAddress": "a8:0c:ca:99:76:86"
            },
            {
                "signalStrength": 71,
                "macAddress": "a8:0c:ca:91:76:86"
            },
            {
                "signalStrength": 71,
                "macAddress": "a8:0c:ca:91:76:86"
            }
        ]
    }
}

2.2 返回参数

返回参数如下：

Location 字段如下：

Address 字段如下：

Context 字段如下：

Place 字段如下：

| 参数 | 类型 | 说明 | | --- | --- | --- | --- | | name | string | 对应的 POI 名称 | | type | string | 当前场景的属性信息，例如："Entity" 等 | | distance | Distance | 距离对象 |

Distance 字段如下：

Position 字段如下：

Point 字段如下：

完整返回信息参数如下:

{
    "id": "xxxxxxxxxxxxxxxxxxxxxxxxxx",
    "asset": "390928a0-06d4-11e9-a952-024cxxxxxxxx",
    "location": {
        "timestamp": 1515743846504,
        "address": {
            "name": "上海市上海市浦东新区张江镇祥科路58 号",
            "context": [
                {
                    "type": "Country",
                    "name": "中国",
                    "code": "CN"
                },
                {
                    "type": "Province",
                    "name": "上海市",
                    "code": "310000"
                },
                {
                    "type": "City",
                    "name": "上海市",
                    "code": "310000"
                },
                {
                    "type": "District",
                    "name": "浦东新区",
                    "code": "310115"
                },
                {
                    "type": "Township",
                    "name": "张江镇",
                    "code": "310115125"
                }
            ]
        },
        "place": {
            "type": "Entity",
            "name": "民防工程(炬芯研发大楼项目地下车库民防工程)",
            "distance": {
                "line": 3.7579
            }
        },
        "position": {
            "timestamp": 1730790836549,
            "source": "wifi",
            "point": {
                "longitude": 121.604634,
                "latitude": 31.179703
            },
            "spatialReference": "gcj02",
            "accuracy": 30
        }
    }
}

2.3 报错信息

400 报错信息：

{
    "code": "400",
    "message": "no refdata provided"
}

401 报错信息：

{
    "code": "401",
    "message": "No API key found in request"
}

403 报错信息：

{

    "code": "403",
    "message": "Access key forbidden"
}

404 报错信息：

{
    "code": "404",
    "message": "scenario not found"
}

429 报错信息：

{
    "code": "429",
    "message": "API rate limit exceeded"
}

3 Address Model 级别说明