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

alibaba.amap.channel.car.order.submit (创建订单)

创建用车订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
amap_order_id String 可选 1541894302897424029 高德订单号
channel_order_id String 必须 1541894302897 渠道订单号
mobile String 必须 15811531425 下单人手机号
user_id Number 必须 6334083 用户ID
cp_transport_list CpTransportProduct [] 必须
  • 最大列表长度:999
  • 所勾选的运力信息 参考预估价
    • └ brand_icon_url
    • String
    • 可选
    • http://aososs.oss-cn-beijing.aliyuncs.com/private_car/1234/icon_upload/3a59596ac21da8ee127293d6c9a10734/etravel_eqa.png
    • 运力图标URL
    • └ ext
    • String
    • 可选
    • ""
    • JSON格式扩展信息
    • └ estimate_time
    • String
    • 可选
    • 360
    • 预估时间 单位秒(无目的地订单或者estimate_id不为空时不传,其他类型订单必传)
    • └ estimate_distance
    • String
    • 可选
    • 5000
    • 预估距离 单位m(无目的地订单或者estimate_id不为空不传,其他类型订单必传)
    • └ car_code
    • String
    • 必须
    • etravel_eqa_api|express-car|express
    • 运力唯一标识
    • └ brand_name
    • String
    • 可选
    • 易Q-经济型
    • 运力名称
    • └ estimate_price
    • Number
    • 可选
    • 1922
    • 预估价格 单位分(estimate_id不为空时非必传,其他情况必传)
    • └ estimate_price_id
    • String
    • 可选
    • e3ff870d-02f3-4586-9f9f-f18627f45c7d
    • 预估价ID(estimate_id不为空时非必传,其他情况必传)
    • └ gd_transport_type
    • String
    • 可选
    • gd_express
    • 运力类型(gd_high_quality:品质专车,gd_premium:商务型,gd_express:经济型,gd_luxury:豪华型,gd_compact:优享型,gd_chauffeur 代驾)(estimate_id不为空时非必传,其他情况必传)
    • └ driver_arrive_time
    • Number
    • 可选
    • 23
    • 司机接到乘客预计时间
    • └ city_id
    • String
    • 可选
    • 010
    • 城市ID(estimate_id不为空时非必传,其他情况必传)
    • └ gd_estimate_price_id
    • String
    • 可选
    • e3ff870d-02f3-4586-9f9f-f18627f45c7d
    • 高德预估价ID
    start_location LocationInfo 必须 起始位置信息
    • └ detail_name
    • String
    • 必须
    • 首开广场(西北一门)
    • 详细地址
    • └ name
    • String
    • 必须
    • 首开广场(西北一门)
    • 地址名称
    • └ lon
    • String
    • 必须
    • 116.473253
    • 经度
    • └ lat
    • String
    • 必须
    • 39.993952
    • 纬度
    • └ poi_id
    • String
    • 可选
    • B0FFMF6T6P
    • 起点坐标的POIID
    end_location LocationInfo 可选 目的地位置信息
    • └ detail_name
    • String
    • 可选
    • 育新(地铁站
    • 详细地址
    • └ name
    • String
    • 可选
    • 育新(地铁站
    • 地址名称
    • └ lon
    • String
    • 可选
    • 116.347328
    • 经度
    • └ lat
    • String
    • 可选
    • 40.060039
    • 纬度
    • └ poi_id
    • String
    • 可选
    • B0FFFZRC7K
    • 终点坐标的POIID
    gd_service_id Number 必须 1 订单类型 1实时单 2预约单3接机单4送机单8代驾单10预约代驾(3,4时AirportInfo对应参数不可以为null)
    departure_time Number 必须 1600087832858 订单时间 预约单为预约时间 实时单为当前时间 System.currentTimeMillis()
    extra_info String 可选 "" JSON格式,扩展信息
    trace_id String 可选 6d684a10-873a-5c84-878c-161f15923200 请求的唯一ID
    client_source String 必须 amap-car 渠道来源,高德分配
    idfa String 可选 6d684a10-873a-5c84-878c-161f15923200 ios设备唯一标示
    imei String 可选 6d684a10-873a-5c84-878c-161f15923200 android设备唯一标示
    order_mark String 可选 3 下单标识,3电召打车 其他方式暂可不传
    airport_info AirportInfo 可选 接送机信息
    • └ pick_up_delay_time
    • Number
    • 可选
    • 10
    • 航班到达后,延迟N分钟后用车,接机必传,0-60,单位分钟,0飞机落地时间来接
    • └ arr_air_code
    • String
    • 可选
    • SHA
    • 接送机-到达机场三字码,接机必填
    • └ dep_air_code
    • String
    • 可选
    • XIY
    • 接送机-出发机场三字码,接送机必填
    • └ flight_date
    • Number
    • 可选
    • 1600087832858
    • 接送机-航班出发日期,接机必填 13位毫秒
    • └ flight_no
    • String
    • 可选
    • MU5118
    • 接送机-航班号,接机业务必填
    insurance_amount Number 可选 50 保险金额,单位万元
    support_pay_flag String 可选 1 支付方式,多种支付方式英文逗号分割,为空或为0表示支持所有支付方式 0 - 不限 1 - 仅支持线上支付 2 - 仅支持线下支付
    enterprise_flag Number 可选 1 企业单,企业订单传1
    third_party_dispatch_reward Number 可选 100 奖励金额
    strategy_type Number 可选 3 人工调度(1:定向扫码 3:定向指派下单)
    directional_assignment_information DirectionalAssignmentInformation 可选 定向指派信息
    • └ driver_id
    • String
    • 可选
    • 6334083
    • 司机ID,strategy_type为3时必传
    sub_gd_service_id Number 可选 1 子单类型 1:代叫车 (代叫车必传)
    contact_passenger_first Boolean 可选 true 司机是否优先联系乘车人(代叫车必传)
    passenger_phone String 可选 18771043173 乘车人联系方式(代叫车必传)
    passenger_name String 可选 张三 乘车人名称 (代叫车非必传)
    estimate_id String 可选 6d684a10-873a-5c84-878c-161f15923200 预估Id
    user_mobile_type Number 可选 1 用户手机号类型 1:表示是隐私号
    contact_info ContactInfo 可选 发件信息收件信息(代驾取送车专用)
    • └ start_contact_name
    • String
    • 可选
    • 张三
    • 发件联系人名称
    • └ start_contact_phone
    • String
    • 可选
    • 18771033132
    • 发件联系人电话
    • └ end_contact_name
    • String
    • 可选
    • 李四
    • 收件联系人名称
    • └ end_contact_phone
    • String
    • 可选
    • 18771033132
    • 收件联系人电话
    chauffeur_info ChauffeurInfo 可选 代驾单信息
    • └ plate_number
    • String
    • 可选
    • 京A888888
    • 车牌号码,代驾取送车专用
    • └ vehicle_number
    • String
    • 可选
    • dsfsggfgghhhh
    • 车架号码,代驾取送车专用

    响应参数

    名称 类型 示例值 描述
    trace_id String 6d684a10-873a-5c84-878c-161f15923200 请求的唯一ID
    result_code String 0 "0" 表示成功
    result_msg String "Success" 错误信息
    amap_order_id String 1541894302897424029 高德订单号
    channel_order_id String 1541894302897 渠道订单号

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAmapChannelCarOrderSubmitRequest req = new AlibabaAmapChannelCarOrderSubmitRequest();
    req.setAmapOrderId("1541894302897424029");
    req.setChannelOrderId("1541894302897");
    req.setMobile("15811531425");
    req.setUserId(6334083L);
    List<AlibabaAmapChannelCarOrderSubmitRequest.CpTransportProduct> list2 = new ArrayList<AlibabaAmapChannelCarOrderSubmitRequest.CpTransportProduct>();
    AlibabaAmapChannelCarOrderSubmitRequest.CpTransportProduct obj3 = new AlibabaAmapChannelCarOrderSubmitRequest.CpTransportProduct();
    list2.add(obj3);
    obj3.setBrandIconUrl("http://aososs.oss-cn-beijing.aliyuncs.com/private_car/1234/icon_upload/3a59596ac21da8ee127293d6c9a10734/etravel_eqa.png");
    obj3.setExt("\"\"");
    obj3.setEstimateTime("360");
    obj3.setEstimateDistance("5000");
    obj3.setCarCode("etravel_eqa_api|express-car|express");
    obj3.setBrandName("易Q-经济型");
    obj3.setEstimatePrice(1922L);
    obj3.setEstimatePriceId("e3ff870d-02f3-4586-9f9f-f18627f45c7d");
    obj3.setGdTransportType("gd_express");
    obj3.setDriverArriveTime(23L);
    obj3.setCityId("010");
    obj3.setGdEstimatePriceId("e3ff870d-02f3-4586-9f9f-f18627f45c7d");
    req.setCpTransportList(list2);
    AlibabaAmapChannelCarOrderSubmitRequest.LocationInfo obj4 = new AlibabaAmapChannelCarOrderSubmitRequest.LocationInfo();
    obj4.setDetailName("首开广场(西北一门)");
    obj4.setName("首开广场(西北一门)");
    obj4.setLon("116.473253");
    obj4.setLat("39.993952");
    obj4.setPoiId("B0FFMF6T6P");
    req.setStartLocation(obj4);
    AlibabaAmapChannelCarOrderSubmitRequest.LocationInfo obj5 = new AlibabaAmapChannelCarOrderSubmitRequest.LocationInfo();
    obj5.setDetailName("育新(地铁站");
    obj5.setName("育新(地铁站");
    obj5.setLon("116.347328");
    obj5.setLat("40.060039");
    obj5.setPoiId("B0FFFZRC7K");
    req.setEndLocation(obj5);
    req.setGdServiceId(1L);
    req.setDepartureTime(1600087832858L);
    req.setExtraInfo("\"\"");
    req.setTraceId("6d684a10-873a-5c84-878c-161f15923200");
    req.setClientSource("amap-car");
    req.setIdfa("6d684a10-873a-5c84-878c-161f15923200");
    req.setImei("6d684a10-873a-5c84-878c-161f15923200");
    req.setOrderMark("3");
    AlibabaAmapChannelCarOrderSubmitRequest.AirportInfo obj6 = new AlibabaAmapChannelCarOrderSubmitRequest.AirportInfo();
    obj6.setPickUpDelayTime(10L);
    obj6.setArrAirCode("SHA");
    obj6.setDepAirCode("XIY");
    obj6.setFlightDate(1600087832858L);
    obj6.setFlightNo("MU5118");
    req.setAirportInfo(obj6);
    req.setInsuranceAmount(50L);
    AlibabaAmapChannelCarOrderSubmitRequest.OpenAbility obj7 = new AlibabaAmapChannelCarOrderSubmitRequest.OpenAbility();
    obj7.setHighPriorityDispatch(1L);
    obj7.setWithoutEndLocation(1L);
    obj7.setDispatchFee(500L);
    obj7.setSkipVerifyMobileFlag(1L);
    req.setOpenAbility(obj7);
    req.setSupportPayFlag("1");
    req.setEnterpriseFlag(1L);
    req.setThirdPartyDispatchReward(100L);
    req.setStrategyType(3L);
    AlibabaAmapChannelCarOrderSubmitRequest.DirectionalAssignmentInformation obj8 = new AlibabaAmapChannelCarOrderSubmitRequest.DirectionalAssignmentInformation();
    obj8.setDriverId("6334083");
    req.setDirectionalAssignmentInformation(obj8);
    req.setSubGdServiceId(1L);
    req.setContactPassengerFirst(true);
    req.setPassengerPhone("18771043173");
    req.setPassengerName("张三");
    req.setEstimateId("6d684a10-873a-5c84-878c-161f15923200");
    req.setUserMobileType(1L);
    req.setLastFourDigitsOfRealMobile("5434");
    AlibabaAmapChannelCarOrderSubmitRequest.ContactInfo obj9 = new AlibabaAmapChannelCarOrderSubmitRequest.ContactInfo();
    obj9.setStartContactName("张三");
    obj9.setStartContactPhone("18771033132");
    obj9.setEndContactName("李四");
    obj9.setEndContactPhone("18771033132");
    req.setContactInfo(obj9);
    AlibabaAmapChannelCarOrderSubmitRequest.ChauffeurInfo obj10 = new AlibabaAmapChannelCarOrderSubmitRequest.ChauffeurInfo();
    obj10.setPlateNumber("京A888888");
    obj10.setVehicleNumber("dsfsggfgghhhh");
    req.setChauffeurInfo(obj10);
    AlibabaAmapChannelCarOrderSubmitResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_amap_channel_car_order_submit_response>
        <trace_id>6d684a10-873a-5c84-878c-161f15923200</trace_id>
        <result_code>0</result_code>
        <result_msg>&quot;Success&quot;</result_msg>
        <amap_order_id>1541894302897424029</amap_order_id>
        <channel_order_id>1541894302897</channel_order_id>
    </alibaba_amap_channel_car_order_submit_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-read-timeout
    isp.http-connection-timeout
    http-service-status-error

    API工具

    如何获得此API

    FAQ

    返回
    顶部