REST Resource: providers.deliveryVehicles

Ressource: DeliveryVehicle

Die DeliveryVehicle-Nachricht. Ein Lieferfahrzeug befördert Lieferungen von einem Depot zu einem Lieferort und von einem Abholort zum Depot. In einigen Fällen transportieren Lieferfahrzeuge Sendungen auch direkt vom Abholort zum Lieferort.

Hinweis: gRPC und REST APIs verwenden unterschiedliche Namenskonventionen für Felder. Das Feld DeliveryVehicle.current_route_segment in der gRPC API und das Feld DeliveryVehicle.currentRouteSegment in der REST API verweisen beispielsweise auf dasselbe Feld.

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

string

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

lastLocation

object (DeliveryVehicleLocation)

Der letzte gemeldete Standort des Lieferfahrzeugs.

navigationStatus

enum (DeliveryVehicleNavigationStatus)

Der Navigationsstatus des Lieferfahrzeugs.

currentRouteSegment

string (bytes format)

Die codierte Polylinie, die die Route angibt, die die Navigation zum nächsten Wegpunkt empfiehlt. Ihre Fahrer App aktualisiert diesen Wert, wenn eine Haltestelle erreicht oder passiert wird und wenn die Navigation eine neue Route berechnet. 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 Fahrer App hat ihren Standort in letzter Zeit 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 Fleet Engine dieses Feld mit einer Route von der zuletzt übergebenen VehicleStop zur nächsten VehicleStop, um sicherzustellen, dass dem Nutzer dieses Felds die besten verfügbaren Informationen zum aktuellen Pfad des Lieferfahrzeugs zur Verfügung stehen.

Ein base64-codierter String.

currentRouteSegmentEndPoint

object (LatLng)

Der Ort, an dem die currentRouteSegment endet. Diese wird derzeit nicht von der Treiber-App ausgefüllt, du kannst sie jedoch bei deliveryVehicles.patch-Aufrufen angeben. Es ist entweder die LatLng der nächsten Haltestellen des Fahrzeugs 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.

remainingDistanceMeters

integer

Die verbleibende Fahrstrecke für den 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_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.

remainingDuration

string (Duration format)

Die verbleibende Fahrzeit für currentRouteSegment. Dieses Feld wird normalerweise von der Fahrer App bereitgestellt. Es gibt jedoch einige Fälle, in denen die 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 Übermittlungsmedium zugewiesen sind.

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

remainingVehicleJourneySegments[]

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.

attributes[]

object (DeliveryVehicleAttribute)

Eine Liste benutzerdefinierter Lieferfahrzeugattribute. Ein Lieferfahrzeug kann maximal 100 Attribute haben, wobei jedes Attribut einen eindeutigen Schlüssel haben muss.

type

enum (DeliveryVehicleType)

Der Typ dieses Lieferfahrzeugs. Wenn kein Wert festgelegt ist, wird standardmäßig AUTO verwendet.

DeliveryVehicleNavigationStatus

Der Navigationsstatus des Fahrzeugs.

Enums
UNKNOWN_NAVIGATION_STATUS Unbekannter Navigationsstatus.
NO_GUIDANCE Die Navigation in der Fahrer-App ist im FREE_NAV-Modus.
ENROUTE_TO_DESTINATION Die Schritt-für-Schritt-Navigation ist verfügbar und die Navigation in der Fahrer-App befindet sich im GUIDED_NAV-Modus.
OFF_ROUTE Das Fahrzeug ist von der vorgeschlagenen Route abgekommen.
ARRIVED_AT_DESTINATION Das Fahrzeug ist nicht weiter als 50 m vom Ziel entfernt.

DeliveryVehicleAttribute

Beschreibt ein Fahrzeugattribut als Schlüssel/Wert-Paar. Die Länge des Strings „Schlüssel:Wert“ darf 256 Zeichen nicht überschreiten.

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

string

Der Schlüssel des Attributs.

value

string

Der Wert des Attributs.

Union-Feld delivery_vehicle_attribute_value. Der Wert des Attributs kann als String, boolescher oder Double-Wert angegeben werden. Für delivery_vehicle_attribute_value ist nur einer der folgenden Werte zulässig:
stringValue

string

Als String eingegebener Attributwert.

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 den Antworten ausgefüllt.

boolValue

boolean

Boolescher Attributwert.

numberValue

number

Doppelter Attributwert.

DeliveryVehicleType

Der Typ des Lieferfahrzeugs.

Enums
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Der Wert wird nicht verwendet.
AUTO Ein Auto.
TWO_WHEELER Motorrad, Moped oder anderes Zweirad
BICYCLE Von Menschen betriebene Fortbewegungsmittel.
PEDESTRIAN Ein Personentransportmittel, das in der Regel zu Fuß oder beim Laufen auf Fußwegen unterwegs ist.

Methoden

create

Erstellt einen neuen DeliveryVehicle und gibt ihn zurück.

get

Gibt die angegebene DeliveryVehicle-Instanz zurück.

list

Ruft alle DeliveryVehicles ab, die den angegebenen Filterkriterien entsprechen.

patch

Schreibt aktualisierte DeliveryVehicle-Daten in die Fleet Engine und weist der DeliveryVehicle Tasks zu.