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, das diesen Aufruf durchführt, gehört (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 den Fahrten in der Anfrage zugeordnet ist. Wenn nicht angegeben, enthalten die zurückgegebenen Fahrten Folgendes nicht:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Wenn dieser Wert 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, wie viele Ergebnisse zurückgegeben werden sollen.
pageToken

string

Legen Sie hier einen Wert fest, der zuvor in SearchTripsResponse zurückgegeben wurde, um gegenüber den vorherigen Ergebnissen fortzufahren.
minimumStaleness

string (Duration format)

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

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

Antworttext

trip.search-Antwortnachricht.

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 der SearchTripsRequest, um durch die Ergebnislisten zu blättern. Die API gibt bei jedem Aufruf eine Fahrtliste zurück. Wenn keine weiteren Ergebnisse verfügbar sind, ist die Fahrtliste leer.