最近更新时间:

0. 变更记录

变更时间

变更内容

2024-08-30

支持出租车,入参product_category增加枚举值

1. 接口说明

  1. 预估价格只是参考价格,最终支付费用,以实际产生费用为准
  2. 预估价信息在2分钟内不会变化,超过2分钟请重新预估,否则下单会失败
  3. 使用出租车前,请先联系对接的商务同学开通滴滴出租车账户

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

订单类型
0:实时单
1:预约单

departure_time

string

预计出发时间,预约单必须传,示例:2015-06-16 12:00:09

passenger_phone

string

乘客手机号

exposure_product_category

string

多车型用逗号分割(默认全部车型)
5000:快车
5001:特快
5002:优享
5003:拼车
5004:出租车(开通出租车账户后可使用
5005:舒适专车
5006:行政专车
5007:六座商务
5009:任意豪华车
5024:企业特价快车(不支持预约单、跨城单
193:滴滴轻享(不支持预约单

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&timestamp=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

预估价信息

EstimatePrice结构

字段名称

字段类型

是否必需

字段说明

dynamic_md5

string

预估ID,发单接口需要

estimate_data

list<EstimateDetail>

预估价数据明细

EstimateDetail结构

字段名称

字段类型

是否必需

字段说明

name

string

车型名称

product_category

int32

车型唯一code
5000:快车
5001:滴滴特快
5002:优享
5003:拼车
5005:舒适专车
5006:行政专车
5007:六座商务
5009:任何豪华车
5024:企业特价快车
193:滴滴轻享

require_level

int32

用车类型
100:舒适专车
200:行政专车
400:六座商务
600:普通快车
900:优享
1000:豪华车
40600:企业特价快车
450:滴滴轻享

rule

int32

计价类型
201:专车
203:专车接机
204:专车送机
301:快车
501:豪华车
503:豪华车接机
504:豪华车送机

level_type

int32

品类标识
1:滴滴特快
默认为0

combo_type

int32

计价方式
0:实时计价
2:接机
3:送机
4:拼车一口价
默认为0

price

int32

预估价格,单位:分

distance

int32

预估行驶距离,单位:米

minute

int32

预估行驶时间,单位:分钟

is_fixed_price

int32

是否为一口价
0:非一口价
1:一口价

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

具体的预估失败原因