Method: providers.trips.search

Sie können alle Fahrten für ein bestimmtes Fahrzeug abrufen.

HTTP-Anfrage

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips:search

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Muss das Format providers/{provider} haben. Der Anbieter muss die Projekt-ID des Google Cloud-Projekts sein, zu dem das Dienstkonto gehört, das diesen Aufruf durchführt, z. B. sample-cloud-project.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
Felder
header

object (RequestHeader)

Der standardmäßige Fleet Engine-Anfrageheader.
vehicleId

string

Das Fahrzeug, das mit den Fahrten in der Anfrage verknüpft ist. Wenn keine Angabe erfolgt, enthalten die zurückgegebenen Fahrten Folgendes nicht:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Wenn die Richtlinie auf „true“ gesetzt ist, enthält die Antwort „Trips“, die die Route eines Fahrers beeinflussen.
pageSize

integer

Wenn die Richtlinie nicht konfiguriert ist, entscheidet der Server über die Anzahl der zurückzugebenden Ergebnisse.
pageToken

string

Legen Sie diesen Wert auf einen Wert fest, der zuvor in SearchTripsResponse zurückgegeben wurde, um mit den vorherigen Ergebnissen fortzufahren.
minimumStaleness

string (Duration format)

Falls angegeben, werden die Fahrten zurückgegeben, die nach dem (current - minimumStaleness) nicht aktualisiert wurden.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".

Antworttext

trip.search-Antwortnachricht gesendet wurde.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
Felder
trips[]

object (Trip)

Die Liste der Fahrten für das angeforderte Fahrzeug.
nextPageToken

string

Übergeben Sie dieses Token in SearchTripsRequest, um die Ergebnisliste durchzugehen. Die API gibt bei jedem Aufruf eine Fahrtenliste zurück. Wenn keine weiteren Ergebnisse vorhanden sind, ist die Fahrtenliste leer.