文档中心 > API类目 > 旅行用车API

qimen.alitrip.transfer.prices.query (飞猪即时打车&接送机报价查询接口)

飞猪即时打车&接送机报价查询接口,调用服务商报价查询服务获取实时用车报价

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
traceId String 可选 1111 建议必填,本次请求的标识,用于异常记录、追踪。由上层调用方填充,如果上层调用方不填充则默认使用eagleTraceId
channelId String 可选 20001 服务商渠道id,运营配置后提供
isPressureTest Boolean 可选 false
  • 默认值:false
  • 是否压测流量,默认false
    useType Number 可选 1 用车类型 1 接机 2 送机 3 接站 4 送站 5预约车 6实时叫车(必填)
    isCorpOrder Boolean 可选 false 是否企业用车
    channelName String 可选 耀出行 服务商渠道名称
    itemId Number 可选 1111 商品ID,可能不存在
    sellerId Number 可选 11111 卖家id
    userId Number 可选 1111 本次请求的触发用户id
    exts String 可选 key:value 预留扩展信息,KV对形式
    transferDest TransferDest 可选 接送机,接送站 所在地信息
    • └ countryName
    • String
    • 可选
    • 中国
    • 国家名称
    • └ cityName
    • String
    • 可选
    • 杭州
    • 城市名称
    • └ countryCode
    • String
    • 可选
    • CN
    • 国家编码
    • └ cityCode
    • String
    • 可选
    • HGH
    • 城市编码(三字码)
    • └ originCity
    • String
    • 可选
    • 杭州
    • 出发地所在城市名称
    • └ destCity
    • String
    • 可选
    • 北京
    • 到达地所在城市名称
    fromPlaceInfo FromPlaceInfo 可选 出发地信息
    • └ fromAddress
    • String
    • 可选
    • 北京首都机场
    • 出发地(必填)
    • └ fromDetailAddress
    • String
    • 可选
    • 北京首都机场
    • 出发详细地址,接机时可能不存在该值
    • └ fromLongitude
    • String
    • 可选
    • 40.08188
    • 出发地经度(必填)
    • └ fromLatitude
    • String
    • 可选
    • 116.590401
    • 出发地纬度(必填)
    toPlaceInfo ToPlaceInfo 可选 到达地信息
    • └ toAddress
    • String
    • 可选
    • 乐佳国际2号楼
    • 到达地(必填)
    • └ toDetailAddress
    • String
    • 可选
    • 余杭区良睦路999号
    • 到达地详细地址,送机时可能不存在该值
    • └ toLongitude
    • String
    • 可选
    • 40.166602
    • 到达地经度(必填)
    • └ toLatitude
    • String
    • 可选
    • 116.266735
    • 到达地纬度(必填)
    flightInfo FlightInfo 可选 航班信息
    • └ flightNo
    • String
    • 可选
    • MU5132
    • 航班号
    • └ flightFlyTime
    • String
    • 可选
    • 2017-05-07 19:00:00
    • 航班起飞时间 (当地时间)
    • └ flightDepartureTime
    • String
    • 可选
    • 2017-05-07 19:00:00
    • 航班起飞时间
    • └ airportCode
    • String
    • 可选
    • PEK
    • 机场三字码
    • └ originAirportCode
    • String
    • 可选
    • HGH
    • 接机航班出发地三字码
    • └ airportTerminal
    • String
    • 可选
    • 北京首都机场T1
    • 航站楼
    carUseInfo CarUseInfo 可选 用车时间、距离、车型信息
    • └ serviceTime
    • String
    • 可选
    • 2020-02-23 21:30:00
    • 用车时间(当地时间 必填)
    • └ serviceTimeMs
    • String
    • 可选
    • 1582464600000
    • 用车时间(当地时间)毫秒数
    • └ distance
    • String
    • 可选
    • 22222
    • 出发地至目的地之间距离 单位(米)
    • └ distanceType
    • Number
    • 可选
    • 0
    • 地图距离计算类型 0地图API 1自算
    • └ expectedTime
    • String
    • 可选
    • 2820
    • 预计用时 单位:秒
    • └ flightDelayTime
    • String
    • 可选
    • 30
    • 下飞机后多久用车(分)
    • └ carTypeList
    • Number []
    • 可选
    • 指定车型列表,可能为空
    strategy String 可选 [1,30] 1:商家默认现实策略(默认不传)10:价格最少,20:时间最短,30:高速优先,40:指定途径点
    routePlanInfos RoutePlanInfo [] 可选
  • 最大列表长度:999
  • 只有在指定策略的时候会有值,如:30:高速优先,40:指定途径点
    • └ strategyId
    • Number
    • 可选
    • 30
    • 30:高速优先策略,40:指定途径点
    • waypoints
    • WaypointPoiInfo []
    • 可选
    • 途经点,最大数目:16个坐标点
    • └ longitude
    • String
    • 可选
    • 116.357483
    • 经度
    • └ latitude
    • String
    • 可选
    • 39.907234
    • 纬度
    • └ expectedTime
    • Number
    • 可选
    • 300
    • 预计用时 单位:秒
    • └ distance
    • String
    • 可选
    • 3000
    • 距离单位:米
    • additionalFees
    • AdditionalFeeInfo []
    • 可选
    • 附加费用(高速费用)单位:元,备注这个如果有高速费用一定要传,并要传准,高速费减佣
    • └ additionalFeeType
    • Number
    • 可选
    • 1
    • * 费用项 * 1:高速费用 * 2:停车费
    • └ additionalFee
    • String
    • 可选
    • 10.00
    • 费用金额 单位元

    响应参数

    名称 类型 示例值 描述
    providerId String 20001 服务商标识,由飞猪运营人员提供
    distance String 22222 服务商计算出的实际服务距离,单位:米
    expectedTime Number 30 服务商计算出的预计用时 单位:分钟
    success Boolean true 接口调用是否成功,必须返回
    priceList PriceInfo [] 车型报价列表
    • └ vendorId
    • Number
    • 111
    • 车队ID,车队会填充该字段,下单的时候需要回传
    • └ carType
    • Number
    • 2
    • 车型,具体车型定义咨询运营人员
    • └ price
    • String
    • 100.00
    • 价格(必填)
    • └ priceMark
    • String
    • B013F8A4CEDE6483
    • 服务商价格标识
    • └ sellerId
    • Number
    • 22222
    • 可选,提供用车服务的卖家id。接送机CRS卖家必填
    • └ supportServices
    • String []
    • 支持的特色服务列表,由飞猪运营提供相应ID,最多展示三个,如["65","4","16"]
    • └ ruleId
    • Number
    • 3
    • 该车辆报价 所适用的规则id(卖家需要登录商户crs后台配置生成规则)
    • pickupPosition
    • PickupPosition
    • 接送地点图文描述
    • └ desc
    • String
    • 接送地点 文字描述
    • 接送地点 文字描述
    • └ pic
    • String
    • http://www.xxx.com
    • 接送地点 图片展示链接
    • priceDetailMeta
    • CarPriceDetailMeta
    • 价格明细
    • └ timePrice
    • String
    • 10
    • 时租时长费 / 产品包超出包含时长的费用,结果已经乘以浮动系数
    • └ kilometrePrice
    • String
    • 10
    • 时租里程费 / 产品包超出包含里程的费用,结果已经乘以浮动系数
    • └ startPrice
    • String
    • 10
    • 时租起步价/产品包起步价,结果已经乘以浮动系数
    • └ perTimePrice
    • String
    • 10
    • 产品包超出包含时长的时长单价(N元/分钟),结果已经乘以浮动系数
    • └ perKilometrePrice
    • String
    • 10
    • 产品包超出包含里程的里程单价(N元/公里),结果已经乘以浮动系数
    • └ longDistancePrice
    • String
    • 10
    • 时租远途费,结果已经乘以浮动系数(价格类型为时租时使用)
    • └ outCityPrice
    • String
    • 10
    • 时租出城费(价格类型为时租时使用)
    • └ floatFactor
    • String
    • 10
    • 时租价格浮动系数(价格类型为时租时使用)
    • └ itemId
    • Number
    • 12355
    • crs宝贝化 商品id
    • └ ext
    • String
    • {"k1":"v1","k2","v2"}
    • 扩展字段属性kv格式
    errorInfo ErrorInfo 接口调用错误信息
    • └ code
    • String
    • 1
    • 错误码
    • └ message
    • String
    • 错误信息
    • 错误信息
    • └ sub_code
    • String
    • 1
    • 子错误码
    • └ sub_message
    • String
    • 子错误信息
    • 子错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AlitripTransferPricesQueryRequest req = new AlitripTransferPricesQueryRequest();
    req.setTraceId("1111");
    req.setChannelId("20001");
    req.setIsPressureTest(false);
    req.setUseType(1L);
    req.setIsCorpOrder(false);
    req.setChannelName("耀出行");
    req.setItemId(1111L);
    req.setSellerId(11111L);
    req.setUserId(1111L);
    req.setExts("key:value");
    AlitripTransferPricesQueryRequest.TransferDest obj1 = new AlitripTransferPricesQueryRequest.TransferDest();
    obj1.setCountryName("中国");
    obj1.setCityName("杭州");
    obj1.setCountryCode("CN");
    obj1.setCityCode("HGH");
    obj1.setOriginCity("杭州");
    obj1.setDestCity("北京");
    req.setTransferDest(obj1);
    AlitripTransferPricesQueryRequest.FromPlaceInfo obj2 = new AlitripTransferPricesQueryRequest.FromPlaceInfo();
    obj2.setFromAddress("北京首都机场");
    obj2.setFromDetailAddress("北京首都机场");
    obj2.setFromLongitude("40.08188");
    obj2.setFromLatitude("116.590401");
    req.setFromPlaceInfo(obj2);
    AlitripTransferPricesQueryRequest.ToPlaceInfo obj3 = new AlitripTransferPricesQueryRequest.ToPlaceInfo();
    obj3.setToAddress("乐佳国际2号楼");
    obj3.setToDetailAddress("余杭区良睦路999号");
    obj3.setToLongitude("40.166602");
    obj3.setToLatitude("116.266735");
    req.setToPlaceInfo(obj3);
    AlitripTransferPricesQueryRequest.FlightInfo obj4 = new AlitripTransferPricesQueryRequest.FlightInfo();
    obj4.setFlightNo("MU5132");
    obj4.setFlightFlyTime("2017-05-07 19:00:00");
    obj4.setFlightDepartureTime("2017-05-07 19:00:00");
    obj4.setAirportCode("PEK");
    obj4.setOriginAirportCode("HGH");
    obj4.setAirportTerminal("北京首都机场T1");
    req.setFlightInfo(obj4);
    AlitripTransferPricesQueryRequest.CarUseInfo obj5 = new AlitripTransferPricesQueryRequest.CarUseInfo();
    obj5.setServiceTime("2020-02-23 21:30:00");
    obj5.setServiceTimeMs("1582464600000");
    obj5.setDistance("22222");
    obj5.setDistanceType(0L);
    obj5.setExpectedTime("2820");
    obj5.setFlightDelayTime("30");
    obj5.setCarTypeList(new Long[] {  };
    );
    req.setCarUseInfo(obj5);
    req.setStrategy("[1,30]");
    List<AlitripTransferPricesQueryRequest.RoutePlanInfo> list7 = new ArrayList<AlitripTransferPricesQueryRequest.RoutePlanInfo>();
    AlitripTransferPricesQueryRequest.RoutePlanInfo obj8 = new AlitripTransferPricesQueryRequest.RoutePlanInfo();
    list7.add(obj8);
    obj8.setStrategyId(30L);
    List<AlitripTransferPricesQueryRequest.WaypointPoiInfo> list11 = new ArrayList<AlitripTransferPricesQueryRequest.WaypointPoiInfo>();
    AlitripTransferPricesQueryRequest.WaypointPoiInfo obj12 = new AlitripTransferPricesQueryRequest.WaypointPoiInfo();
    list11.add(obj12);
    obj12.setLongitude("116.357483");
    obj12.setLatitude("39.907234");
    list9.setWaypoints(list11);
    obj8.setExpectedTime(300L);
    obj8.setDistance("3000");
    List<AlitripTransferPricesQueryRequest.AdditionalFeeInfo> list15 = new ArrayList<AlitripTransferPricesQueryRequest.AdditionalFeeInfo>();
    AlitripTransferPricesQueryRequest.AdditionalFeeInfo obj16 = new AlitripTransferPricesQueryRequest.AdditionalFeeInfo();
    list15.add(obj16);
    obj16.setAdditionalFeeType(1L);
    obj16.setAdditionalFee("10.00");
    list13.setAdditionalFees(list15);
    req.setRoutePlanInfos(list7);
    AlitripTransferPricesQueryResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <providerId>20001</providerId>
    <distance>22222</distance>
    <expectedTime>30</expectedTime>
    <success>true</success>
    <priceList>
        <price_info>
            <vendorId>111</vendorId>
            <carType>2</carType>
            <price>100.00</price>
            <priceMark>B013F8A4CEDE6483</priceMark>
            <sellerId>22222</sellerId>
            <ruleId>3</ruleId>
            <pickupPosition>
                <desc>接送地点 文字描述</desc>
                <pic>http://www.xxx.com</pic>
            </pickupPosition>
            <priceDetailMeta>
                <timePrice>10</timePrice>
                <kilometrePrice>10</kilometrePrice>
                <startPrice>10</startPrice>
                <perTimePrice>10</perTimePrice>
                <perKilometrePrice>10</perKilometrePrice>
                <longDistancePrice>10</longDistancePrice>
                <outCityPrice>10</outCityPrice>
                <floatFactor>10</floatFactor>
            </priceDetailMeta>
            <itemId>12355</itemId>
            <ext>{&quot;k1&quot;:&quot;v1&quot;,&quot;k2&quot;,&quot;v2&quot;}</ext>
        </price_info>
    </priceList>
    <errorInfo>
        <code>1</code>
        <message>错误信息</message>
        <sub_code>1</sub_code>
        <sub_message>子错误信息</sub_message>
    </errorInfo>
    

    异常示例

    • 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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部