预估价格
功能: 根据起点、终点位置、运力类型,估算车费、距离、动调倍数
支持运力: private-car,express-car
资源URL
GET: v1/estimates/prices
注: 预估价格默认锁定 10分钟;对于特殊合作渠道,可以锁定 60分钟 有效时间
请求参数:
参数名 | 类型 | 说明 |
---|---|---|
imei | string(可选) | 手机imei |
start_lat | float | 起点纬度 |
start_lng | float | 起点经度 |
from_name | string | 出发地名称 |
end_lat | float | 终点纬度 |
end_lng | float | 终点经度 |
to_name | string | 目的地名称 |
product_type | string | 产品类型 |
ride_type | string | 运力类型 |
map_type | string(可选) | 坐标系类型,默认soso,支持坐标系见备注 |
departure_time | string/int(可选) | 出行时间。出行时间不同,预估价格不同,默认为当前时间 |
请求示例(平台):
curl -X GET
-H "Content-Type: application/x-www-form-urlencoded"
-H 'Authorization: Bearer domain|{access_token}'
'https://api.xiaojukeji.com/v1/estimates/prices?start_lat=40.058922&start_lng=116.312615&end_lat=39.998568&end_lng=116.344434&product_type=private-car&ride_type=compact&from_name=西二旗地铁站&to_name=五道口购物中心&departure_time=1464331903'
请求示例(用户):
curl -X GET
-H "Content-Type: application/x-www-form-urlencoded"
-H 'Authorization: Bearer domain|{sign} openid|{access_token}'
'https://api.xiaojukeji.com/v1/estimates/prices?start_lat=40.058922&start_lng=116.312615&end_lat=39.998568&end_lng=116.344434&product_type=private-car&ride_type=compact&from_name=西二旗地铁站&to_name=五道口购物中心&departure_time=1464331903'
返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
product_type | string | 产品类型 |
ride_type | string | 运力类型 |
currency_code | string | 货币类型(CNY:人民币) |
estimate_price | int | 预估价格,单位:分 |
time_in_second | int | 行程预估耗时,单位:秒 |
distance_in_meter | int | 预估里程,单位:米 |
car_type | int | 车型 |
dynamic | float | 动调倍数 |
estimate_id | string | 价格预估id,请求行程时必须提供 |
pay_type | string | 支持的支付方式,用逗号隔开(0,1) |
jump_url | string | 跳转到端的链接 |
download_url | string | 下载app端的链接 |
carpool_tag | int | 0 - 未开通,1 - 拼车无拼座,2 - 拼车拼座 |
carpool_info | json类型:,carpool_fee | [{"seat":1,"estimate_price":2340},{"seat":2,"estimate_price":2540}],拼车拼座信息 |
seat | 拼座数(如果开通了拼座) | |
estimate_price | 拼车拼座预估价 |
返回示例
成功:http status 200
失败:http status 非200
[
{
"product_type": "private-car",
"ride_type": "compact",
"currency_code": "CNY",
"estimate_price": 6110,
"time_in_second": 2040,
"distance_in_meter": 9500,
"car_type": 2,
"dynamic": 1,
"estimate_id": "a160b88ed1beda39cb86417180644dce",
"pay_type": "0",
"jump_url": "onetravel://flash",
"download_url": "http://webapp.didistatic.com/static/webapp/shield/z/webapp-download/webapp-download/index.html",
}
]
有拼座的返回
[
{
"product_type": "express-car",
"ride_type": "express",
"currency_code": "CNY",
"estimate_price": 8470,
"time_in_second": 1320,
"distance_in_meter": 9670,
"car_type": 64,
"dynamic": 1.1,
"estimate_id": "363ca05ba685a14f6e058cffaaf88124",
"pay_type": "0,1",
"jump_url": "onetravel://flash",
"download_url": "http://webapp.didistatic.com/static/webapp/shield/z/webapp-download/webapp-download/index.html",
"carpool_tag": "2",
"carpool_info": [
{
"seat": 1,
"estimate_price": 2340
},
{
"seat": 2,
"estimate_price": 2540
}
]
}
]
有拼车无拼座的返回
[
{
"product_type": "express-car",
"ride_type": "express",
"currency_code": "CNY",
"estimate_price": 8470,
"time_in_second": 1320,
"distance_in_meter": 9670,
"car_type": 64,
"dynamic": 1.1,
"estimate_id": "363ca05ba685a14f6e058cffaaf88124",
"pay_type": "0,1",
"jump_url": "onetravel://flash",
"download_url": "http://webapp.didistatic.com/static/webapp/shield/z/webapp-download/webapp-download/index.html",
"carpool_tag": "1",
"carpool_info": [
{
"estimate_price": 3340
}
]
}
]