查询附近司机
接口说明: 用于查询用户当前位置附近司机,包括当前位置附近的全部车型。
接口提供方: 合作方
请求地址: https://{$domain}/partner/queryNearByDriver
服务协议: HTTPS/GET
请求参数:
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
channel | string | 是 | 分配的合作方的标识,每个合作方一个,对应分配给合作方的client_id |
timestamp | long | 是 | 请求时间,UnixTimestamp单位毫秒 |
sign | string | 是 | 签名 |
longitude | double | 是 | 下单地longitude |
latitude | double | 是 | 下单地latitude |
distance | int | 是 | 查询半径单位m |
count | int | 是 | 返回最大司机数 |
partnerCarTypeIds | string | 否 | 车型,多个车型用","分割,举例:1,2,3 |
响应data参数:
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
result | int | 是 | 0:成功,非0:失败 |
message | string | 是 | 成功:SUCCESS,失败:具体原因 |
data | list | 是 | 返回附近小车信息,是个列表 |
data[].partnerCarTypeId | int | 是 | 合作方运力类型ID:美团快车,美团出租车,首汽出租车,首汽专车等,(新合作方接入,待美团分配) |
data[].longitude | double | 是 | longitude |
data[].latitude | double | 是 | latitude |
data[].direction | double | 是 | 车头方向[0,360),0表示正北,数组顺时针 |
data[].timestamp | long | 否 | 司机位置时间戳单位ms |
data[].distance | int | 否 | 接驾导航距离单位m |
data[].duration | int | 否 | 接驾时长单位ms |
data[].partnerDriverId | string | 否 | 合作方司机ID |
返回结果示例
{
"result": 0,
"message": "SUCCESS",
"data": [
{
"longitude": 111.14343,
"latitude": 40.43221,
"direction": 130.5983,
"partnerCarTypeId": 1,
"duration": 10000,
"timestamp":1557207812000,
"distance":2000,
"partnerDriverId":"123456"
}
]
}