预估价格

功能: 根据起点、终点位置、运力类型,估算车费、距离、动调倍数

支持运力: 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
      }
    ]
  }
]

results matching ""

    No results matching ""