查询附近空车接口

更新时间：2022-10-17 打车可选接入，接送机站无需接入。在线调试（沙箱环境）

接口概述

1、该接口用来查询指定点位附近的空驶车辆。
2、性能要求：供应商需要在2000ms内响应结果。

请求地址

地址格式: {Domain}/RTN/nearbydrivers/2.0/{timeStamp}/{sign}

请求内容

NearbyDriversRequest

参数	类型	必传	描述	示例	备注
cityId	Long	是	携程城市ID		城市ID列表
longitude	BigDecimal	是	经度
latitude	BigDecimal	是	纬度
radius	Integer	是	半径（米）
maxNum	Integer	是	最大返回司机数量
serviceProviderId	Long	否	服务商ID	1000000	用于多服务商接入场景，需要的供应商请联系我方技术添加

返回内容

NearbyDriversResponse

参数	类型	必传	描述	示例	备注
msgCode	String	是	响应码	OK	响应码
message	String	否	响应详情	成功	响应码
driverList	List<DriverLocationDTO>	是	司机位置列表

DriverLocationDTO

参数	类型	必传	描述	示例	备注
longitude	BigDecimal	是	经度	119.192474	精确到小数点后6位，不足6位补0
latitude	BigDecimal	是	纬度	26.051053	精确到小数点后6位，不足6位补0
coordinate	String	是	坐标系类型	GCJ02	GCJ02; WGS84
locationTime	String	是	获取到司机位置的时间		yyyy-MM-dd HH:mm:ss
speed	BigDecimal	是	司机速度		单位：km/h，如果无法提供则传255
direction	BigDecimal	是	司机当前车头朝向		正北方向为0度，如果无法提供则传511
locationType	Integer	否	定位方式	1	1:基站定位;2:缓存定位;3:GPS定位;4:Wifi定位
height	BigDecimal	否	高度		单位：米小数点后2位精度
accuracy	BigDecimal	否	定位精度		单位：米小数点后2位精度

请求示例

{
    "cityId":1,
    "longitude":121.506384,
    "latitude":31.237987,
    "radius":5000,
    "maxNum":5
}

响应示例

{
  "msgCode": "OK",
  "message": "SUCCESS",
  "driverList": [
    {
      "longitude": 121.506384,
      "latitude": 31.237987,
      "coordinate": "WGS84",
      "locationTime": "2022-07-25 09:20:23",
      "speed": 255,
      "direction": 511
    }
  ]
}

异常示例

{
  "msgCode": "Error",
  "message": "",
}

results matching ""

No results matching ""