REST Resource: providers.deliveryVehicles

{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}

string

Der eindeutige Name dieses Lieferfahrzeugs. Das Format dafür ist providers/{provider}/deliveryVehicles/{vehicle}.

object (DeliveryVehicleLocation)

Der zuletzt gemeldete Standort des Lieferfahrzeugs.

enum (DeliveryVehicleNavigationStatus)

Der Navigationsstatus des Lieferfahrzeugs.

string (bytes format)

Die codierte Polylinie, die die von der Navigation empfohlene Route zum nächsten Wegpunkt angibt. Diese wird von der Fahrer-App aktualisiert, wenn eine Haltestelle erreicht oder vorbeigeleitet wird oder wenn die Route neu berechnet wird. Diese LatLngs werden in Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) oder Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) für alle aktiven Aufgaben zurückgegeben, die dem Fahrzeug zugewiesen sind.

In einigen Fällen wird dieses Feld möglicherweise nicht zum Ausfüllen von Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) oder Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) verwendet:

• Der Endpunkt der currentRouteSegment stimmt nicht mit DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) oder DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST) überein.

• Die Standortinformationen der Fahrer App wurden vor Kurzem nicht aktualisiert. Daher ist der zuletzt aktualisierte Wert für dieses Feld möglicherweise veraltet.

• Die Fahrer App hat ihren Standort vor Kurzem aktualisiert, aber die currentRouteSegment ist veraltet und verweist auf eine vorherige Fahrzeughaltestelle.

In diesen Fällen füllt die Fleet Engine dieses Feld mit einem Routenabschnitt vom zuletzt passierten zu dem nächsten Fahrzeugstopp aus, damit der Nutzer dieses Felds die bestmöglichen Informationen zum aktuellen Pfad des Lieferfahrzeugs hat.

Ein base64-codierter String.

object (LatLng)

Der Ort, an dem die currentRouteSegment endet. Dieser Wert wird derzeit nicht von der Fahrer App erfasst. Sie können ihn aber bei deliveryVehicles.patch-Anrufen angeben. Das ist entweder die LatLng der nächsten Haltestelle oder die letzte LatLng der currentRouteSegment. Die Fleet Engine versucht dann, eine tatsächliche VehicleStop zu interpolieren.

Dieses Feld wird bei deliveryVehicles.patch-Aufrufen ignoriert, wenn das Feld currentRouteSegment leer ist.

integer

Die verbleibende Fahrstrecke für den currentRouteSegment. Dieses Feld wird in der Regel in der Treiber-App bereitgestellt. Unter bestimmten Umständen überschreibt Fleet Engine den von der App gesendeten Wert jedoch. Weitere Informationen finden Sie unter DeliveryVehicle.current_route_segment. Dieses Feld wird in Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) oder Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) für alle aktiven Tasks zurückgegeben, die dem Lieferfahrzeug zugewiesen sind.

Fleet Engine ignoriert dieses Feld in UpdateDeliveryVehicleRequest, wenn das Feld currentRouteSegment leer ist.

string (Duration format)

Die verbleibende Fahrtdauer für die currentRouteSegment. Dieses Feld wird normalerweise von der Fahrer App bereitgestellt. Es gibt jedoch einige Fälle, in denen Fleet Engine den von der App gesendeten Wert überschreibt. Weitere Informationen finden Sie unter DeliveryVehicle.current_route_segment. Dieses Feld wird in Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) oder Task.remainingVehicleJourneySegments[0].drivingDuration (REST) für alle aktiven Aufgaben zurückgegeben, die dem Lieferfahrzeug zugewiesen sind.

Fleet Engine ignoriert dieses Feld in UpdateDeliveryVehicleRequest, wenn das Feld currentRouteSegment leer ist.

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

object (VehicleJourneySegment)

Die diesem Lieferfahrzeug zugewiesenen Fahrtabschnitte, beginnend mit dem zuletzt gemeldeten Standort des Fahrzeugs. Dieses Feld wird in der Antwort von deliveryVehicles.list nicht ausgefüllt.

object (DeliveryVehicleAttribute)

Eine Liste benutzerdefinierter Attribute für Lieferfahrzeuge. Ein Übermittlungsmedium kann maximal 100 Attribute haben und jedes Attribut muss einen eindeutigen Schlüssel haben.

enum (DeliveryVehicleType)

Der Typ dieses Lieferfahrzeugs. Wenn nicht festgelegt, wird standardmäßig AUTO verwendet.

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

  // Union field delivery_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
  // delivery_vehicle_attribute_value.
}

string

Der Schlüssel des Attributs.

string

Der Wert des Attributs.

string

Attributwert vom Typ „String“.

Hinweis: Dies ist identisch mit dem Feld value, das irgendwann eingestellt wird. Für Methoden zum Erstellen oder Aktualisieren kann jedes der beiden Felder verwendet werden. Wir empfehlen jedoch dringend, stringValue zu verwenden. Wenn sowohl stringValue als auch value festgelegt sind, müssen sie identisch sein, da sonst ein Fehler auftritt. Beide Felder werden in Antworten ausgefüllt.

boolean

Boolescher Attributwert.

number

Attributwert mit doppeltem Typ.