文档中心 > API类目 > 阿里高德打车API

alibaba.amap.channel.car.prices.query (预估价API)

查询运力预估价 1.支持运力类型筛选 2.支持指定运力排除 请保障联调及使用过程中的手机号为真实用户,否则将导致非本人打车情况,影响您的企业信用等级

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
trace_id String 可选 6d684a10-873a-5c84-878c-161f15923200 请求唯一ID
mobile String 可选 15811531478 乘车人手机号。请保障联调及使用过程中的手机号为真实用户,否则将导致非本人打车情况,影响您的企业信用等级
user_id Number 可选 8767887 用户ID
require_transport_type_list String [] 可选 gd_express
  • 最大列表长度:999
  • 需要车型(gd_high_quality:品质专车,gd_premium:商务型,gd_express:经济型,gd_luxury:豪华型,gd_compact:优享型, gd_chauffeur 代驾)
    start_location LocationInfo 必须 系统自动生成
    • └ name
    • String
    • 必须
    • 首开广场(西北一门)
    • 起始地址名称
    • └ lon
    • String
    • 必须
    • 116.473253
    • 起始经度
    • └ lat
    • String
    • 必须
    • 39.993952
    • 起始维度
    • └ poi_id
    • String
    • 可选
    • BV11040976
    • 起点poiId
    end_location LocationInfo 必须 系统自动生成
    • └ name
    • String
    • 必须
    • 育新(地铁站
    • 目的地地址名称
    • └ lon
    • String
    • 必须
    • 116.347328
    • 目的地经度
    • └ lat
    • String
    • 必须
    • 40.060039
    • 目的地维度
    • └ poi_id
    • String
    • 可选
    • B0FFJI527E
    • 终点poiId
    order_info OrderInfo 必须 系统自动生成
    • └ departure_time
    • Number
    • 必须
    • 1600087832858
    • 行程时间
    • └ gd_service_id
    • Number
    • 必须
    • 1
    • 订单类型 1实时单 2预约单3接机单4送机单 8代驾单 10预约代驾
    • └ dep_air_code
    • String
    • 可选
    • SHA
    • 接送机-出发机场三字码,送机必填
    • └ pick_up_delay_time
    • Number
    • 可选
    • 10
    • 航班到达后,延迟N分钟后用车,接机必传,0-60,单位分钟,0飞机落地时间来接
    • └ flight_date
    • Number
    • 可选
    • 1600087832858
    • 接送机-航班出发日期,接机必填 13位毫秒
    • └ arr_air_code
    • String
    • 可选
    • SHA
    • 接送机-到达机场三字码,接机必填
    • └ flight_no
    • String
    • 可选
    • MU5118
    • 接送机-航班号,接机业务必填
    • └ sub_gd_service_id
    • Number
    • 可选
    • 1
    • 取送车场景传12
    • └ free_minute
    • Number
    • 可选
    • 10
    • 免等时长,单位分钟(仅代驾订单可用)
    • └ equity_km
    • Number
    • 可选
    • 10
    • 权益里程,单位KM(仅代驾订单可用)
    client_source String 必须 amap.car 接入客户端来源,高德分配
    exclude_cp_source_list String [] 可选 car_didi_api
  • 最大列表长度:999
  • 屏蔽指定的运力
    idfa String 可选 6d684a10-873a-5c84-878c-161f15923200 ios设备唯一标示
    imei String 可选 6d684a10-873a-5c84-878c-161f15923200 android设备唯一标示
    require_cp_source_list String [] 可选 car_didi_api
  • 最大列表长度:999
  • 需要的指定运力,此项不为空时exclude_cp_source_list失效

    响应参数

    名称 类型 示例值 描述
    trace_id String 6d684a10-873a-5c84-878c-161f15923200 请求唯一ID
    result_code String 0 结果码
    result_msg String Success 结果信息
    transport_list TransportProduct [] 预估价信息
    • cp_transport_list
    • CpTransportProduct []
    • 预估价信息
    • └ ext
    • String
    • 扩展信息
    • └ estimate_time
    • Number
    • 2400
    • 预估时间 单位秒
    • └ estimate_distance
    • Number
    • 18000
    • 预估距离 单位m
    • └ code
    • String
    • car_shenzhou_api|private-car|4
    • 运力唯一标识
    • └ brand_icon_url
    • String
    • http://aos-cdn-files.cn-hangzhou.oss.aliyun-inc.com/aos-amaps/private_car/92a8066bb8e511e99e72186590d5b589_new_car_sqyc.png
    • 运力图标URL
    • └ brand_name
    • String
    • 首汽约车
    • 运力名称
    • └ estimate_price
    • Number
    • 10000
    • 预估价格 单位分
    • └ estimate_price_id
    • String
    • 023E17F0F5B65B9ACA6A5DD7AC03B117
    • 预估价ID
    • └ favourable_estimate_price
    • Number
    • 2434
    • 优惠后预估价格 单位分
    • └ driver_arrive_time
    • Number
    • 23
    • 司机接到乘客预计时间
    • └ city_id
    • String
    • 010
    • 城市ID
    • └ gd_estimate_price_id
    • String
    • 023E17F0F5B65B9ACA6A5DD7AC03B117
    • 高德预估价ID
    • special_fee_item_list
    • SpecialFeeItem []
    • 特殊费项
    • └ title
    • String
    • 平台调度费
    • 费项名称
    • └ value
    • Number
    • 500
    • 费项金额,单位分
    • └ type
    • String
    • platformDispatchFee
    • 费项类型
    • └ business_model
    • Number
    • 1
    • 业务类型:0:出租车;1:网约车;2:巡转网(打表);3:巡转网(线上)6:代驾
    • └ total_coupon_amount
    • Number
    • 10
    • 优惠金额
    • └ transport_type_name
    • String
    • 经济
    • 运力类型名称
    • └ transport_type
    • String
    • gd_express
    • 运力类型
    estimate_id String 预估ID 023E17F0F5B65B9ACA6A5DD7AC03B117

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAmapChannelCarPricesQueryRequest req = new AlibabaAmapChannelCarPricesQueryRequest();
    req.setTraceId("6d684a10-873a-5c84-878c-161f15923200");
    req.setMobile("15811531478");
    req.setUserId(8767887L);
    req.setRequireTransportTypeList("gd_express");
    AlibabaAmapChannelCarPricesQueryRequest.LocationInfo obj1 = new AlibabaAmapChannelCarPricesQueryRequest.LocationInfo();
    obj1.setName("首开广场(西北一门)");
    obj1.setLon("116.473253");
    obj1.setLat("39.993952");
    obj1.setPoiId("BV11040976");
    req.setStartLocation(obj1);
    AlibabaAmapChannelCarPricesQueryRequest.LocationInfo obj2 = new AlibabaAmapChannelCarPricesQueryRequest.LocationInfo();
    obj2.setName("育新(地铁站");
    obj2.setLon("116.347328");
    obj2.setLat("40.060039");
    obj2.setPoiId("B0FFJI527E");
    req.setEndLocation(obj2);
    AlibabaAmapChannelCarPricesQueryRequest.OrderInfo obj3 = new AlibabaAmapChannelCarPricesQueryRequest.OrderInfo();
    obj3.setDepartureTime(1600087832858L);
    obj3.setGdServiceId(1L);
    obj3.setDepAirCode("SHA");
    obj3.setPickUpDelayTime(10L);
    obj3.setFlightDate(1600087832858L);
    obj3.setArrAirCode("SHA");
    obj3.setFlightNo("MU5118");
    obj3.setSubGdServiceId(1L);
    obj3.setFreeMinute(10L);
    obj3.setEquityKm(10L);
    req.setOrderInfo(obj3);
    req.setClientSource("amap.car");
    req.setExcludeCpSourceList("car_didi_api");
    req.setIdfa("6d684a10-873a-5c84-878c-161f15923200");
    req.setImei("6d684a10-873a-5c84-878c-161f15923200");
    req.setRequireCpSourceList("car_didi_api");
    AlibabaAmapChannelCarPricesQueryResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_amap_channel_car_prices_query_response>
        <trace_id>6d684a10-873a-5c84-878c-161f15923200</trace_id>
        <result_code>0</result_code>
        <result_msg>Success</result_msg>
        <transport_list>
            <transport_product>
                <cp_transport_list>
                    <cp_transport_product>
                        <ext></ext>
                        <estimate_time>2400</estimate_time>
                        <estimate_distance>18000</estimate_distance>
                        <code>car_shenzhou_api|private-car|4</code>
                        <brand_icon_url>http://aos-cdn-files.cn-hangzhou.oss.aliyun-inc.com/aos-amaps/private_car/92a8066bb8e511e99e72186590d5b589_new_car_sqyc.png</brand_icon_url>
                        <brand_name>首汽约车</brand_name>
                        <estimate_price>10000</estimate_price>
                        <estimate_price_id>023E17F0F5B65B9ACA6A5DD7AC03B117</estimate_price_id>
                        <favourable_estimate_price>2434</favourable_estimate_price>
                        <driver_arrive_time>23</driver_arrive_time>
                        <city_id>010</city_id>
                        <gd_estimate_price_id>023E17F0F5B65B9ACA6A5DD7AC03B117</gd_estimate_price_id>
                        <special_fee_item_list>
                            <special_fee_item>
                                <title>平台调度费</title>
                                <value>500</value>
                                <type>platformDispatchFee</type>
                            </special_fee_item>
                        </special_fee_item_list>
                        <business_model>1</business_model>
                        <total_coupon_amount>10</total_coupon_amount>
                    </cp_transport_product>
                </cp_transport_list>
                <transport_type_name>经济</transport_type_name>
                <transport_type>gd_express</transport_type>
            </transport_product>
        </transport_list>
        <estimate_id>预估ID</estimate_id>
    </alibaba_amap_channel_car_prices_query_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isp.http-connection-timeout
    isp.http-read-timeout
    isp.http-connection-refuse
    http-service-status-error

    API工具

    如何获得此API

    FAQ

    返回
    顶部