智能小程序 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 个轨迹点以及下次查询的开始时间。为提升响应速度，同时避免轨迹点过多造成请求超时，建议缩短每次请求的时间区间，将轨迹拆分成多段进行拼接。

请求参数

参数	数据类型	说明	是否必填
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 小程序开发。