淘宝开放平台

登录
文档中心 > API类目 > 飞猪-综合交通api

飞猪-综合交通api

qimen.alitrip.transfer.item.neardriver.get (查询附近司机)

查询用户附近的司机

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cityId String 可选 113 城市id
radius Number 可选 3000 查询半径(单位：米)
currentLongitude String 可选 100.2322 用户当前经度
currentLatitude String 可选 20.2321 用户当前纬度
traceId String 可选 1111 建议必填，本次请求的标识，用于异常记录、追踪。由上层调用方填充，如果上层调用方不填充则默认使用eagleTraceId
channelId String 可选 20001 服务商渠道id,运营配置后提供

响应参数

名称 类型 示例值 描述
count Number 5 附近司机数量
radius String 5000 实际查询半径(单位：米)
details DriverLocation [] 司机位置信息
  • └ latitude
  • String
  • 20.2921
  • 司机位置纬度
  • └ longitude
  • String
  • 100.0322
  • 司机位置经度
success Boolean true 接口调用是否成功
errorInfo ErrorInfo 错误信息
  • └ message
  • String
  • 请求成功
  • 自定义错误信息。记录各链路错误详细描述，以“|”分隔，如：商家接口出现系统异常/业务错误（uac）|商家具体错误描述。
  • └ code
  • String
  • 0
  • 错误码

请求示例

{"traceId":"1111","currentLongitude":"100.2322","currentLatitude":"20.2321","cityId":"113","radius":3000,"channelId":"20001"}

响应示例

{
    "count":5,
    "radius":"5000",
    "details":[
        {
                "latitude":"20.2921",
                "longitude":"100.0322"
        }
    ],
    "success":true,
    "errorInfo":{
        "message":"请求成功",
        "code":"0"
    }
}

验签示例

{"success":"false","errorInfo":{"code":"sign-check-failure","message":"Illegal request"}}

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部