SearchVehiclesResponse

vehicles.search messaggio di risposta.

Rappresentazione JSON
{
  "matches": [
    {
      object (VehicleMatch)
    }
  ]
}
Campi
matches[]

object (VehicleMatch)

Elenco di veicoli che soddisfano i criteri SearchVehiclesRequest, ordinati in base al campo SearchVehiclesRequest.order_by.

VehicleMatch

Contiene il veicolo e le stime correlate per un veicolo che corrispondono ai punti delle corse attive per il veicolo SearchVehiclesRequest.

Rappresentazione JSON
{
  "vehicle": {
    object (Vehicle)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripType),
  "vehicleTripsWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "vehicleMatchType": enum (VehicleMatchType),
  "requestedOrderedBy": enum (VehicleMatchOrder),
  "orderedBy": enum (VehicleMatchOrder)
}
Campi
vehicle

object (Vehicle)

Obbligatorio. Un veicolo che soddisfa la richiesta.

vehiclePickupEta

string (Timestamp format)

L'orario di arrivo stimato del veicolo fino al punto di prelievo specificato nella richiesta. Un valore vuoto indica un errore nel calcolo dell'orario di arrivo stimato per il veicolo. Se SearchVehiclesRequest.include_back_to_back era true e questo veicolo ha una corsa attiva, vehiclePickupEta include il tempo necessario per completare la corsa attiva attuale.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

vehiclePickupDistanceMeters

integer

La distanza dalla posizione attuale del veicolo al punto di prelievo specificato nella richiesta, inclusi eventuali punti di prelievo o di discesa intermedi per le corse esistenti. Questa distanza comprende la distanza calcolata in auto (percorso) e la distanza in linea retta tra il punto di arrivo della navigazione e il punto di prelievo richiesto. (La distanza tra il punto di arrivo della navigazione e il punto di prelievo richiesto è in genere ridotta.) Un valore vuoto indica un errore nel calcolo della distanza.

vehiclePickupStraightLineDistanceMeters

integer

Obbligatorio. La distanza in linea retta tra il veicolo e il punto di prelievo specificato nella richiesta.

vehicleDropoffEta

string (Timestamp format)

L'orario di arrivo stimato di guida del veicolo completo fino al punto di consegna specificato nella richiesta. L'orario di arrivo stimato include la sosta in qualsiasi waypoint prima del giorno dropoffPoint specificato nella richiesta. Il valore verrà compilato solo quando nella richiesta viene specificato un punto di consegna. Un valore vuoto indica un errore nel calcolo dell'orario di arrivo stimato.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

vehiclePickupToDropoffDistanceMeters

integer

La distanza percorsa dal veicolo (in metri) dal punto di prelievo al punto di consegna specificato nella richiesta. La distanza è solo tra i due punti e non include la posizione del veicolo o altri punti che devono essere visitati prima che il veicolo visiti il punto di prelievo o di discesa. Il valore verrà compilato solo quando nella richiesta viene specificato un dropoffPoint. Un valore vuoto indica un errore nel calcolo della distanza dal punto di prelievo al punto di partenza specificato nella richiesta.

tripType

enum (TripType)

Obbligatorio. Il tipo di corsa della richiesta utilizzata per calcolare l'orario di arrivo stimato al punto di prelievo.

vehicleTripsWaypoints[]

object (Waypoint)

L'elenco ordinato di waypoint utilizzati per calcolare l'orario di arrivo stimato. L'elenco include la posizione del veicolo, i punti di prelievo delle corse attive per il veicolo e i punti di prelievo forniti nella richiesta. Un elenco vuoto indica un errore nel calcolo dell'orario di arrivo stimato per il veicolo.

vehicleMatchType

enum (VehicleMatchType)

Tipo di corrispondenza del veicolo.

requestedOrderedBy

enum (VehicleMatchOrder)

L'ordine richiesto per ordinare le corrispondenze dei veicoli.

orderedBy

enum (VehicleMatchOrder)

L'ordine effettivo utilizzato per questo veicolo. Normalmente corrisponde al campo "orderBy" della richiesta; tuttavia, in determinate circostanze, ad esempio in un errore interno del server, è possibile utilizzare un metodo diverso (ad esempio PICKUP_POINT_STRAIGHT_DISTANCE).

Waypoint

Descrive i punti intermedi lungo un percorso per un VehicleMatch in un SearchVehiclesResponse. Questo concetto è rappresentato come TripWaypoint in tutti gli altri endpoint.

Rappresentazione JSON
{
  "latLng": {
    object (LatLng)
  },
  "eta": string
}
Campi
latLng

object (LatLng)

La posizione di questo waypoint.

eta

string (Timestamp format)

L'ora stimata di arrivo del veicolo a questo waypoint.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

VehicleMatchType

Tipo di corrispondenza del veicolo.

Enum
UNKNOWN Tipo di corrispondenza veicolo sconosciuto
EXCLUSIVE Al momento non è stato assegnato alcun percorso al veicolo, pertanto puoi procedere fino al punto di prelievo.
BACK_TO_BACK Il veicolo è attualmente assegnato a una corsa, ma può procedere al punto di ritiro una volta completata la corsa in corso. I calcoli dell'orario di arrivo stimato e della distanza tengono conto della corsa esistente.
CARPOOL Il veicolo ha una capacità sufficiente per un giro condiviso.
CARPOOL_BACK_TO_BACK Il veicolo completerà la corsa attuale e attiva prima di raggiungere il punto di prelievo. I calcoli dell'orario di arrivo stimato e della distanza tengono conto della corsa esistente.