车辆信息同步最后更新时间: 2021年01月22日

概述

车辆信息同步是批量车辆计算, 轨迹服务, 司乘同显轨迹, 附近运力等服务基础服务, 本服务通过同步包括车辆状态,车辆位置, 车辆类型等相关车辆信息的基础上, 为上层应用服务提供车辆数据基础.

使用限制

需创建Webservice类型的Appkey, 并且申请开通车辆信息同步权限, 实时同步车辆定位信息, 为了保证效果, 推荐3s同步一个定位点.

适配平台

Webservice

基础功能

接口URL

车辆位置同步 https://tsapi.testing.amap.com/v1/data/vehicle?key=#'

功能:实时同步车辆位置及状态

此功能为车辆信息同步的基础功能, 参照参考手册进行接入车辆位置同步

请求示例:

XML

curl 
-X POST 'https://tsapi.testing.amap.com/v1/data/vehicle?key=#'
-H 'Content-Type: application/json' 
-d '{
  "msgID": "68753A44-4D6F-1226-9C60-0050E4C00067",
  "type": "vehicles",
  "key": "2di95fe01a20ede3018a1c77d4a71078",
  "time": 1480070422321,
  "data": {
    "vehicles": [
      {
        "vehicleID": "BJ-A99999",
        "vehicleType": 1,
        "state": 1,
        "locationtype": 1,
        "location": "116.473195,39.993253",
        "accuracy": 60.001,
        "direction": 360.000,
        "speed": 20.003,
        "height": 1000.342,
        "deviceTime": 1480070222233,
        "timestamp": 1480070222233,
        "carryMode": 1,
        "orderID": "test001"
        "destination": "116.397432,39.908599",
        "seats": 5,
      }
    ]
  }
}'

注意事项:

key在开通权限时，会绑定SID，用于轨迹查询，通过该Key上传的数据，会存在绑定的SID下
每个轨迹点之间的间隔推荐3秒上传, 推荐区间在2秒至5秒之间，实现实时单点上传
相关字段标识
- vehicleID需要唯一
- orderID需要唯一，当上传orderID时，该段轨迹会被标记为该订单的轨迹，如果同一时刻存在多个订单并行（如拼车），则在vehicles数组中放入两个仅订单ID不同的对象即可
- accuracy缺失情况下，传固定值"550"
- direction缺失情况下，传固定值"511"
- speed缺失情况下，传固定值"255"
- height缺失情况下，传固定值"0"
- accuracy、direction、speed、height资源缺失可能会导致纠偏结果不理想，请尽量保证这些值正确同步
- deviceTime为设备定位时刻的设备本地时间
- timestamp为通过服务端上传轨迹点时的服务端时间，查询车辆轨迹时，时间参数以此参数为准，同一个车辆在同一个timestamp只能存在一个轨迹点
关于车辆状态
- 车辆状态用于轨迹服务, 车辆筛选, 严格按照要求进行填入状态, 车辆状态会影响「附近运力展示」、「批量接驾计算」使用
关于车辆类型
- 车辆类型根据车辆类型进行枚举,取值范围[1,200], 该值影响「附近运力展示」、「批量接驾计算」、「轨迹查询」使用

车辆信息同步 最后更新时间: 2021年01月22日

概述