refactor(robotaxi/api/begin-route): 为 begin-route API 添加完整 TypeScript 类型支持

hejianhao

2026-05-15 ba9da5d7e15fe2441182a5d246ebfaad402f366b

refactor(robotaxi/api/begin-route): 为 begin-route API 添加完整 TypeScript 类型支持

新增对应类型定义文件，统一管理相关 API 类型
为所有导出的 API 函数补全参数与返回值的类型注解，提升代码类型安全性与可维护性

 src/robotaxi/api/begin-route.ts

@@ -1,8 +1,48 @@
import request from '../../utils/request';
import { _ROBOTAXI_HOST } from '../../constants/api';
import type {
    AirConditionerUnlockPayload,
    EndOrderResponse,
    GetOrderPaymentPayload,
    GetWaitTimePayload,
    NumericLike,
    OrderChangePayload,
    OrderCommentTypeItem,
    OrderId,
    OrderIdPayload,
    QueryFareBreakdownPayload,
    QueryFareBreakdownResponse,
    QueryOrderQueueStatusPayload,
    QueryOrderQueueStatusResponse,
    QueryOrderRoutePayload,
    QueryOrderRouteResponse,
    QueryRouteAndFarePayload,
    QueryRouteAndFareResponse,
    QueryRoutePreferencesPayload,
    QueryRoutePreferencesResponse,
    QueryTemperatureByOrderIdResponse,
    QueryVehicleAirConditionerSwitchResponse,
    QueryVehicleByOrderIdResponse,
    QueryVehicleTrunkOpenStatusResponse,
    RouteStaleCheckPayload,
    RouteStaleCheckResponse,
    SaveOrderPayload,
    SaveOrderResponse,
    SaveRoutePreferencePayload,
    SetTemperaturePayload,
    SetTemperatureResponse,
    ShareQueryOrderInfoPayload,
    ShareQueryOrderInfoResponse,
    ShareQueryOrderRouteResponse,
    SubmitComplaintPayload,
    SubmitFeedbackResponse,
    SubmitOrderCommentPayload,
    UnlockVehiclePayload,
    UnlockVehicleResponse
} from './types/begin-route';

// 导航-获取路线和费用
export const queryRouteAndFare = async (payload) => {
export const queryRouteAndFare = async (payload: QueryRouteAndFarePayload): Promise<QueryRouteAndFareResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/itinerary/base/v1/mini-program/navigation/multi-route-and-fare',
        method: 'POST',
@@ -11,7 +51,9 @@
}

// 导航-获取路线偏好配置
export const queryRoutePreferences = async (payload) => {
export const queryRoutePreferences = async (
    payload: QueryRoutePreferencesPayload
): Promise<QueryRoutePreferencesResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/itinerary/base/v1/mini-program/navigation/route-preferences',
        method: 'GET',
@@ -20,7 +62,7 @@
}

// 导航-设置路线偏好
export const saveRoutePreference = async (payload) => {
export const saveRoutePreference = async (payload: SaveRoutePreferencePayload): Promise<void> => {
    return request({
        url: _ROBOTAXI_HOST + '/itinerary/base/v1/mini-program/navigation/route-preference',
        method: 'POST',
@@ -29,7 +71,9 @@
}

// 导航-下单前校验路况是否过期
export const routeStaleCheck = async (payload?) => {
export const routeStaleCheck = async (
    payload?: RouteStaleCheckPayload
): Promise<RouteStaleCheckResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/itinerary/base/v1/mini-program/navigation/route-stale-check',
        method: 'POST',
@@ -38,7 +82,7 @@
}

// 保存订单
export const saveOrder = async (payload) => {
export const saveOrder = async (payload: SaveOrderPayload): Promise<SaveOrderResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/itinerary/base/v1/mini-program/order/save',
        method: 'POST',
@@ -47,7 +91,7 @@
}

// 获取等待时间
export const getWaitTime = async (payload) => {
export const getWaitTime = async (payload: GetWaitTimePayload): Promise<NumericLike> => {
    return request({
        url: _ROBOTAXI_HOST + '/itinerary/base/v1/mini-program/pricing/getWaitTime',
        method: 'POST',
@@ -56,7 +100,9 @@
}

// 查询订单车辆信息
export const queryVehicleByOrderId = async (payload) => {
export const queryVehicleByOrderId = async (
    payload: OrderIdPayload
): Promise<QueryVehicleByOrderIdResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/order/api/v1/mini-program/order/queryVehicleByOrderId',
        method: 'GET',
@@ -65,7 +111,7 @@
}

// 设置温度
export const setTemperature = async (payload) => {
export const setTemperature = async (payload: SetTemperaturePayload): Promise<SetTemperatureResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/vehicleConvoy/api/v1/mini-program/order/ac/set-temperature',
        method: 'POST',
@@ -74,7 +120,7 @@
}

// 解锁车辆
export const unlockVehicle = async (payload) => {
export const unlockVehicle = async (payload: UnlockVehiclePayload): Promise<UnlockVehicleResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/vehicleConvoy/api/v1/mini-program/order/vehicle/unlock',
        method: 'POST',
@@ -85,7 +131,9 @@
}

// 查询车辆温度
export const queryTemperatureByOrderId = async (payload) => {
export const queryTemperatureByOrderId = async (
    payload: OrderIdPayload
): Promise<QueryTemperatureByOrderIdResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/vehicleConvoy/api/v1/mini-program/order/queryTemperatureByOrderId',
        method: 'GET',
@@ -94,7 +142,9 @@
}

// 查询车辆空调开关状态
export const queryVehicleAirConditionerSwitch = async (payload) => {
export const queryVehicleAirConditionerSwitch = async (
    payload: OrderIdPayload
): Promise<QueryVehicleAirConditionerSwitchResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/vehicleConvoy/api/v1/mini-program/order/queryVehicleAirConditionerSwitch',
        method: 'GET',
@@ -103,7 +153,7 @@
}

// 车辆空调开关控制
export const airConditionerUnlock = async (payload) => {
export const airConditionerUnlock = async (payload: AirConditionerUnlockPayload): Promise<void> => {
    return request({
        url: _ROBOTAXI_HOST + '/vehicleConvoy/api/v1/mini-program/order/airConditionerUnlock',
        method: 'POST',
@@ -112,7 +162,9 @@
}

// 查询后备箱开启状态
export const queryVehicleTrunkOpenStatus = async (payload) => {
export const queryVehicleTrunkOpenStatus = async (
    payload: OrderIdPayload
): Promise<QueryVehicleTrunkOpenStatusResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/vehicleConvoy/api/v1/mini-program/order/queryVehicleTrunkOpenStatus',
        method: 'GET',
@@ -121,7 +173,7 @@
}

// 获取自动结束行程时间
export const queryOrderFinishTime = async () => {
export const queryOrderFinishTime = async (): Promise<NumericLike> => {
    return request({
        url: _ROBOTAXI_HOST + '/operation/api/v1/mini-program/support/getOrderFinishTime',
        method: 'GET'
@@ -129,7 +181,7 @@
}

// 结束订单
export const endOrder = async (payload) => {
export const endOrder = async (payload: OrderId): Promise<EndOrderResponse> => {
    return request({
        url: _ROBOTAXI_HOST + `/order/api/v1/mini-program/order/endTrip/${payload}`,
        method: 'PUT',
@@ -140,7 +192,7 @@
}

// 修改目的地
export const orderChange = async (payload) => {
export const orderChange = async (payload: OrderChangePayload): Promise<void> => {
    return request({
        url: _ROBOTAXI_HOST + '/itinerary/api/v1/mini-program/order/orderChange',
        method: 'POST',
@@ -149,7 +201,9 @@
}

// 查询订单费用明细
export const queryFareBreakdown = async (payload) => {
export const queryFareBreakdown = async (
    payload: QueryFareBreakdownPayload
): Promise<QueryFareBreakdownResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/order/api/v1/mini-program/order/fare-breakdown',
        method: 'POST',
@@ -158,7 +212,9 @@
}

// 提交订单评价
export const submitOrderComment = async (payload) => {
export const submitOrderComment = async (
    payload: SubmitOrderCommentPayload
): Promise<SubmitFeedbackResponse> => {
    return request({
        url: _ROBOTAXI_HOST + `/order/api/v1/mini-program/order/comment`,
        method: 'POST',
@@ -166,7 +222,9 @@
    }, true);
}

export const submitComplaint = async (payload) => {
export const submitComplaint = async (
    payload: SubmitComplaintPayload
): Promise<SubmitFeedbackResponse> => {
    return request({
        url: _ROBOTAXI_HOST + `/operation/base/v1/mini-program/complaint/submit`,
        method: 'POST',
@@ -175,7 +233,7 @@
}

// 获取订单评价类型
export const getOrderCommentType = async () => {
export const getOrderCommentType = async (): Promise<OrderCommentTypeItem[]> => {
    return request({
        url: _ROBOTAXI_HOST + `/operation/base/v1/mini-program/feedback-type/getList`,
        method: 'GET'
@@ -183,7 +241,7 @@
}

// 获取订单支付方式
export const getOrderPayment = async (payload) => {
export const getOrderPayment = async (payload: GetOrderPaymentPayload): Promise<void> => {
    return request({
        url: _ROBOTAXI_HOST + `/order/api/v1/mini-program/order/payment`,
        method: 'POST',
@@ -192,7 +250,7 @@
}

// 取消订单
export const cancelOrder = async (orderId: string | number) => {
export const cancelOrder = async (orderId: OrderId): Promise<void> => {
    return request({
        url: _ROBOTAXI_HOST + `/order/api/v1/mini-program/order/cancel/${orderId}`,
        method: 'PUT',
@@ -203,7 +261,9 @@
}

// 订单查询实时轨迹路线
export const queryOrderRoute = async (payload) => {
export const queryOrderRoute = async (
    payload: QueryOrderRoutePayload
): Promise<QueryOrderRouteResponse> => {
    return request({
        url: _ROBOTAXI_HOST + `/order/api/v1/mini-program/order/queryOrderRoute`,
        method: 'POST',
@@ -212,7 +272,9 @@
}

// 订单查询轨迹
export const queryOrderTrajectory = async (payload) => {
export const queryOrderTrajectory = async (
    payload: QueryOrderRoutePayload
): Promise<QueryOrderRouteResponse> => {
    return request({
        url: _ROBOTAXI_HOST + `/order/api/v1/mini-program/order/queryOrderTrajectory`,
        method: 'GET',
@@ -221,7 +283,9 @@
}

// 订单查询队列状态
export const queryOrderQueueStatus = async (payload) => {
export const queryOrderQueueStatus = async (
    payload: QueryOrderQueueStatusPayload
): Promise<QueryOrderQueueStatusResponse> => {
    return request({
        url: _ROBOTAXI_HOST + `/itinerary/base/v1/mini-program/order/queue-status`,
        method: 'GET',
@@ -230,7 +294,7 @@
}

// 分享订单查询实时轨迹路线
export const shareQueryOrderRoute = async (orderId) => {
export const shareQueryOrderRoute = async (orderId: OrderId): Promise<ShareQueryOrderRouteResponse> => {
    return request({
        url: _ROBOTAXI_HOST + `/order/base/v1/mini-program/orderActive/share/queryOrderRoute/${orderId}`,
        method: 'GET'
@@ -238,7 +302,9 @@
}

// 分享订单查询订单详情
export const shareQueryOrderInfo = async (payload) => {
export const shareQueryOrderInfo = async (
    payload: ShareQueryOrderInfoPayload
): Promise<ShareQueryOrderInfoResponse> => {
    return request({
        url: _ROBOTAXI_HOST + '/order/base/v1/mini-program/orderActive/share/orderInfo',
        method: 'GET',

 src/robotaxi/api/types/begin-route.ts

New file
@@ -0,0 +1,538 @@
/** 订单 ID 类型。 */
export type OrderId = string | number;

/** 数值兼容类型。 */
export type NumericLike = number | string;

/** 通用扩展对象。 */
export interface ExtendableRecord {
    /** 扩展字段。 */
    [key: string]: unknown;
}

/** 通用经纬度点位。 */
export interface LocationPoint {
    /** 纬度。 */
    latitude: NumericLike;
    /** 经度。 */
    longitude: NumericLike;
}

/** 通用接口包裹响应。 */
export interface ApiEnvelope<TData = unknown> extends ExtendableRecord {
    /** 业务状态码。 */
    code?: number;
    /** 业务提示文案。 */
    msg?: string;
    /** 业务数据。 */
    data?: TData;
}

/** 路线折线点。 */
export interface RoutePolylinePoint extends ExtendableRecord {
    /** 纬度。 */
    latitude?: NumericLike;
    /** 经度。 */
    longitude?: NumericLike;
}

/** 路线摘要。 */
export interface RouteSummary extends ExtendableRecord {
    /** 路线 ID。 */
    routeID?: OrderId;
    /** 路况指纹。 */
    pathFingerprint?: string;
    /** 折线点集合。 */
    polyline?: RoutePolylinePoint[];
    /** 路线距离。 */
    distance?: NumericLike;
    /** 路线时长。 */
    duration?: NumericLike;
    /** 红绿灯数量。 */
    trafficLights?: NumericLike;
}

/** 路线费用信息。 */
export interface RouteFareEstimate extends ExtendableRecord {
    /** 预估等待时长。 */
    waitingTime?: NumericLike;
    /** 最终金额。 */
    finalFare?: NumericLike;
    /** 原价金额。 */
    originalFare?: NumericLike;
}

/** 单条路线选项。 */
export interface RouteOptionItem extends ExtendableRecord {
    /** 路线基础信息。 */
    route?: RouteSummary;
    /** 费用估算。 */
    fareEstimate?: RouteFareEstimate;
    /** 定价卡信息。 */
    xpPricingCard?: unknown;
    /** 快照 ID。 */
    snapshotId?: OrderId;
    /** 路线生成时间戳。 */
    generatedAtMillis?: NumericLike;
    /** 主路线规划策略。 */
    primaryRoutePlanRule?: NumericLike;
    /** 主策略展示文案。 */
    primaryStrategyLabel?: string;
    /** 高德路线策略。 */
    amapStrategy?: NumericLike;
    /** 路线 ID。 */
    routeId?: OrderId;
}

/** 路线与费用查询请求。 */
export interface QueryRouteAndFarePayload {
    /** 起点。 */
    origin: LocationPoint;
    /** 终点。 */
    destination: LocationPoint;
    /** 开通城市 ID。 */
    openCityId: NumericLike;
    /** 起点站点 ID。 */
    startPointId: OrderId | '';
    /** 用户优惠券 ID。 */
    userCouponId?: OrderId | '';
}

/** 路线与费用查询对象响应。 */
export interface QueryRouteAndFareObjectResponse extends ExtendableRecord {
    /** 路线选项集合。 */
    routes?: RouteOptionItem[];
    /** 快照 ID。 */
    snapshotId?: OrderId;
    /** 路线生成时间戳。 */
    generatedAtMillis?: NumericLike;
}

/** 路线与费用查询响应。 */
export type QueryRouteAndFareResponse =
    | QueryRouteAndFareObjectResponse
    | RouteOptionItem[]
    | RouteOptionItem;

/** 路线偏好查询请求。 */
export interface QueryRoutePreferencesPayload {
    /** 开通城市 ID。 */
    openCityId: NumericLike;
}

/** 路线偏好项。 */
export interface RoutePreferenceItem extends ExtendableRecord {
    /** 偏好编码。 */
    code?: string;
    /** 偏好名称。 */
    name?: string;
    /** 规划策略值。 */
    amapStrategy?: NumericLike;
    /** 是否已选中。 */
    selected?: boolean;
}

/** 路线偏好查询对象响应。 */
export interface QueryRoutePreferencesObjectResponse extends ExtendableRecord {
    /** 偏好列表。 */
    list?: RoutePreferenceItem[];
    /** 兼容 data 列表。 */
    data?: RoutePreferenceItem[];
}

/** 路线偏好查询响应。 */
export type QueryRoutePreferencesResponse =
    | RoutePreferenceItem[]
    | QueryRoutePreferencesObjectResponse;

/** 路线偏好保存请求。 */
export interface SaveRoutePreferencePayload {
    /** 偏好编码。 */
    code: string;
}

/** 路况过期校验请求。 */
export interface RouteStaleCheckPayload {
    /** 快照 ID。 */
    snapshotId: OrderId;
    /** 路况指纹。 */
    pathFingerprint: string;
    /** 客户端快照时间戳。 */
    clientSnapshotMillis: NumericLike;
    /** 客户端展示的最终价格。 */
    clientFinalFare: NumericLike;
}

/** 路况过期校验响应。 */
export interface RouteStaleCheckResponse extends ExtendableRecord {
    /** 是否需要刷新提示。 */
    needRefreshNotice?: boolean;
}

/** 保存订单请求。 */
export interface SaveOrderPayload {
    /** 终点站点 ID。 */
    endPointId: OrderId;
    /** 开通城市 ID。 */
    openCityId: NumericLike;
    /** 上车地址文案。 */
    placementAddress: string;
    /** 上车纬度。 */
    placementLat: NumericLike;
    /** 上车经度。 */
    placementLon: NumericLike;
    /** 起点站点 ID。 */
    startPointId: OrderId;
    /** 围栏区域 ID。 */
    xpElectronicFenceAreaId: OrderId | '';
    /** 预估上车时间。 */
    estimatedTime: string;
    /** 选中的路线 ID。 */
    selectedRouteId?: OrderId;
    /** 导航快照 ID。 */
    navigationSnapshotId?: OrderId;
    /** 用户优惠券 ID。 */
    userCouponId?: OrderId | '';
}

/** 保存订单成功响应。 */
export interface SaveOrderSuccessResponse extends ExtendableRecord {
    /** 新订单 ID。 */
    orderId?: string;
}

/** 保存订单提示响应。 */
export interface SaveOrderMessageResponse extends ExtendableRecord {
    /** 新订单 ID。 */
    orderId?: string;
    /** 兼容 data 文案。 */
    data?: string;
    /** 提示文案。 */
    msg?: string;
}

/** 保存订单响应。 */
export type SaveOrderResponse =
    | SaveOrderSuccessResponse
    | SaveOrderMessageResponse
    | string;

/** 等待时间查询请求。 */
export interface GetWaitTimePayload {
    /** 起点纬度。 */
    latitude: NumericLike;
    /** 起点经度。 */
    longitude: NumericLike;
    /** 起点站点 ID。 */
    startPointId: OrderId | '';
}

/** 订单 ID 请求参数。 */
export interface OrderIdPayload {
    /** 订单 ID。 */
    orderId: OrderId;
}

/** 车辆信息查询响应。 */
export interface QueryVehicleByOrderIdResponse extends ExtendableRecord {
    /** 订单 ID。 */
    orderId?: OrderId;
}

/** 设置温度请求。 */
export interface SetTemperaturePayload {
    /** 订单 ID。 */
    orderId: OrderId;
    /** 目标温度。 */
    targetTemperature: NumericLike;
}

/** 设置温度响应。 */
export type SetTemperatureResponse = boolean | ApiEnvelope | null | undefined;

/** 解锁车辆请求。 */
export interface UnlockVehiclePayload {
    /** 订单 ID。 */
    orderId: OrderId;
    /** 操作目标。 */
    doorType: 'door' | 'trunk';
    /** 用户经度。 */
    longitude: NumericLike;
    /** 用户纬度。 */
    latitude: NumericLike;
}

/** 车辆解锁响应。 */
export type UnlockVehicleResponse = ApiEnvelope<unknown>;

/** 查询车辆温度响应。 */
export type QueryTemperatureByOrderIdResponse = NumericLike;

/** 查询车辆空调开关响应对象。 */
export interface QueryVehicleAirConditionerSwitchObjectResponse extends ExtendableRecord {
    /** 空调开启状态。 */
    open?: boolean | NumericLike;
    /** 兼容开启状态字段。 */
    isOpen?: boolean | NumericLike;
    /** 兼容开关状态字段。 */
    switchStatus?: boolean | NumericLike;
    /** 兼容空调开关字段。 */
    airConditionerSwitch?: boolean | NumericLike;
}

/** 查询车辆空调开关响应。 */
export type QueryVehicleAirConditionerSwitchResponse =
    | QueryVehicleAirConditionerSwitchObjectResponse
    | boolean
    | NumericLike;

/** 车辆空调开关控制请求。 */
export interface AirConditionerUnlockPayload {
    /** 订单 ID。 */
    orderId: OrderId;
    /** 是否开启空调。 */
    open: boolean;
}

/** 查询后备箱状态内层对象。 */
export interface QueryVehicleTrunkOpenStatusStateMapItem extends ExtendableRecord {
    /** 后备箱状态值。 */
    value?: NumericLike;
}

/** 查询后备箱状态响应对象。 */
export interface QueryVehicleTrunkOpenStatusObjectResponse extends ExtendableRecord {
    /** 兼容直接 data 值。 */
    data?: NumericLike;
    /** 兼容直接 value 值。 */
    value?: NumericLike;
    /** 兼容状态映射。 */
    stateMap?: {
        /** 后备箱状态。 */
        trunkAjarCloseSt?: QueryVehicleTrunkOpenStatusStateMapItem;
    };
}

/** 查询后备箱状态响应。 */
export type QueryVehicleTrunkOpenStatusResponse =
    | QueryVehicleTrunkOpenStatusObjectResponse
    | NumericLike;

/** 结束订单响应。 */
export type EndOrderResponse = boolean | ExtendableRecord | null | undefined;

/** 修改目的地请求。 */
export interface OrderChangePayload {
    /** 新终点站点 ID。 */
    endPointId: OrderId;
    /** 订单 ID。 */
    orderId: OrderId | '';
    /** 选中的路线 ID。 */
    selectedRouteId?: OrderId | '';
    /** 选中的路线规则。 */
    selectedRoutePlanRule?: NumericLike | '';
}

/** 费用明细查询请求。 */
export interface QueryFareBreakdownPayload {
    /** 订单 ID。 */
    orderId: string;
    /** 用户优惠券 ID。 */
    userCouponId?: string;
}

/** 费用明细响应。 */
export interface QueryFareBreakdownResponse extends ExtendableRecord {
    /** 当前生效优惠券 ID。 */
    userCouponId?: OrderId;
}

/** 评价提交请求。 */
export interface SubmitOrderCommentPayload {
    /** 评价星级。 */
    orderRating: number;
    /** 反馈类型 ID。 */
    feedbackTypeId?: number;
    /** 反馈文案。 */
    feedbackContent?: string;
    /** 反馈图片 JSON。 */
    feedbackPictures?: string;
    /** 订单 ID。 */
    orderId: OrderId;
}

/** 投诉提交请求。 */
export interface SubmitComplaintPayload {
    /** 评价星级。 */
    orderRating: number;
    /** 反馈类型 ID。 */
    feedbackTypeId?: number;
    /** 反馈文案。 */
    feedbackContent?: string;
    /** 反馈图片 JSON。 */
    feedbackPictures?: string;
    /** 订单 ID。 */
    orderId: OrderId;
}

/** 评价/投诉提交响应。 */
export interface SubmitFeedbackResponse extends ExtendableRecord {
    /** 是否成功。 */
    success?: boolean;
    /** 响应码。 */
    code?: number;
    /** 提示文案。 */
    msg?: string;
}

/** 评价类型项。 */
export interface OrderCommentTypeItem extends ExtendableRecord {
    /** 类型 ID。 */
    id?: number;
    /** 类型名称。 */
    feedbackType?: string;
}

/** 支付请求。 */
export interface GetOrderPaymentPayload {
    /** 订单 ID。 */
    orderId: OrderId;
}

/** 订单轨迹查询请求。 */
export interface QueryOrderRoutePayload {
    /** 订单 ID。 */
    orderId: string;
    /** 路线类型。 */
    routeType: number;
}

/** 订单路线摘要。 */
export interface OrderRouteMeta extends ExtendableRecord {
    /** 路线距离。 */
    distance?: NumericLike;
    /** 路线时长。 */
    duration?: NumericLike;
    /** 方向角。 */
    direction?: NumericLike;
    /** 行驶速度。 */
    speed?: NumericLike;
}

/** 订单轨迹响应 content。 */
export interface OrderRouteResponseContent extends ExtendableRecord {
    /** 行程状态。 */
    tripStatus?: NumericLike;
    /** 订单状态。 */
    orderStatus?: NumericLike;
    /** 状态值。 */
    status?: NumericLike;
    /** 点位集合。 */
    points?: RoutePolylinePoint[];
    /** 路线摘要。 */
    route?: OrderRouteMeta;
}

/** 订单轨迹响应。 */
export interface QueryOrderRouteResponse extends ExtendableRecord {
    /** 终点经度。 */
    endLongitude?: NumericLike;
    /** 终点纬度。 */
    endlatitude?: NumericLike;
    /** 折线点集合。 */
    polyline?: RoutePolylinePoint[];
    /** 路线距离。 */
    distance?: NumericLike;
    /** 路线时长。 */
    duration?: NumericLike;
    /** 行驶速度。 */
    speed?: NumericLike;
    /** 方向角。 */
    direction?: NumericLike;
    /** 行程状态。 */
    tripStatus?: NumericLike;
    /** 订单状态。 */
    orderStatus?: NumericLike;
    /** content 扩展数据。 */
    content?: OrderRouteResponseContent;
}

/** 排队状态请求。 */
export interface QueryOrderQueueStatusPayload {
    /** 订单 ID。 */
    orderId: OrderId;
}

/** 排队状态数据。 */
export interface OrderQueueStatusData extends ExtendableRecord {
    /** 当前排队位次。 */
    currentPosition?: NumericLike;
    /** 预计等待时长。 */
    estimatedWaitTime?: NumericLike;
    /** 排队状态。 */
    status?: NumericLike;
    /** 总排队人数。 */
    totalCount?: NumericLike;
}

/** 排队状态响应。 */
export type QueryOrderQueueStatusResponse =
    | OrderQueueStatusData
    | ApiEnvelope<OrderQueueStatusData>;

/** 分享订单信息请求。 */
export interface ShareQueryOrderInfoPayload {
    /** 订单 ID。 */
    orderId: OrderId;
}

/** 分享订单信息响应。 */
export interface ShareQueryOrderInfoResponse extends ExtendableRecord {
    /** 订单状态。 */
    status?: NumericLike;
    /** 起点名称。 */
    startPointName?: string;
    /** 终点名称。 */
    endPointName?: string;
    /** 起点纬度。 */
    startLat?: NumericLike;
    /** 起点经度。 */
    startLon?: NumericLike;
    /** 终点纬度。 */
    endLat?: NumericLike;
    /** 终点经度。 */
    endLon?: NumericLike;
    /** 车辆图片。 */
    vehiclePictures?: string;
    /** 兼容车辆图片字段。 */
    vehicleImage?: string;
    /** 上车时间。 */
    boardingTime?: string;
    /** 兼容上车时间字段。 */
    pickupTime?: string;
    /** 下车时间。 */
    getoffTime?: string;
    /** 完成时间。 */
    finishTime?: string;
    /** 订单结束时间。 */
    orderFinishTime?: string;
    /** 客服电话。 */
    customerServicePhone?: string;
    /** 兼容客服电话字段。 */
    servicePhone?: string;
}

/** 分享订单路线响应。 */
export interface ShareQueryOrderRouteResponse extends QueryOrderRouteResponse {
    /** 已服务点集合。 */
    servedPoints?: RoutePolylinePoint[];
    /** 车辆方向。 */
    vehicleDirection?: NumericLike;
    /** 路线对象。 */
    route?: OrderRouteMeta & {
        /** 路线点集合。 */
        polyline?: RoutePolylinePoint[];
    };
    /** 兼容 points 字段。 */
    points?: RoutePolylinePoint[];
}