SearchVehiclesResponse

vehicles.search-Antwortnachricht.

JSON-Darstellung
{
  "matches": [
    {
      object (VehicleMatch)
    }
  ]
}
Felder
matches[]

object (VehicleMatch)

Liste der Fahrzeuge, die den SearchVehiclesRequest-Kriterien entsprechen, sortiert nach dem Feld SearchVehiclesRequest.order_by.

VehicleMatch

Enthält das Fahrzeug und zugehörige Schätzungen für ein Fahrzeug, die den Punkten aktiver Fahrten für das Fahrzeug SearchVehiclesRequest entsprechen.

JSON-Darstellung
{
  "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)
}
Felder
vehicle

object (Vehicle)

Erforderlich. Ein Fahrzeug, das der Anfrage entspricht.

vehiclePickupEta

string (Timestamp format)

Die voraussichtliche Ankunftszeit des Fahrzeugs zum Abholpunkt, der in der Anfrage angegeben ist. Ein leerer Wert bedeutet, dass die voraussichtliche Ankunftszeit für das Fahrzeug nicht berechnet werden konnte. Wenn „SearchVehiclesRequest.include_back_to_back“ auf „true“ gesetzt war und für dieses Fahrzeug eine Fahrt aktiv ist, enthält vehiclePickupEta die Zeit, die für die aktuelle aktive Fahrt erforderlich ist.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

vehiclePickupDistanceMeters

integer

Die Entfernung vom aktuellen Standort des Fahrzeugs bis zu dem in der Anfrage angegebenen Abholpunkt, einschließlich aller Zwischen- oder Absetzpunkte für bestehende Fahrten. Sie setzt sich aus der berechneten Fahrstrecke (Routen-Entfernung) plus der Luftlinie zwischen dem Navigationsendpunkt und dem angeforderten Abholpunkt zusammen. (Die Entfernung zwischen dem Navigationsendpunkt und dem gewünschten Abholpunkt ist in der Regel gering.) Ein leerer Wert weist auf einen Fehler bei der Berechnung der Entfernung hin.

vehiclePickupStraightLineDistanceMeters

integer

Erforderlich. Die Luftlinie zwischen dem Fahrzeug und dem in der Anfrage angegebenen Abholpunkt.

vehicleDropoffEta

string (Timestamp format)

Die voraussichtliche Ankunftszeit des gesamten Fahrzeugs an der in der Anfrage angegebenen Abgabestelle. Die voraussichtliche Ankunftszeit beinhaltet auch einen Halt an jedem Wegpunkt vor dem in der Anfrage angegebenen dropoffPoint. Der Wert wird nur gefüllt, wenn in der Anfrage ein Rückgabepunkt angegeben ist. Ein leerer Wert weist auf einen Fehler bei der Berechnung der voraussichtlichen Ankunftszeit hin.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

vehiclePickupToDropoffDistanceMeters

integer

Die Fahrstrecke des Fahrzeugs (in Metern) vom Abholpunkt bis zu dem in der Anfrage angegebenen Rückgabepunkt. Die Entfernung liegt nur zwischen den beiden Punkten und umfasst weder den Fahrzeugstandort noch andere Punkte, die besichtigt werden müssen, bevor das Fahrzeug den Abhol- oder Absetzpunkt besucht. Der Wert wird nur gefüllt, wenn in der Anfrage ein dropoffPoint angegeben ist. Ein leerer Wert bedeutet, dass die in der Anfrage angegebene Entfernung zwischen dem Abhol- und dem Rückgabepunkt nicht berechnet werden konnte.

tripType

enum (TripType)

Erforderlich. Der Fahrttyp der Anfrage, der zur Berechnung der voraussichtlichen Ankunftszeit bis zum Abholpunkt verwendet wurde.

vehicleTripsWaypoints[]

object (Waypoint)

Die sortierte Liste der Wegpunkte, die zur Berechnung der voraussichtliche Ankunftszeit verwendet werden. Die Liste enthält den Fahrzeugstandort, die Abholpunkte der aktiven Fahrten für das Fahrzeug und die in der Anfrage angegebenen Abholpunkte. Eine leere Liste weist auf einen Fehler bei der Berechnung der voraussichtlichen Ankunftszeit für das Fahrzeug hin.

vehicleMatchType

enum (VehicleMatchType)

Typ des übereinstimmenden Fahrzeugs.

requestedOrderedBy

enum (VehicleMatchOrder)

Die Reihenfolge, in der die Fahrzeugübereinstimmungen sortiert werden.

orderedBy

enum (VehicleMatchOrder)

Die tatsächliche Bestellung, die für dieses Fahrzeug verwendet wurde. Normalerweise entspricht dies dem Feld "orderBy" aus der Anfrage. Unter bestimmten Umständen, etwa bei einem internen Serverfehler, kann jedoch eine andere Methode verwendet werden (z. B. PICKUP_POINT_STRAIGHT_DISTANCE).

Zwischenstopp

Beschreibt Zwischenpunkte entlang einer Route für einen VehicleMatch in einem SearchVehiclesResponse. Dieses Konzept wird in allen anderen Endpunkten als TripWaypoint dargestellt.

JSON-Darstellung
{
  "latLng": {
    object (LatLng)
  },
  "eta": string
}
Felder
latLng

object (LatLng)

Die Position dieses Wegpunkts

eta

string (Timestamp format)

Die voraussichtliche Ankunftszeit des Fahrzeugs an diesem Wegpunkt.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

VehicleMatchType

Übereinstimmender Fahrzeugtyp.

Enums
UNKNOWN Unbekannter Übereinstimmungstyp des Fahrzeugs
EXCLUSIVE Dem Fahrzeug ist derzeit keine Fahrt zugewiesen und es kann zum Abholpunkt fahren.
BACK_TO_BACK Das Fahrzeug ist derzeit einer Fahrt zugewiesen, kann aber nach Abschluss der laufenden Fahrt zum Abholpunkt fahren. Bei der Berechnung der voraussichtliche Ankunftszeit und der Entfernung wird die vorhandene Fahrt berücksichtigt.
CARPOOL Das Fahrzeug hat genügend Kapazität für eine gemeinsame Fahrt.
CARPOOL_BACK_TO_BACK Das Fahrzeug beendet seine aktuelle, aktive Fahrt, bevor es zum Abholpunkt auffährt. Bei der Berechnung der voraussichtliche Ankunftszeit und der Entfernung wird die vorhandene Fahrt berücksichtigt.