REST Resource: providers.vehicles

{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}

string

Nur Ausgabe Der eindeutige Name für dieses Fahrzeug. Das Format dafür ist providers/{provider}/vehicles/{vehicle}.

enum (VehicleState)

Der Fahrzeugstatus.

enum (TripType)

Von diesem Fahrzeug unterstützte Fahrttypen.

string

Nur Ausgabe Liste der Fahrten in tripId für Fahrten, die diesem Fahrzeug derzeit zugewiesen sind.

object (VehicleLocation)

Letzter gemeldeter Standort des Fahrzeugs.

integer

Die Gesamtzahl der Fahrgäste, die dieses Fahrzeug befördern kann. Der Treiber wird bei diesem Wert nicht berücksichtigt. Dieser Wert muss größer oder gleich eins sein.

object (VehicleAttribute)

Liste der Fahrzeugattribute. Ein Fahrzeug kann maximal 100 Attribute haben, wobei jedes Attribut einen eindeutigen Schlüssel haben muss.

object (VehicleType)

Erforderlich. Der Typ dieses Fahrzeugs. Kann verwendet werden, um Fahrzeuge in vehicles.search-Ergebnissen zu filtern. Beeinflusst auch die voraussichtliche Ankunftszeit und die Routenberechnung.

object (LicensePlate)

Das Nummernschild des Fahrzeugs.

object (TerminalLocation)

Eingestellt: Verwende stattdessen Vehicle.waypoints.

string

Polylinie, die die Route angibt, die die Fahrer-App zum nächsten Wegpunkt zurücklegen möchte. Diese Liste wird in Trip.current_route_segment auch für alle aktiven Fahrten zurückgegeben, die dem Fahrzeug zugewiesen sind.

Hinweis: Dieses Feld ist nur für die Verwendung durch das Treiber-SDK vorgesehen. Die Decodierung wird noch nicht unterstützt.

object (TrafficPolylineData)

Nur Eingabe. Fleet Engine verwendet diese Informationen, um die Freigabe von Journeys zu verbessern. Hinweis: Dieses Feld ist nur für die Verwendung durch das Treiber-SDK vorgesehen.

string (Timestamp format)

Nur Ausgabe Uhrzeit, zu der currentRouteSegment festgelegt wurde. Sie kann vom Client gespeichert und in zukünftigen vehicles.get-Anfragen übergeben werden, um zu verhindern, dass Routen zurückgegeben werden, die sich nicht geändert haben.

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".

object (TripWaypoint)

Wegpunkt, an dem currentRouteSegment endet Diese kann von Fahrern bei vehicles.update-Aufrufen entweder als vollständiger Wegpunkt, als LatLng-Wegpunkt oder als letzten LatLng der currentRouteSegment angegeben werden. Fleet Engine versucht dann, einen tatsächlichen Wegpunkt zu interpolieren, falls dieser nicht vollständig angegeben ist. Dieses Feld wird in vehicles.update-Aufrufen ignoriert, es sei denn, currentRouteSegment ist ebenfalls angegeben.

integer

Die verbleibende Strecke mit dem Auto für den currentRouteSegment. Dieser Wert wird in Trip.remaining_distance_meters auch für alle aktiven Fahrten zurückgegeben, die dem Fahrzeug zugewiesen sind. Der Wert ist nicht angegeben, wenn das Feld currentRouteSegment leer ist.

string (Timestamp format)

Die voraussichtliche Ankunftszeit für den ersten Eintrag im Feld waypoints. Der Wert ist nicht angegeben, wenn das Feld waypoints oder Vehicle.current_route_segment leer ist.

Wenn ein Fahrzeug aktualisiert wird, hat remainingTimeSeconds Vorrang vor etaToFirstWaypoint in derselben Anfrage.

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".

integer

Nur Eingabe. Die verbleibende Fahrzeit für currentRouteSegment. Der Wert ist nicht angegeben, wenn das Feld waypoints oder Vehicle.current_route_segment leer ist. Dieser Wert sollte etaToFirstWaypoint–current_time entsprechen, wenn alle Parteien dieselbe Uhr verwenden.

Wenn ein Fahrzeug aktualisiert wird, hat remainingTimeSeconds Vorrang vor etaToFirstWaypoint in derselben Anfrage.

object (TripWaypoint)

Die verbleibenden Wegpunkte, die diesem Fahrzeug zugewiesen sind.

string (Timestamp format)

Nur Ausgabe Zeitpunkt der letzten Aktualisierung des Felds „waypoints“. Clients sollten diesen Wert im Cache speichern und in GetVehicleRequest übergeben, damit das Feld waypoints nur bei einer Aktualisierung zurückgegeben wird.

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".

boolean

Gibt an, ob der Fahrer mehrere Fahrten akzeptiert. Wenn true, kann vehicles.search das Fahrzeug einschließen, auch wenn es derzeit einer Fahrt zugewiesen ist. Der Standardwert ist false.

enum (NavigationStatus)

Der Navigationsstatus des Fahrzeugs.

object (DeviceSettings)

Nur Eingabe. Informationen zu Einstellungen auf dem Mobilgerät, das vom Fahrer verwendet wird.

{
  "key": string,
  "value": string,

  // Union field vehicle_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field vehicle_attribute_value.
}

string

Der Schlüssel des Attributs. Schlüssel dürfen keinen Doppelpunkt (:) enthalten.

string

Der Wert des Attributs.

string

Als String typisierter Attributwert.

Hinweis: Dies ist mit dem Feld value identisch, das letztendlich eingestellt wird. Bei Methoden zum Erstellen oder Aktualisieren können beide Felder verwendet werden. Es wird jedoch dringend empfohlen, stringValue zu verwenden. Wenn sowohl stringValue als auch value festgelegt sind, müssen die Werte identisch sein. Andernfalls wird ein Fehler ausgegeben. Beide Felder werden in den Antworten ausgefüllt.

boolean

Boolescher Attributwert.

number

Doppelt eingegebener Attributwert.

{
  "category": enum (Category)
}

enum (Category)

Fahrzeugtypkategorie

{
  "countryCode": string,
  "lastCharacter": string
}

string

Erforderlich. CLDR-Länder-/Regionscode. Beispiel: US für die USA oder IN für Indien.

string

Die letzte Ziffer des Kfz-Kennzeichens oder "-1", wenn das Nummernschild keinen numerischen Wert enthält.

• „ABC 1234“ -> „4“
• „AB 123 CD“ -> „3“
• „ABCDEF“ -> „-1“

{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}

object (VisualTrafficReportPolylineRendering)

Eine Polylinie, die die Geschwindigkeit des Verkehrs für alle Regionen entlang eines Abschnitts einer Fahrt durch einen Kunden anzeigt.

{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}

object (RoadStretch)

Optional. Straßenabschnitte, die entlang der Polylinie gerendert werden sollten. Streckenabschnitte sind garantiert, dass sie sich nicht überschneiden und nicht unbedingt die gesamte Route umfassen.

Falls kein Straßenabschnitt für den Stil vorhanden ist, sollte der Client den Standardwert für die Route anwenden.

{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}

enum (Style)

Erforderlich. Der Stil, der angewendet werden soll.

integer

Erforderlich. Der Stil sollte zwischen [offsetMeters, offsetMeters + lengthMeters) angewendet werden.

integer

Erforderlich. Die Länge des Pfads, auf den der Stil angewendet werden soll.

{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}

enum (LocationPowerSaveMode)

So verhalten sich die Standortfunktionen auf dem Gerät im Energiesparmodus.

boolean

Gibt an, ob sich das Gerät derzeit im Energiesparmodus befindet.

boolean

Gibt an, ob sich das Gerät im interaktiven Zustand befindet.

object (BatteryInfo)

Informationen zum Akkustatus.

{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}

enum (BatteryStatus)

Status des Akkus, u. a. vollständig aufgeladen oder geladen

enum (PowerSource)

Status der Akkustromquelle.

number

Aktueller Akkustand in Prozent [0–100].