REST Resource: providers.deliveryVehicles
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: DeliveryVehicle
Die DeliveryVehicle-Nachricht. Ein Lieferfahrzeug transportiert Sendungen 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 Feldbenennungskonventionen. Beispiel: Das Feld DeliveryVehicle.current_route_segment in der gRPC API und das Feld DeliveryVehicle.currentRouteSegment in der REST API beziehen sich auf dasselbe Feld.
| JSON-Darstellung |
{
"name": string,
"lastLocation": {
object (DeliveryVehicleLocation)
},
"pastLocations": [
{
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 zuletzt gemeldete Standort des Lieferfahrzeugs.
|
pastLocations[] |
object (DeliveryVehicleLocation)
Nur Eingabe. Standorte, an denen sich dieses Lieferfahrzeug in der Vergangenheit befunden hat und die noch nicht an Fleet Engine gemeldet wurden. Dieser Wert wird in UpdateDeliveryVehicleRequest verwendet, um Standorte aufzuzeichnen, die zuvor nicht an den Server gesendet werden konnten. Das ist in der Regel der Fall, wenn das Übermittlungsgerät keine Internetverbindung hat.
|
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. Dieser Wert wird in Ihrer Fahrer App aktualisiert, 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 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.
|
currentRouteSegmentEndPoint |
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. 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. Die Fleet Engine ignoriert dieses Feld in UpdateDeliveryVehicleRequest, wenn das Feld currentRouteSegment leer ist.
|
remainingDuration |
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 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 Auslieferungsmedium 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".
|
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 Attribute für Lieferfahrzeuge. Ein Übermittlungsmedium kann maximal 100 Attribute haben und jedes Attribut muss einen eindeutigen Schlüssel haben.
|
type |
enum (DeliveryVehicleType)
Der Typ dieses Lieferfahrzeugs. Wenn dieser Wert nicht festgelegt ist, wird standardmäßig AUTO verwendet.
|
DeliveryVehicleNavigationStatus
Der Navigationsstatus des Fahrzeugs.
| Enums |
UNKNOWN_NAVIGATION_STATUS |
Nicht angegebener Navigationsstatus. |
NO_GUIDANCE |
Die Navigation der Fahr-App befindet sich im Modus FREE_NAV. |
ENROUTE_TO_DESTINATION |
Die detaillierte Routenführung ist verfügbar und die Navigation in der Fahrer App befindet sich im Modus GUIDED_NAV. |
OFF_ROUTE |
Das Fahrzeug ist von der vorgeschlagenen Route abgekommen. |
ARRIVED_AT_DESTINATION |
Das Fahrzeug befindet sich in etwa 50 m Entfernung vom Ziel. |
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 vom Typ „String“, „Boole“ oder „Doppelt“ sein. Für delivery_vehicle_attribute_value ist nur einer der folgenden Werte zulässig: |
stringValue |
string
Attributwert vom Typ „String“. Hinweis: Dieses Feld ist mit dem Feld value identisch, das demnächst 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.
|
boolValue |
boolean
Boolescher Attributwert.
|
numberValue |
number
Attributwert mit doppeltem Typ.
|
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 |
|
|
Erstellt eine neue DeliveryVehicle und gibt sie zurück. |
|
|
Löscht ein DeliveryVehicle aus der Fleet Engine. |
|
|
Gibt die angegebene DeliveryVehicle-Instanz zurück. |
|
|
Alle DeliveryVehicles abrufen, die die angegebenen Filterkriterien erfüllen |
|
|
Schreibt aktualisierte DeliveryVehicle-Daten in die Fleet Engine und weist der DeliveryVehicle Tasks zu. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-02-26 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-02-26 (UTC)."],[[["`DeliveryVehicle` resources represent vehicles transporting shipments between depots, delivery, and pickup locations, with attributes like location, navigation status, and route information."],["The `DeliveryVehicle` message supports various fields such as name, last location, navigation status, route details, remaining distance and duration, journey segments, attributes, and vehicle type."],["`DeliveryVehicleNavigationStatus` indicates the vehicle's navigation state, including options like `NO_GUIDANCE`, `ENROUTE_TO_DESTINATION`, `OFF_ROUTE`, and `ARRIVED_AT_DESTINATION`."],["`DeliveryVehicleAttribute` allows for custom key-value pairs describing the vehicle, supporting string, boolean, and number values for attributes."],["You can manage `DeliveryVehicle` resources through methods like `create`, `get`, `list`, and `patch` to interact with and update their data within Fleet Engine."]]],["DeliveryVehicles transport shipments between locations. Key data includes: vehicle `name`, `lastLocation`, `navigationStatus` (e.g., `ENROUTE_TO_DESTINATION`), `currentRouteSegment`, and `remainingDistanceMeters`. Attributes are customizable key-value pairs. `DeliveryVehicleType` specifies the vehicle (e.g., `AUTO`, `BICYCLE`). `DeliveryVehicle` data can be created, retrieved, listed, and updated through Fleet Engine. `DeliveryVehicleNavigationStatus` provides information about the navigation status of the vehicle.\n"]]
