智能小程序 Ray 开发——出行 API 接口汇总(一)

位置服务

该接口为云能力,需开通授权后使用,关于云能力可查看文档

接口能力

对位置服务的能力我们提供了下接口能力,开发者可直接调用 API 完成计量相关业务开发。

注意,以下 API 需要在 @ray-js/ray^1.4.13 使用。

接口名描述
getOutdoorsTracksDetail获取设备轨迹点
getOutdoorsTracksLocation批量查询设备实时位置
getOutdoorsTracksSegments获取设备轨迹分段
reportOutdoorsLocation设备位置上报 @ray-js/ray^1.4.39

👉 立即免费领取开发资源,体验涂鸦 MiniApp 小程序开发。 

getOutdoorsTracksDetail

该接口为云能力,需开通授权后使用,关于云能力可查看文档

根据时间段获取设备轨迹点。结束时间与起始时间差小于等于 7 天,单次最多返回 1000 个轨迹点。如果时间段内的轨迹点数量大于 1000 则返回前 1000 个轨迹点以及下次查询的开始时间。为提升响应速度,同时避免轨迹点过多造成请求超时,建议缩短每次请求的时间区间,将轨迹拆分成多段进行拼接。

请求参数

参数数据类型说明是否必填
deviceIdstring设备 ID
startTimenumber开始时间 13 位时间戳
endTimenumber结束时间 13 位时间戳
coordTypestring经纬度定位坐标系类型: WGS84 - 谷歌坐标系 , GCJ02 - 高德 , BD09LL - 百度 , 不传 国内默认高德,国外默认谷歌
needRatedboolean倍率转换

返回参数

参数数据类型说明
deviceIdstring设备 ID
pointListPoint[]轨迹点集合,按时间升序排列
startTimenumber下一页查询时的开始时间戳
hasMoreboolean是否有下一页;若此次轨迹点集合总数小于1000,则为最后一页,值为false,否则值为 true。

Point 说明

参数数据类型说明
lonnumber经度
latnumber纬度
speednumber速度,单位:千米/小时, 已完成倍率转换
protocolstring定位类型,支持 GPS、 WIFI 和 LBS
reportTimenumber定位上报时间 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 批量查询设备实时位置。

请求参数

参数数据类型说明是否必填
deviceIdsstring设备 ID 集合,以逗号分开,最多 50 个
coordTypestring经纬度定位坐标系类型: WGS84 - 谷歌坐标系 , GCJ02 - 高德 , BD09LL - 百度 , 不传 国内默认高德,国外默认谷歌

返回参数

参数数据类型说明
deviceLocationListDeviceLocationItem[]要查询的数据点 ID

DeviceLocationItem 说明

参数数据类型说明
deviceIdstring设备 ID
lonnumber经度
latnumber纬度
speednumber速度,单位:千米/小时,已完成倍率转换
protocolnumber定位类型,支持 GPS、WIFI 、 LBS
reportTimenumber定位上报时间 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 小程序开发。 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

IoT砖家涂拉拉

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值