Method: providers.trips.search

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 im Format providers/{provider} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

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 keine Angabe gemacht wird, 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 nicht festgelegt, entscheidet der Server, wie viele Ergebnisse zurückgegeben werden.

pageToken

string

Legen Sie diesen Wert auf einen Wert fest, der zuvor im SearchTripsResponse zurückgegeben wurde, um mit 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

Antwortnachricht für „trips.search“

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