订单轨迹-V2

简介

本接口用于获取最近3个月内完单订单的实际送客轨迹

服务提供方

享道

接口URL

/openapi/order/tracesstd

请求方式

POST

请求频次

单次

请求参数

参数名称	类型	必选	说明
timestamp	long	是	请求时间，Unix Timestamp单位毫秒
order_id	string	是	享道订单id
oid	string	是	合作方订单ID，防止重复发单

响应参数

参数名称	类型	必有	说明
errCode	int	是	服务响应状态，参见附录5
errMsg	string	是	服务响应状态说明，参见附录5
content	object	否
content.distance	int	是	行程距离，单位米
content.duration	int	是	行程时长，单位秒
content.traces	list	是	经纬度信息列表
content.traces[].lat	double	是	纬度
content.traces[].lon	double	是	经度
content.traces[].ts	long	否	打点时间戳，目前为无值/空

请求示例

请求

curl --location --request POST 'https://open-sit.saicmobility.com/merchant/v1/openapi/order/tracesstd' \
--header 'X-Sign: 5e9745dea27fc8b7b4b90aa2565868c0ebf847fd' \
--header 'X-SignAlgorithm: 1' \
--header 'X-Timestamp: 20201020164300' \
--header 'X-MerchantId: open_chechengzhixing' \
--header 'Content-Type: application/json' \
--data-raw '{"timestamp":1603183265876,"order_id":"xxx","oid":"xxx"}'

响应

{
  "errCode": 10000,
  "errMsg": "successful",
  "content": {
    "distance": 100,
    "duration": 600,
    "traces": [
      {
        "lat": 123.12,
        "lon": 11.11,
        "ts": 0
      }
    ]
  }
}