0. 变更记录
|
变更时间 |
变更内容 |
|---|---|
|
2024-08-30 |
支持出租车,入参product_category增加枚举值 |
1. 接口说明
- 预估价格只是参考价格,最终支付费用,以实际产生费用为准
- 预估价信息在2分钟内不会变化,超过2分钟请重新预估,否则下单会失败
- 使用出租车前,请先联系对接的商务同学开通滴滴出租车账户
2. 请求信息
请求地址:https://api.es.xiaojukeji.com/v2/common/estimatePrice
请求方式:GET
Content-Type:application/x-www-form-urlencoded
3. 请求参数
|
字段名称 |
字段类型 |
是否必填 |
字段说明 |
|---|---|---|---|
|
公共参数 |
|
|
|
|
client_id |
string |
是 |
申请应用时分配的client_id |
|
access_token |
string |
是 |
授权接口返回的token,获取access_token方式参照文档 授权认证 |
|
timestamp |
int32 |
是 |
调用接口时间对应的时间戳,精确到秒级,示例:1697009534 |
|
sign |
string |
是 |
签名(注:本接口的传参都要参与签名)签名算法 |
|
业务参数 |
|
|
|
|
flat |
float |
是 |
出发地纬度,保留小数点后6位,示例:30.195335 |
|
flng |
float |
是 |
出发地经度,保留小数点后6位,示例:115.031116 |
|
city |
int32 |
是 |
出发城市id |
|
start_name |
string |
是 |
出发地名称(最多100个字符) |
|
start_address |
string |
否 |
出发地详细地址(最多200个字符) |
|
tlat |
float |
是 |
目的地纬度,保留小数点后6位,示例:30.211427 |
|
tlng |
float |
是 |
目的地经度,保留小数点后6位,示例:115.008032 |
|
to_city |
int32 |
是 |
目的地城市id |
|
end_name |
string |
是 |
目的地名称(最多100个字符) |
|
end_address |
string |
否 |
目的地详细地址(最多200个字符) |
|
type |
int32 |
是 |
订单类型 |
|
departure_time |
string |
否 |
预计出发时间,预约单必须传,示例:2015-06-16 12:00:09 |
|
passenger_phone |
string |
是 |
乘客手机号 |
|
exposure_product_category |
string |
是 |
多车型用逗号分割(默认全部车型) |
|
carpool_seat_num |
int32 |
否 |
拼车座位数,只能为0,1,2,有拼车时默认为1,没有拼车时默认为0 |
4. 请求示例
curl --location 'https://api.es.xiaojukeji.com/v2/common/estimatePrice?access_token=a03b66ce81d6832125cf870069176ee0e36757ba&sign=816a9c45a4ac5b67b1afabd7a31bd53c&client_id=diditest×tamp=1697020530&flat=30.195335&flng=115.031116&city=1&start_name=%E8%9E%8D%E6%B3%BD%E5%98%89%E5%9B%AD2%E5%8F%B7%E9%99%A2%E8%A5%BF%E9%97%A8&start_address=%E5%8C%97%E4%BA%AC%E5%B8%82%E6%98%8C%E5%B9%B3%E5%8C%BA%E9%BE%99%E5%9F%9F%E4%B8%AD%E8%B7%AF%E8%9E%8D%E6%B3%BD%E5%98%89%E5%9B%AD2%E5%8F%B7%E9%99%A2%E8%A5%BF%E9%97%A8&tlat=30.211427&tlng=115.008032&to_city=1&end_name=%E9%92%BB%E7%9F%B3%E5%A4%A7%E5%8E%A6&end_address=%E8%BD%AF%E4%BB%B6%E5%9B%AD%E9%92%BB%E7%9F%B3%E5%A4%A7%E5%8E%A6&type=0&passenger_phone=11000009099&exposure_product_category=5000%2C5001%2C5002%2C5003%2C5024&carpool_seat_num=1'
5. 返回值结构
|
字段名称 |
字段类型 |
是否必需 |
字段说明 |
|---|---|---|---|
|
errno |
int32 |
是 |
错误码 |
|
errmsg |
string |
是 |
错误文案 |
|
request_id |
string |
是 |
请求唯一标识(请务必保存,排查问题需要使用) |
|
data |
|
否 |
预估价信息 |
EstimatePrice结构
|
字段名称 |
字段类型 |
是否必需 |
字段说明 |
|---|---|---|---|
|
dynamic_md5 |
string |
是 |
预估ID,发单接口需要 |
|
estimate_data |
|
是 |
预估价数据明细 |
EstimateDetail结构
|
字段名称 |
字段类型 |
是否必需 |
字段说明 |
|---|---|---|---|
|
name |
string |
是 |
车型名称 |
|
product_category |
int32 |
是 |
车型唯一code |
|
require_level |
int32 |
是 |
用车类型 |
|
rule |
int32 |
是 |
计价类型 |
|
level_type |
int32 |
是 |
品类标识 |
|
combo_type |
int32 |
是 |
计价方式 |
|
price |
int32 |
是 |
预估价格,单位:分 |
|
distance |
int32 |
是 |
预估行驶距离,单位:米 |
|
minute |
int32 |
是 |
预估行驶时间,单位:分钟 |
|
is_fixed_price |
int32 |
是 |
是否为一口价 |
6. 返回值示例
{
"errno":0,
"errmsg":"SUCCESS",
"request_id":"i+2SqRl3Acm4/lJ6B2NUGDlsjGq4UsykJUr7hWr2AVeb3WWtLNve9gzPNRR8Nj4B"
"data":{
"dynamic_md5":"1c94d686828bb8cdd22207f51f515741",
"estimate_data":[
{
"name":"拼车",
"product_category":5003,
"require_level":600,
"rule":301,
"level_type":0,
"combo_type":4,
"price":1337,
"distance":3012,
"minute":9,
"is_fixed_price":1
},
{
"name":"舒适专车",
"product_category":5005,
"require_level":100,
"rule":201,
"level_type":0,
"combo_type":0,
"price":3050,
"distance":3012,
"minute":9,
"is_fixed_price":0
},
{
"name":"企业特价快车",
"product_category":5024,
"require_level":40600,
"rule":301,
"level_type":0,
"combo_type":0,
"price":1579,
"distance":3012,
"minute":9,
"is_fixed_price":1
},
{
"name":"优享",
"product_category":5002,
"require_level":900,
"rule":301,
"level_type":0,
"combo_type":0,
"price":1825,
"distance":3012,
"minute":9,
"is_fixed_price":0
},
{
"name":"快车",
"product_category":5000,
"require_level":600,
"rule":301,
"level_type":0,
"combo_type":0,
"price":1622,
"distance":3012,
"minute":9,
"is_fixed_price":0
},
{
"name":"六座商务",
"product_category":5007,
"require_level":400,
"rule":201,
"level_type":0,
"combo_type":0,
"price":4158,
"distance":3012,
"minute":9,
"is_fixed_price":0
},
{
"name":"豪华车",
"product_category":5009,
"require_level":1000,
"rule":501,
"level_type":0,
"combo_type":0,
"price":11000,
"distance":3012,
"minute":9,
"is_fixed_price":0
}
]
}
}
7. 错误码说明
|
错误码 |
错误信息 |
错误说明 |
|---|---|---|
|
210001 |
企业信息异常 |
- |
|
210002 |
暂无可用车型 |
预估的车型贵企业都无法使用,请与贵方业务同学进行沟通 |
|
210003 |
乘客信息异常 |
- |
|
210004 |
出发地或目的地经纬度解析异常 |
- |
|
211001 |
服务异常,请稍后重试 |
滴滴业务异常,稍后重试即可 |
|
212001 |
服务异常,请稍后重试 |
滴滴用车依赖服务异常,稍后重试即可 |
|
212003 |
抱歉,暂无可用车型 |
预估的车型在该城市无法使用 |
|
212004 |
预估失败:xxxxxx |
具体的预估失败原因 |