REST Resource: providers.vehicles

Ressource: Fahrzeug

Fahrzeugmetadaten

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

string

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

vehicleState

enum (VehicleState)

Der Fahrzeugstatus.

supportedTripTypes[]

enum (TripType)

Fahrttypen, die von diesem Fahrzeug unterstützt werden.

currentTrips[]

string

Nur Ausgabe. Liste von tripId für Fahrten, die diesem Fahrzeug aktuell zugewiesen sind.

lastLocation

object (VehicleLocation)

Letzter gemeldeter Standort des Fahrzeugs.

maximumCapacity

integer

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

attributes[]

object (VehicleAttribute)

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

vehicleType

object (VehicleType)

Erforderlich. Der Typ dieses Fahrzeugs. Kann zum Filtern von Fahrzeugen in vehicles.search-Ergebnissen verwendet werden. Beeinflusst außerdem die voraussichtliche Ankunftszeit und die Routenberechnung.

licensePlate

object (LicensePlate)

Informationen zum Kfz-Kennzeichen des Fahrzeugs.

route[]
(deprecated)

object (TerminalLocation)

Verworfen. Verwenden Sie stattdessen Vehicle.waypoints.

currentRouteSegment

string

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

Hinweis: Dieses Feld ist nur für das Driver SDK vorgesehen. Das Dekodieren wird noch nicht unterstützt.

currentRouteSegmentTraffic

object (TrafficPolylineData)

Nur Eingabe. Fleet Engine nutzt diese Informationen, um das Teilen von Fahrten zu verbessern. Hinweis: Dieses Feld ist nur für die Verwendung vom Treiber-SDK vorgesehen.

currentRouteSegmentVersion

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem 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 einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

currentRouteSegmentEndPoint

object (TripWaypoint)

Der Wegpunkt, an dem currentRouteSegment endet. Sie kann von Fahrern bei vehicles.update-Aufrufen entweder als vollständiger Wegpunkt, als Wegpunkt LatLng oder als letztes LatLng der currentRouteSegment angegeben werden. Die Fleet Engine versucht dann, einen tatsächlichen Wegpunkt zu interpolieren, wenn dieser nicht vollständig angegeben ist. Dieses Feld wird in vehicles.update-Aufrufen ignoriert, sofern nicht auch currentRouteSegment angegeben ist.

remainingDistanceMeters

integer

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

etaToFirstWaypoint

string (Timestamp format)

Die geschätzte Zeit bis zum ersten Eintrag im Feld waypoints. Der Wert ist nicht angegeben, wenn das Feld waypoints oder das Feld Vehicle.current_route_segment leer ist.

Bei der Aktualisierung eines Fahrzeugs hat remainingTimeSeconds in derselben Anfrage Vorrang vor etaToFirstWaypoint.

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

remainingTimeSeconds

integer

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

Beim Aktualisieren eines Fahrzeugs hat remainingTimeSeconds in derselben Anfrage Vorrang vor etaToFirstWaypoint.

waypoints[]

object (TripWaypoint)

Die verbleibenden Wegpunkte, die diesem Fahrzeug zugewiesen sind.

waypointsVersion

string (Timestamp format)

Nur Ausgabe. Zeitpunkt der letzten Aktualisierung des Felds waypoints. Clients sollten diesen Wert im Cache speichern und in GetVehicleRequest übergeben, um sicherzustellen, dass das Feld waypoints nur zurückgegeben wird, wenn es aktualisiert wird.

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

backToBackEnabled

boolean

Gibt an, ob der Fahrer Fahrten nacheinander annimmt. Wenn true, vehicles.search das Fahrzeug auch dann enthalten kann, wenn es derzeit einer Fahrt zugewiesen ist. Der Standardwert ist false.

navigationStatus

enum (NavigationStatus)

Der Navigationsstatus des Fahrzeugs.

deviceSettings

object (DeviceSettings)

Nur Eingabe. Informationen zu den Einstellungen des Mobilgeräts, das der Fahrer verwendet.

VehicleState

Der Status einer Vehicle.

Enums
UNKNOWN_VEHICLE_STATE Standardwert, wird für nicht angegebene oder nicht erkannte Fahrzeugstatus verwendet.
OFFLINE Das Fahrzeug akzeptiert keine neuen Fahrten. Hinweis: Das Fahrzeug kann in diesem Status weiterhin betrieben werden, während eine ihm zugewiesene Fahrt abgeschlossen wird.
ONLINE Das Fahrzeug nimmt neue Fahrten an.

VehicleAttribute

Beschreibt ein Fahrzeugattribut als Schlüssel/Wert-Paar. Der String „key:value“ darf 256 Zeichen nicht überschreiten.

JSON-Darstellung
{
  "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.
}
Felder
key

string

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

value

string

Der Wert des Attributs.

Union-Feld vehicle_attribute_value. Der Wert des Attributs kann vom Typ „String“, „Boole“ oder „Doppelt“ sein. Für vehicle_attribute_value ist nur einer der folgenden Werte zulässig:
stringValue

string

Als String eingegebener Attributwert.

Hinweis: Dieses Feld entspricht dem Feld value, das demnächst eingestellt wird. Für die Erstellungs- oder Aktualisierungsmethode können beide Felder verwendet werden, die Verwendung von stringValue wird jedoch dringend empfohlen. Wenn sowohl stringValue als auch value festgelegt sind, müssen sie identisch sein. Andernfalls wird ein Fehler ausgegeben. Beide Felder werden in den Antworten ausgefüllt.

boolValue

boolean

Boolescher Attributwert

numberValue

number

Attributwert mit doppeltem Typ.

Fahrzeugtyp

Der Fahrzeugtyp.

JSON-Darstellung
{
  "category": enum (Category)
}
Felder
category

enum (Category)

Kategorie des Fahrzeugtyps

Kategorie

Fahrzeugtypkategorien

Enums
UNKNOWN Standardwert, der für nicht angegebene oder nicht erkannte Fahrzeugkategorien verwendet wird.
AUTO Ein Auto.
TAXI Alle Fahrzeuge, die als Taxi dienen (in der Regel lizenziert oder reguliert).
TRUCK In der Regel ein Fahrzeug mit einer großen Speicherkapazität.
TWO_WHEELER Ein Motorrad, Moped oder ein anderes Fahrzeug mit zwei Rädern
BICYCLE Von Menschen betriebene Transportmittel
PEDESTRIAN Personen, die in der Regel gehen oder laufen und Fußgängerwege entlangfahren.

LicensePlate

Das Kfz-Kennzeichen des Fahrzeugs. Damit keine personenidentifizierbaren Informationen gespeichert werden, werden nur die Mindestinformationen zum Kfz-Kennzeichen als Teil des Rechtssubjekts gespeichert.

JSON-Darstellung
{
  "countryCode": string,
  "lastCharacter": string
}
Felder
countryCode

string

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

lastCharacter

string

Die letzte Ziffer des Kfz-Kennzeichens oder „-1“, wenn das Kfz-Kennzeichen keinen numerischen Wert enthält.

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

TrafficPolylineData

Verkehrslage entlang der voraussichtlichen Fahrzeugroute

JSON-Darstellung
{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}
Felder
trafficRendering

object (VisualTrafficReportPolylineRendering)

Ein Polylinien-Rendering der Verkehrsgeschwindigkeit für alle Regionen entlang eines Streckenabschnitts einer Fahrt.

VisualTrafficReportPolylineRendering

Beschreibt, wie Clients einen Teil der Polylinie entlang der Route färben sollten.

JSON-Darstellung
{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}
Felder
roadStretch[]

object (RoadStretch)

Optional. Straßenabschnitte, die entlang der Polylinie gerendert werden sollen. Streckenabschnitte überschneiden sich garantiert nicht und decken nicht unbedingt die gesamte Route ab.

Wenn keine Straßenstrecke zu gestalten ist, sollte der Kunde den Standard für die Route anwenden.

RoadStretch

Eine Straßenstrecke, die gerendert werden soll.

JSON-Darstellung
{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}
Felder
style

enum (Style)

Erforderlich. Der Stil, der angewendet werden soll.

offsetMeters

integer

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

lengthMeters

integer

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

Stil

Der Verkehrsstil, der die Verkehrsgeschwindigkeit angibt.

Enums
STYLE_UNSPECIFIED Kein Stil ausgewählt.
SLOWER_TRAFFIC Der Traffic verlangsamt sich.
TRAFFIC_JAM Es gibt einen Stau.

DeviceSettings

Informationen zu verschiedenen Einstellungen auf dem Mobilgerät.

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

enum (LocationPowerSaveMode)

Gibt an, wie sich die Standortfunktionen auf dem Gerät verhalten, wenn der Energiesparmodus aktiviert ist.

isPowerSaveMode

boolean

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

isInteractive

boolean

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

batteryInfo

object (BatteryInfo)

Informationen zum Akkustatus.

LocationPowerSaveMode

Legt fest, wie Standortfunktionen so konfiguriert sind, dass sie sich auf dem Mobilgerät verhalten, wenn der Energiesparmodus aktiviert ist. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enums
UNKNOWN_LOCATION_POWER_SAVE_MODE Nicht definierter StandortEnergiesparmodus
LOCATION_MODE_NO_CHANGE Entweder sollten Standortanbieter vom Energiesparmodus nicht betroffen sein oder er ist deaktiviert.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Der GPS-basierte Standortanbieter sollte deaktiviert werden, wenn der Energiesparmodus aktiviert ist und das Gerät nicht interaktiv ist.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Alle Standortanbieter sollten deaktiviert werden, wenn der Energiesparmodus aktiviert ist und das Gerät nicht interaktiv ist.
LOCATION_MODE_FOREGROUND_ONLY Alle Standortanbieter bleiben verfügbar, aber Standortkorrekturen sollten nur für Apps im Vordergrund bereitgestellt werden.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Die Standortermittlung wird nicht deaktiviert, aber LocationManager drosselt alle Anfragen an Anbieter, wenn das Gerät nicht interaktiv ist.

BatteryInfo

Informationen zum Akku des Geräts.

JSON-Darstellung
{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}
Felder
batteryStatus

enum (BatteryStatus)

Status des Akkus, z. B. ob er voll oder aufgeladen wird

powerSource

enum (PowerSource)

Status der Akkustromquelle.

batteryPercentage

number

Aktueller Akkustand in Prozent [0–100]

BatteryStatus

Status des Akkus, z. B. ob er voll oder aufgeladen wird

Enums
UNKNOWN_BATTERY_STATUS Akkustand unbekannt.
BATTERY_STATUS_CHARGING Der Akku wird geladen.
BATTERY_STATUS_DISCHARGING Der Akku wird entladen.
BATTERY_STATUS_FULL Akku ist vollständig geladen.
BATTERY_STATUS_NOT_CHARGING Akku wird nicht geladen.
BATTERY_STATUS_POWER_LOW Der Akkustand ist niedrig.

PowerSource

Typ des Ladegeräts, das zum Laden des Akkus verwendet wird.

Enums
UNKNOWN_POWER_SOURCE Die Stromquelle ist unbekannt.
POWER_SOURCE_AC Die Stromquelle ist ein Wechselstrom-Ladegerät.
POWER_SOURCE_USB Die Stromquelle ist ein USB-Anschluss.
POWER_SOURCE_WIRELESS Die Stromversorgung ist kabellos.
POWER_SOURCE_UNPLUGGED Akku ist ausgesteckt.

Methoden

create

Instanziiert ein neues Fahrzeug, das mit einem On-Demand-Mitfahrdienst oder Lieferdienst verknüpft ist.

get

Gibt ein Fahrzeug von der Fleet Engine zurück.

list

Gibt eine paginierte Liste von Fahrzeugen zurück, die einem Anbieter zugeordnet sind und den Anfrageoptionen entsprechen.
Gibt eine Liste der Fahrzeuge zurück, die den Anfrageoptionen entsprechen.

update

Schreibt aktualisierte Fahrzeugdaten in die Fleet Engine.

updateAttributes

Aktualisiert teilweise Attribute des Fahrzeugs.