下单前–返回附近司机
说明
本接口提供查询附近司机功能，查询传入开始经纬度一定范围（传入参数，默认5公里）内的附近司机数量（传入参数，默认20个）、预计时长（直线距离）、预估距离（直线距离）、方位角等信息。
地址URL
https://<SQYC_DOMAIN>/v1/common/aroundCars
HTTP请求方式
POST
访问授权限制
暂无
请求参数
| 名称 | 选项 | 类型及范围 | 说明及示例 |
|---|---|---|---|
| sign | 必选 | string | 参见sign生成算法 |
| lng | 必选 | string | 开始经度（默认：mars） |
| lat | 必选 | string | 开始纬度（默认：mars） |
| userId | 可选 | string | 用户ID，便于排查问题 |
| channel | 必选 | string | 渠道名称，由首汽约车给定。 |
| riderUserPhone | 可选 | string | 用户手机号，便于排查问题 |
| range | 必选 | string | 范围（单位：米，默认5000米） |
| carCount | 必选 | string | 返回的司机数量（默认20） |
| coordType | 必选 | string | 客户端地图类型，mars（高德），baidu（百度），默认mars（高德） |
| imei | 必选 | string | 用户imei，便于排查问题。 |
返回数据
| 名称 | 选项 | 类型 | 说明 |
|---|---|---|---|
| result | 必选 | string | 0:成功非0 :失败原因编号 |
| errmsg | 必选 | string | 失败原因描述，若成功则值为success ! |
| data | 必选 | List<AroundCarsDTO> | AroundCarsDTO实体类: 周边车辆信息列表（直线距离排序，详见AroundCarsDTO节点） |
返回示例
{
"result": 0,
"errmsg": "success !",
"data": [
{
"distance": 4256,
"duration": 383,
"latitude": 39.945889,
"longitude": 116.461921,
"bearingAngle": "213.0"
}
]
}
注意事项
暂无