位置服务
该接口为云能力,需开通授权后使用,关于云能力可查看文档
接口能力
对位置服务的能力我们提供了下接口能力,开发者可直接调用 API
完成计量相关业务开发。
注意,以下 API 需要在 @ray-js/ray^1.4.13
使用。
接口名 | 描述 |
---|---|
getOutdoorsTracksDetail | 获取设备轨迹点 |
getOutdoorsTracksLocation | 批量查询设备实时位置 |
getOutdoorsTracksSegments | 获取设备轨迹分段 |
reportOutdoorsLocation | 设备位置上报 @ray-js/ray^1.4.39 |
👉 立即免费领取开发资源,体验涂鸦 MiniApp 小程序开发。
getOutdoorsTracksDetail
该接口为云能力,需开通授权后使用,关于云能力可查看文档
根据时间段获取设备轨迹点。结束时间与起始时间差小于等于 7 天,单次最多返回 1000 个轨迹点。如果时间段内的轨迹点数量大于 1000 则返回前 1000 个轨迹点以及下次查询的开始时间。为提升响应速度,同时避免轨迹点过多造成请求超时,建议缩短每次请求的时间区间,将轨迹拆分成多段进行拼接。
请求参数
参数 | 数据类型 | 说明 | 是否必填 |
---|---|---|---|
deviceId | string | 设备 ID | 是 |
startTime | number | 开始时间 13 位时间戳 | 是 |
endTime | number | 结束时间 13 位时间戳 | 是 |
coordType | string | 经纬度定位坐标系类型: WGS84 - 谷歌坐标系 , GCJ02 - 高德 , BD09LL - 百度 , 不传 国内默认高德,国外默认谷歌 | 否 |
needRated | boolean | 倍率转换 | 否 |
返回参数
参数 | 数据类型 | 说明 |
---|---|---|
deviceId | string | 设备 ID |
pointList | Point[] | 轨迹点集合,按时间升序排列 |
startTime | number | 下一页查询时的开始时间戳 |
hasMore | boolean | 是否有下一页;若此次轨迹点集合总数小于1000,则为最后一页,值为false,否则值为 true。 |
Point 说明
参数 | 数据类型 | 说明 |
---|---|---|
lon | number | 经度 |
lat | number | 纬度 |
speed | number | 速度,单位:千米/小时, 已完成倍率转换 |
protocol | string | 定位类型,支持 GPS、 WIFI 和 LBS |
reportTime | number | 定位上报时间 13 位毫秒时间戳 |
请求示例
// @ray-js/ray^1.4.13
import { getOutdoorsTracksDetail } from "@ray-js/ray";
getOutdoorsTracksDetail({
deviceId: "vdevo16245017293",
startTime: 1625198100154,
endTime: 1625198190154
})
.then((response) => {
console.log(response);
})
.catch();
返回示例
{
"deviceId": "vdevo16245017293****",
"hasMore": false,
"pointList": [
{
"lon": 114.003117,
"battery": 100,
"speed": 100,
"protocol": "GPS",
"lat": 22.594031,
"mileage": 0,
"timestamp": 1625198100154
}
]
}
getOutdoorsTracksLocation
该接口为云能力,需开通授权后使用,关于云能力可查看文档
根据设备 ID 批量查询设备实时位置。
请求参数
参数 | 数据类型 | 说明 | 是否必填 |
---|---|---|---|
deviceIds | string | 设备 ID 集合,以逗号分开,最多 50 个 | 是 |
coordType | string | 经纬度定位坐标系类型: WGS84 - 谷歌坐标系 , GCJ02 - 高德 , BD09LL - 百度 , 不传 国内默认高德,国外默认谷歌 | 否 |
返回参数
参数 | 数据类型 | 说明 |
---|---|---|
deviceLocationList | DeviceLocationItem[] | 要查询的数据点 ID |
DeviceLocationItem 说明
参数 | 数据类型 | 说明 |
---|---|---|
deviceId | string | 设备 ID |
lon | number | 经度 |
lat | number | 纬度 |
speed | number | 速度,单位:千米/小时,已完成倍率转换 |
protocol | number | 定位类型,支持 GPS、WIFI 、 LBS |
reportTime | number | 定位上报时间 13 位毫秒时间戳 |
请求示例
// @ray-js/ray^1.4.13
import { getOutdoorsTracksLocation } from "@ray-js/ray";
getOutdoorsTracksLocation({
deviceIds: ["vdevo16245017293"],
})
.then((response) => {
console.log(response);
})
.catch();
返回示例
{
"deviceLocationList": [
{
"deviceId": "vdevo16245017293****",
"lon": 114.003117,
"speed": 100,
"protocol": "GPS",
"lat": 22.594031,
"timestamp": 1625198100154
}
]
}
👉 立即免费领取开发资源,体验涂鸦 MiniApp 小程序开发。