Package maps.fleetengine.delivery.v1

Index

DeliveryService

Last Mile Delivery-Dienst

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

Erstellt einen Batch neuer Task-Objekte und gibt ihn zurück.

CreateDeliveryVehicle

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

Erstellt einen neuen DeliveryVehicle und gibt ihn zurück.

CreateTask

rpc CreateTask(CreateTaskRequest) returns (Task)

Erstellt ein neues Task-Objekt und gibt es zurück.

GetDeliveryVehicle

rpc GetDeliveryVehicle(GetDeliveryVehicleRequest) returns (DeliveryVehicle)

Gibt die angegebene DeliveryVehicle-Instanz zurück.

GetTask

rpc GetTask(GetTaskRequest) returns (Task)

Ruft Informationen zu einem Task ab.

GetTaskTrackingInfo

rpc GetTaskTrackingInfo(GetTaskTrackingInfoRequest) returns (TaskTrackingInfo)

Gibt die angegebene TaskTrackingInfo-Instanz zurück.

ListDeliveryVehicles

rpc ListDeliveryVehicles(ListDeliveryVehiclesRequest) returns (ListDeliveryVehiclesResponse)

Ruft alle DeliveryVehicles ab, die den angegebenen Filterkriterien entsprechen.

ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

Ruft alle Tasks ab, die den angegebenen Filterkriterien entsprechen.

UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Schreibt aktualisierte DeliveryVehicle-Daten in Fleet Engine und weist dem DeliveryVehicle Tasks zu. Sie können den Namen von DeliveryVehicle nicht aktualisieren. Sie können remaining_vehicle_journey_segments aktualisieren, aber sie muss alle VehicleJourneySegments enthalten, um in der DeliveryVehicle beibehalten zu werden. Die task_ids werden aus remaining_vehicle_journey_segments abgerufen und ihre entsprechenden Tasks-Elemente werden DeliveryVehicle zugewiesen, falls sie noch nicht zugewiesen wurden.

UpdateTask

rpc UpdateTask(UpdateTaskRequest) returns (Task)

Aktualisiert Task-Daten.

BatchCreateTasksRequest

Die Anfragenachricht BatchCreateTask.

Felder
header

DeliveryRequestHeader

Optional. Der standardmäßige Anfrageheader der Delivery API Hinweis: Wenn Sie dieses Feld festlegen, muss das Headerfeld in den CreateTaskRequest-Nachrichten entweder leer sein oder mit diesem Feld übereinstimmen.

parent

string

Erforderlich. Die übergeordnete Ressource, die von allen Aufgaben gemeinsam genutzt wird. Dieser Wert muss das Format providers/{provider} haben. provider muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project Das übergeordnete Feld in den CreateTaskRequest-Nachrichten muss entweder leer sein oder mit diesem Feld übereinstimmen.

requests[]

CreateTaskRequest

Erforderlich. Die Anfragenachricht, die die zu erstellenden Ressourcen angibt. Hinweis: Sie können in einem Batch maximal 500 Aufgaben erstellen.

BatchCreateTasksResponse

Die Antwortnachricht BatchCreateTask.

Felder
tasks[]

Task

Die erstellten Aufgaben.

CreateDeliveryVehicleRequest

Die Anfragenachricht CreateDeliveryVehicle.

Felder
header

DeliveryRequestHeader

Optional. Der standardmäßige Anfrageheader der Delivery API

parent

string

Erforderlich. Muss das Format providers/{provider} haben. Der Anbieter muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project.

delivery_vehicle_id

string

Erforderlich. Die Lieferfahrzeug-ID muss eindeutig sein und unterliegt den folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Sie ist auf maximal 64 Zeichen beschränkt.
  • Nach der Unicode-Normalisierungsform C normalisiert.
  • Darf keines der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.
delivery_vehicle

DeliveryVehicle

Erforderlich. Die zu erstellende DeliveryVehicle-Entität. Wenn Sie ein neues Lieferfahrzeug erstellen, können Sie die folgenden optionalen Felder festlegen:

  • Typ
  • last_location
  • Attribute

Hinweis: Das Feld name des DeliveryVehicle wird ignoriert. Alle anderen Felder für das Lieferfahrzeug dürfen nicht festgelegt werden. Andernfalls wird ein Fehler zurückgegeben.

CreateTaskRequest

Die Anfragenachricht CreateTask.

Felder
header

DeliveryRequestHeader

Optional. Der standardmäßige Anfrageheader der Delivery API

parent

string

Erforderlich. Muss das Format providers/{provider} haben. provider muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project

task_id

string

Erforderlich. Die Aufgaben-ID muss eindeutig sein, sollte aber keine ID für die Sendungsverfolgung sein. Verwenden Sie zum Speichern einer Sendungsverfolgungs-ID das Feld tracking_id. Mehrere Aufgaben können dieselbe tracking_id haben. Aufgaben-IDs unterliegen den folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Sie ist auf maximal 64 Zeichen beschränkt.
  • Nach der Unicode-Normalisierungsform C normalisiert.
  • Darf keines der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.
task

Task

Erforderlich. Die zu erstellende Taskentität. Beim Erstellen einer Aufgabe müssen die folgenden Felder ausgefüllt werden:

  • type
  • state (muss auf OPEN festgelegt sein)
  • tracking_id (darf nicht für UNAVAILABLE- oder SCHEDULED_STOP-Aufgaben festgelegt werden, ist jedoch für alle anderen Aufgabentypen erforderlich)
  • planned_location (optional für UNAVAILABLE Aufgaben)
  • task_duration

Hinweis: Das Feld name der Aufgabe wird ignoriert. Alle anderen Aufgabenfelder dürfen nicht festgelegt werden. Andernfalls wird ein Fehler zurückgegeben.

DeliveryRequestHeader

Ein RequestHeader enthält Felder, die für alle Delivery-RPC-Anfragen gelten.

Felder
language_code

string

Der BCP-47-Sprachcode, z. B. en-US oder sr-Latn. Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Ist keiner angegeben, kann die Antwort in einer beliebigen Sprache erfolgen. Falls ein solcher Name vorhanden ist, wird Englisch bevorzugt. Beispiel für Feldwert: en-US.

region_code

string

Erforderlich. CLDR-Regionscode der Region, aus der die Anfrage stammt. Beispiel für Feldwert: US.

sdk_version

string

Version des aufrufenden SDKs (falls zutreffend). Das Versionsformat ist „major.minor.patch“, z. B. 1.1.2.

os_version

string

Version des Betriebssystems, auf dem das aufrufende SDK ausgeführt wird. Beispiele für Feldwerte: 4.4.1, 12.1.

device_model

string

Modell des Geräts, auf dem das aufrufende SDK ausgeführt wird. Beispiele für Feldwerte: iPhone12,1, SM-G920F.

sdk_type

SdkType

Der SDK-Typ, der die Anfrage sendet.

maps_sdk_version

string

Version des MapSDK, von dem das aufrufende SDK abhängig ist (falls zutreffend). Das Versionsformat ist „major.minor.patch“, z. B. 5.2.1.

nav_sdk_version

string

Version des NavSDK, von der das aufrufende SDK abhängig ist (falls zutreffend). Das Versionsformat ist „major.minor.patch“, z. B. 2.1.0.

platform

Platform

Plattform des aufrufenden SDKs.

manufacturer

string

Hersteller des Android-Geräts aus dem aufrufenden SDK; gilt nur für die Android SDKs. Beispiel für Feldwert: Samsung.

android_api_level

int32

Android API-Level des aufrufenden SDKs, gilt nur für die Android SDKs. Beispiel für Feldwert: 23.

trace_id

string

Optionale ID, die zu Protokollierungszwecken angegeben werden kann, um die Anfrage zu identifizieren.

Plattform

Die Plattform des aufrufenden SDK.

Enums
PLATFORM_UNSPECIFIED Der Standardwert. Dieser Wert wird verwendet, wenn die Plattform weggelassen wird.
ANDROID Die Anfrage stammt von Android.
IOS Die Anfrage stammt von iOS.
WEB Die Anfrage kommt aus dem Web.

SdkType

Mögliche SDK-Typen.

Enums
SDK_TYPE_UNSPECIFIED Der Standardwert. Dieser Wert wird verwendet, wenn sdk_type weggelassen wird.
CONSUMER Das aufrufende SDK ist „Consumer“.
DRIVER Das aufrufende SDK ist Driver.
JAVASCRIPT Das aufrufende SDK ist JavaScript.

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 auch Lieferungen 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.

Felder
name

string

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

last_location

DeliveryVehicleLocation

Der letzte gemeldete Standort des Lieferfahrzeugs.

navigation_status

DeliveryVehicleNavigationStatus

Der Navigationsstatus des Lieferfahrzeugs.

current_route_segment

bytes

Die codierte Polylinie, die die von der Navigation empfohlene Route zum nächsten Wegpunkt angibt. Ihre Fahrer-App aktualisiert dies, wenn eine Haltestelle erreicht oder vorbeigeleitet wird und 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 von current_route_segment stimmt nicht mit DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) oder DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST) überein.

  • Die Treiber-App hat ihren Standort in letzter Zeit nicht aktualisiert, sodass der letzte aktualisierte Wert für dieses Feld möglicherweise veraltet ist.

  • Die Fahrer-App hat vor Kurzem ihren Standort aktualisiert, aber die current_route_segment 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.

current_route_segment_end_point

LatLng

Der Ort, an dem die current_route_segment endet. Diese wird derzeit nicht von der Treiber-App ausgefüllt, du kannst sie jedoch bei UpdateDeliveryVehicle-Aufrufen bereitstellen. Das ist entweder die LatLng der nächsten Haltestelle oder die letzte LatLng der current_route_segment. Fleet Engine versucht dann, mit einer tatsächlichen VehicleStop zu interpolieren.

Dieses Feld wird in UpdateDeliveryVehicle-Aufrufen ignoriert, wenn das Feld current_route_segment leer ist.

remaining_distance_meters

Int32Value

Die verbleibende Fahrstrecke für die current_route_segment. Dieses Feld wird in der Regel in der Treiber-App bereitgestellt. Unter bestimmten Umständen überschreibt Fleet Engine den von der Anwendung gesendeten Wert jedoch. Weitere Informationen findest du 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 current_route_segment leer ist.

remaining_duration

Duration

Die verbleibende Fahrzeit für current_route_segment. Dieses Feld wird in der Regel in der Treiber-App bereitgestellt. Unter bestimmten Umständen überschreibt Fleet Engine den von der Anwendung gesendeten Wert jedoch. Weitere Informationen findest du 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 current_route_segment leer ist.

remaining_vehicle_journey_segments[]

VehicleJourneySegment

Die Fahrtabschnitte, die diesem Lieferfahrzeug zugewiesen sind, beginnend mit dem zuletzt gemeldeten Standort des Fahrzeugs. Dieses Feld wird in der Antwort von ListDeliveryVehicles nicht ausgefüllt.

attributes[]

DeliveryVehicleAttribute

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

type

DeliveryVehicleType

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

DeliveryVehicleType

Der Typ des Lieferfahrzeugs.

Enums
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Der Wert wird nicht verwendet.
AUTO Ein Auto.
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.

DeliveryVehicleAttribute

Beschreibt ein Fahrzeugattribut als Schlüssel/Wert-Paar. Das Schlüssel/Wert-Paar String darf nicht länger als 256 Zeichen sein.

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:
string_value

string

Als String eingegebener Attributwert.

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

bool_value

bool

Boolescher Attributwert

number_value

double

Doppelter Attributwert.

DeliveryVehicleLocation

Der Standort, die Geschwindigkeit und die Richtung eines Fahrzeugs zu einem bestimmten Zeitpunkt.

Felder
location

LatLng

Der Standort des Fahrzeugs. Bei der Übermittlung an Fleet Engine ist der Standort des Fahrzeugs ein GPS-Standort. Wenn Sie diese als Antwort erhalten, kann der Standort des Fahrzeugs entweder ein GPS-Standort, ein zusätzlicher Standort oder ein anderer ungefährer Standort sein. Die Quelle wird in location_sensor angegeben.

horizontal_accuracy
(deprecated)

DoubleValue

Eingestellt: Verwende stattdessen latlng_accuracy.

latlng_accuracy

DoubleValue

Genauigkeit von location in Metern als Radius.

heading

Int32Value

Richtung, in der das Fahrzeug in Grad bewegt wird. 0 steht für Norden. Der gültige Bereich ist [0,360).

bearing_accuracy
(deprecated)

DoubleValue

Eingestellt: Verwende stattdessen heading_accuracy.

heading_accuracy

DoubleValue

Genauigkeit von heading in Grad.

altitude

DoubleValue

Höhe in Metern über WGS84.

vertical_accuracy
(deprecated)

DoubleValue

Eingestellt: Verwende stattdessen altitude_accuracy.

altitude_accuracy

DoubleValue

Genauigkeit von altitude in Metern.

speed_kmph
(deprecated)

Int32Value

Geschwindigkeit des Fahrzeugs in Kilometern pro Stunde. Eingestellt: Verwende stattdessen speed.

speed

DoubleValue

Geschwindigkeit des Fahrzeugs in Metern/Sekunde

speed_accuracy

DoubleValue

Genauigkeit von speed in Metern/Sekunde.

update_time

Timestamp

Die Zeit, zu der location vom Sensor gemäß der Uhr des Sensors gemeldet wurde.

server_time

Timestamp

Nur Ausgabe. Die Uhrzeit, zu der der Server die Standortinformationen empfangen hat.

location_sensor

DeliveryVehicleLocationSensor

Anbieter von Standortdaten, z. B. GPS.

is_road_snapped

BoolValue

Gibt an, ob location an eine Straße ausgerichtet ist.

is_gps_sensor_enabled

BoolValue

Nur Eingabe. Gibt an, ob der GPS-Sensor auf dem Mobilgerät aktiviert ist.

time_since_update

Int32Value

Nur Eingabe. Zeit in Sekunden, seit dieser Standort zum ersten Mal an den Server gesendet wurde. Bei der ersten Aktualisierung ist dieser Wert null. Ist die Zeit unbekannt, z. B. beim Neustart der App, wird dieser Wert auf null zurückgesetzt.

num_stale_updates
(deprecated)

Int32Value

Nur Eingabe. Eingestellt: Andere Signale werden jetzt verwendet, um festzustellen, ob ein Standort veraltet ist.

raw_location

LatLng

Standort des unbearbeiteten Fahrzeugs (nicht von Road-Snapper verarbeitet).

raw_location_time

Timestamp

Zeitstempel, der dem unformatierten Standort zugeordnet ist.

raw_location_sensor

DeliveryVehicleLocationSensor

Quelle des unformatierten Standorts. Die Standardeinstellung ist GPS.

raw_location_accuracy

DoubleValue

Radiusgenauigkeit von raw_location in Metern.

supplemental_location

LatLng

Zusätzlicher Standort, der von der integrierenden App bereitgestellt wird.

supplemental_location_time

Timestamp

Zeitstempel, der dem zusätzlichen Standort zugeordnet ist.

supplemental_location_sensor

DeliveryVehicleLocationSensor

Quelle des zusätzlichen Standorts. Die Standardeinstellung ist CUSTOMER_SUPPLIED_LOCATION.

supplemental_location_accuracy

DoubleValue

Radiusgenauigkeit von supplemental_location in Metern.

road_snapped
(deprecated)

bool

Eingestellt: Verwende stattdessen is_road_snapped.

DeliveryVehicleLocationSensor

Der Sensor oder die Methode, mit der der Standort ermittelt wurde.

Enums
UNKNOWN_SENSOR Der Sensor ist nicht angegeben oder unbekannt.
GPS GPS oder unterstütztes GPS.
NETWORK Unterstütztes GPS, Mobilfunkmast-ID oder WLAN-Zugangspunkt
PASSIVE Mobilfunkmast-ID oder WiFi-Zugangspunkt.
ROAD_SNAPPED_LOCATION_PROVIDER Ein Standort, der vom Mobilgerät als die wahrscheinlichste Straßenposition bestimmt wird.
CUSTOMER_SUPPLIED_LOCATION Ein vom Kunden bereitgestellter Standort aus einer unabhängigen Quelle. In der Regel wird dieser Wert für einen Standort verwendet, der von anderen Quellen als dem Mobilgerät bereitgestellt wird, auf dem das Driver SDK ausgeführt wird. Wenn die ursprüngliche Quelle durch einen der anderen enum-Werte beschrieben wird, verwenden Sie diesen Wert. Mit CUSTOMER_SUPPLIED_LOCATION gekennzeichnete Standorte werden in der Regel über die last_location.supplemental_location_sensor eines Lieferfahrzeugs bereitgestellt.
FLEET_ENGINE_LOCATION Ein Standort, der von Fleet Engine anhand der verfügbaren Signale berechnet wird. Nur Ausgabe. Dieser Wert wird abgelehnt, wenn er in einer Anfrage enthalten ist.
FUSED_LOCATION_PROVIDER Fused Location Provider von Android.
CORE_LOCATION Der Standortanbieter für Apple-Betriebssysteme.

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 hat den GUIDED_NAV-Modus erreicht.
OFF_ROUTE Das Fahrzeug ist nicht mehr auf der vorgeschlagenen Route gefahren.
ARRIVED_AT_DESTINATION Das Fahrzeug ist maximal 50 m vom Ziel entfernt.

GetDeliveryVehicleRequest

Die Anfragenachricht GetDeliveryVehicle.

Felder
header

DeliveryRequestHeader

Optional. Der standardmäßige Anfrageheader der Delivery API

name

string

Erforderlich. Muss das Format providers/{provider}/deliveryVehicles/{delivery_vehicle} haben. provider muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project

GetTaskRequest

Die Anfragenachricht GetTask.

Felder
header

DeliveryRequestHeader

Optional. Der standardmäßige Anfrageheader der Delivery API

name

string

Erforderlich. Muss das Format providers/{provider}/tasks/{task} haben. provider muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project

GetTaskTrackingInfoRequest

Die Anfragenachricht GetTaskTrackingInfoRequest.

Felder
header

DeliveryRequestHeader

Optional. Der standardmäßige Anfrageheader der Delivery API

name

string

Erforderlich. Muss das Format providers/{provider}/taskTrackingInfo/{tracking_id} haben. provider muss die Google Cloud-Projekt-ID und tracking_id die mit der Aufgabe verknüpfte Tracking-ID sein. Ein Beispielname ist providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id.

ListDeliveryVehiclesRequest

Die Anfragenachricht ListDeliveryVehicles.

Felder
header

DeliveryRequestHeader

Optional. Der standardmäßige Anfrageheader der Delivery API

parent

string

Erforderlich. Muss das Format providers/{provider} haben. provider muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project

page_size

int32

Optional. Die maximale Anzahl von Fahrzeugen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diese Anzahl zurück. Wenn Sie diese Zahl nicht angeben, bestimmt der Server die Anzahl der zurückzugebenden Ergebnisse.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListDeliveryVehicles-Aufruf empfangen wurde. Sie müssen dies angeben, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListDeliveryVehicles bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Optional. Eine Filterabfrage, die beim Auflisten von Lieferfahrzeugen angewendet werden soll. Beispiele für die Filtersyntax finden Sie unter http://aip.dev/160. Wenn Sie keinen Wert oder einen leeren String für den Filter angeben, werden alle Lieferfahrzeuge zurückgegeben.

Beachten Sie, dass für ListDeliveryVehicles nur Fahrzeugattribute (z. B. attributes.<key> = <value> oder attributes.<key1> = <value1> AND attributes.<key2> = <value2>) unterstützt werden. Außerdem werden alle Attribute als Strings gespeichert, sodass nur Stringvergleiche für Attribute unterstützt werden. Für den Vergleich mit Zahlen- oder booleschen Werten müssen die Werte explizit in Anführungszeichen gesetzt werden, damit sie als Strings behandelt werden (z. B. attributes.<key> = "10" oder attributes.<key> = "true").

In einer Filterabfrage sind maximal 50 Einschränkungen zulässig. Eine Einschränkung ist Teil der Abfrage der Form attribute.<KEY> <COMPARATOR> <VALUE>, zum Beispiel hat attributes.foo = bar die Einschränkung „1“.

viewport

Viewport

Optional. Ein Filter, der die zurückgegebenen Fahrzeuge auf diejenigen beschränkt, deren letzter bekannter Standort sich in dem vom Darstellungsbereich definierten rechteckigen Bereich befand.

ListDeliveryVehiclesResponse

Die Antwortnachricht ListDeliveryVehicles.

Felder
delivery_vehicles[]

DeliveryVehicle

Die Lieferfahrzeuge, die die angeforderten Filterkriterien erfüllen. Wenn kein Filter angegeben ist, gibt die Anfrage alle Lieferfahrzeuge zurück. Eine erfolgreiche Antwort kann auch leer sein. Eine leere Antwort bedeutet, dass keine Lieferfahrzeuge gefunden wurden, die die angeforderten Filterkriterien erfüllen.

next_page_token

string

Sie können dieses Token im ListDeliveryVehiclesRequest übergeben, um mit der Auflistung der Ergebnisse fortzufahren. Wenn alle Ergebnisse zurückgegeben werden, ist dieses Feld nicht in der Antwort enthalten oder es ist ein leerer String.

total_size

int64

Die Gesamtzahl der Auslieferungsfahrzeuge, die den Anfragekriterien auf allen Seiten entsprechen.

ListTasksRequest

Die Anfragenachricht ListTasks.

Felder
header

DeliveryRequestHeader

Optional. Der standardmäßige Anfrageheader der Delivery API

parent

string

Erforderlich. Muss das Format providers/{provider} haben. provider muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project

page_size

int32

Optional. Die maximale Anzahl von Aufgaben, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn Sie diesen Wert nicht angeben, bestimmt der Server die Anzahl der zurückzugebenden Ergebnisse.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListTasks-Aufruf empfangen wurde. Sie können diese angeben, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListTasks bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Optional. Eine Filterabfrage, die beim Auflisten von Aufgaben angewendet werden soll. Beispiele für die Filtersyntax finden Sie unter http://aip.dev/160. Wenn Sie keinen Wert angeben oder nach einem leeren String filtern, werden alle Aufgaben zurückgegeben. Informationen zu den Aufgabeneigenschaften, nach denen Sie filtern können, finden Sie unter Aufgaben auflisten.

ListTasksResponse

Die ListTasks-Antwort, die die Aufgaben enthält, die die Filterkriterien in der ListTasksRequest erfüllen.

Felder
tasks[]

Task

Die Aufgaben, die die angeforderten Filterkriterien erfüllen. Wenn kein Filter angegeben ist, gibt die Anfrage alle Aufgaben zurück. Eine erfolgreiche Antwort kann auch leer sein. Eine leere Antwort gibt an, dass keine Aufgaben gefunden wurden, die die angeforderten Filterkriterien erfüllen.

next_page_token

string

Übergeben Sie dieses Token im ListTasksRequest, um mit der Auflistung der Ergebnisse fortzufahren. Wenn alle Ergebnisse zurückgegeben wurden, ist dieses Feld entweder ein leerer String oder es wird nicht in der Antwort angezeigt.

total_size

int64

Die Gesamtzahl der Aufgaben, die den Anfragekriterien auf allen Seiten entsprechen.

LocationInfo

Ein Standort mit zusätzlichen Kennungen.

Felder
point

LatLng

Die Koordinaten des Standorts.

Aufgabe

Eine Aufgabe in der Delivery API stellt eine einzelne zu verfolgende Aktion dar. Im Allgemeinen wird zwischen versandbezogenen Aufgaben und Unterbrechungsaufgaben unterschieden. Mit einer Sendung können mehrere Aufgaben verknüpft sein. Es könnte beispielsweise eine Aufgabe für das Abholen und eine für die Abgabe oder den Umstieg geben. Außerdem können verschiedene Aufgaben für eine bestimmte Lieferung von unterschiedlichen Fahrzeugen abgewickelt werden. Zum Beispiel könnte ein Fahrzeug die Abholung übernehmen und die Sendung zum Hub bringen, während ein anderes Fahrzeug dieselbe Sendung vom Hub zum Abholort transportiert.

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

Felder
name

string

Muss das Format providers/{provider}/tasks/{task} haben.

type

Type

Erforderlich. Nicht veränderbar. Definiert den Aufgabentyp. Zum Beispiel eine Pause oder ein Versand.

state

State

Erforderlich. Der aktuelle Ausführungsstatus der Aufgabe.

task_outcome

TaskOutcome

Das Ergebnis der Aufgabe.

task_outcome_time

Timestamp

Der Zeitstempel, der angibt, wann das Ergebnis des Task vom Anbieter festgelegt wurde.

task_outcome_location

LocationInfo

Der Ort, an dem das Ergebnis für Task festgelegt wurde. Dieser Wert wird im Rahmen von UpdateTask aktualisiert. Wenn dieser Wert nicht explizit vom Anbieter aktualisiert wird, gibt Fleet Engine standardmäßig den letzten bekannten Fahrzeugstandort (den rohen Standort) ein.

task_outcome_location_source

TaskOutcomeLocationSource

Gibt an, woher der Wert von task_outcome_location stammt.

tracking_id

string

Nicht veränderbar. Dieses Feld erleichtert das Speichern einer ID, sodass Sie die Verwendung einer komplizierten Zuordnung vermeiden können. Sie können tracking_id nicht für Aufgaben vom Typ UNAVAILABLE und SCHEDULED_STOP festlegen. Diese IDs unterliegen den folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Sie ist auf maximal 64 Zeichen beschränkt.
  • Nach der Unicode-Normalisierungsform C normalisiert.
  • Darf keines der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.
delivery_vehicle_id

string

Nur Ausgabe. Die ID des Fahrzeugs, das diese Aufgabe ausführt. Lieferfahrzeug-IDs unterliegen den folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Sie ist auf maximal 64 Zeichen beschränkt.
  • Nach der Unicode-Normalisierungsform C normalisiert.
  • Darf keines der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.
planned_location

LocationInfo

Nicht veränderbar. Der Ort, an dem die Aufgabe erledigt wird. Optional für UNAVAILABLE-Aufgaben, aber für alle anderen Tasks erforderlich.

task_duration

Duration

Erforderlich. Nicht veränderbar. Die Zeit, die zum Ausführen einer Aufgabe an diesem Ort benötigt wird.

target_time_window

TimeWindow

Das Zeitfenster, in dem die Aufgabe abgeschlossen werden sollte.

journey_sharing_info

JourneySharingInfo

Nur Ausgabe. Spezifische Felder für das Teilen von Reisen. Wird nicht ausgefüllt, wenn der Status CLOSED ist.

task_tracking_view_config

TaskTrackingViewConfig

Die Konfiguration für das Aufgaben-Tracking, die angibt, welche Datenelemente unter welchen Umständen für die Endnutzer sichtbar sind.

attributes[]

TaskAttribute

Eine Liste benutzerdefinierter Aufgabenattribute. Jedes Attribut muss einen eindeutigen Schlüssel haben.

JourneySharingInfo

Bestimmte Felder für die gemeinsame Nutzung von Reisen.

Felder
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Trackinginformationen für die Haltestellen, die das zugewiesene Fahrzeug vor Abschluss dieser Aufgabe einlegt. Beachten Sie, dass diese Liste Stopps von anderen Aufgaben enthalten kann.

Das erste Segment, Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) oder Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), enthält Routeninformationen vom letzten bekannten Standort des Fahrers zum nächsten VehicleStop. Die Informationen zur aktuellen Route stammen normalerweise von der Fahrer-App, mit Ausnahme einiger Fälle, die in der Dokumentation zu DeliveryVehicle.current_route_segment aufgeführt sind. Die anderen Segmente in Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) oder Task.journeySharingInfo.remainingVehicleJourneySegments (REST) werden von Fleet Engine gefüllt. Sie liefern Routeninformationen zwischen den verbleibenden VehicleStops.

last_location

DeliveryVehicleLocation

Gibt den letzten gemeldeten Standort des zugewiesenen Fahrzeugs an.

last_location_snappable

bool

Gibt an, ob „lastLocation“ des Fahrzeugs an current_route_segment ausgerichtet werden kann. Dieser Wert ist „False“, wenn last_location oder current_route_segment nicht vorhanden sind. Dieser Wert wird von Fleet Engine berechnet. Aktualisierungen von Clients werden ignoriert.

Status

Der Status einer Aufgabe. Dies zeigt den Fortschritt der Aufgaben an.

Enums
STATE_UNSPECIFIED Standard. Wird für einen nicht angegebenen oder nicht erkannten Aufgabenstatus verwendet.
OPEN Entweder wurde die Aufgabe noch keinem Lieferfahrzeug zugewiesen oder das Lieferfahrzeug hat den zugewiesenen Fahrzeugstopp der Task noch nicht passiert.
CLOSED Wenn das Fahrzeug an der Haltestelle für diese Aufgabe vorbeifährt.

TaskOutcome

Das Ergebnis des Versuchs, eine Aufgabe auszuführen. Wenn TaskState geschlossen ist, gibt TaskOutcome an, ob der Vorgang erfolgreich abgeschlossen wurde.

Enums
TASK_OUTCOME_UNSPECIFIED Das Aufgabenergebnis, bevor sein Wert festgelegt wird.
SUCCEEDED Die Aufgabe wurde abgeschlossen.
FAILED Entweder konnte die Aufgabe nicht abgeschlossen werden oder sie wurde abgebrochen.

TaskOutcomeLocationSource

Die Identität der Quelle, die das task_outcome_location ausgefüllt hat.

Enums
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED Das Ergebnis der Aufgabe, bevor es festgelegt wird.
PROVIDER Der Anbieter hat die task_outcome_location angegeben.
LAST_VEHICLE_LOCATION task_outcome_location hat vom Anbieter nicht angegeben, sodass Fleet Engine den letzten bekannten Fahrzeugstandort verwendet hat.

Typ

Der Aufgabentyp.

Enums
TYPE_UNSPECIFIED Standardeinstellung. Der Aufgabentyp ist unbekannt.
PICKUP Eine Abholaufgabe ist die Aktion, die bei der Abholung einer Sendung von einem Kunden ausgeführt wird. Für Abholung von Fahrzeugen in Depots oder Feeder sollte der Typ SCHEDULED_STOP verwendet werden.
DELIVERY Eine Lieferaufgabe ist die Aktion, die für die Zustellung einer Sendung an einen Endkunden ausgeführt wird. Bei Abgabestellen für Depots oder Feeder muss der Typ SCHEDULED_STOP verwendet werden.
SCHEDULED_STOP Eine Aufgabe für geplante Stopps wird zu Planungszwecken verwendet. Sie können beispielsweise Lieferungen von Feeder-Fahrzeugen oder -Depots abholen oder abgeben. Er sollte nicht für Sendungen verwendet werden, die von einem Endkunden abgeholt oder abgegeben werden.
UNAVAILABLE Eine Aufgabe, die bedeutet, dass das Fahrzeug nicht verfügbar ist. Das kann zum Beispiel passieren, wenn der Fahrer eine Pause macht oder das Fahrzeug betankt wird.

TaskAttribute

Beschreibt ein Aufgabenattribut als Schlüssel/Wert-Paar. Das Schlüssel/Wert-Paar String darf nicht länger als 256 Zeichen sein.

Felder
key

string

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

Union-Feld task_attribute_value. Der Wert des Attributs kann als String, boolescher oder Double-Wert angegeben werden. Wenn keine Werte festgelegt sind, wird der TaskAttribute string_value als leerer String "" gespeichert. Für task_attribute_value ist nur einer der folgenden Werte zulässig:
string_value

string

Als String eingegebener Attributwert.

bool_value

bool

Boolescher Attributwert

number_value

double

Doppelter Attributwert.

TaskTrackingInfo

Die TaskTrackingInfo-Nachricht. Die Nachricht enthält Informationen zur Aufgabenverfolgung, die zur Anzeige verwendet werden. Wenn eine Tracking-ID mit mehreren Aufgaben verknüpft ist, entscheidet Fleet Engine anhand einer Heuristik, welche TaskTrackingInfo-Informationen ausgewählt werden sollen.

Felder
name

string

Muss das Format providers/{provider}/taskTrackingInfo/{tracking} haben, wobei tracking für die Tracking-ID steht.

tracking_id

string

Nicht veränderbar. Die Tracking-ID einer Aufgabe. * Muss ein gültiger Unicode-String sein. * Beschränkt auf eine maximale Länge von 64 Zeichen. * gemäß Unicode-Normalisierungsform C normalisiert. * Darf keines der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.

vehicle_location

DeliveryVehicleLocation

Der letzte Standort des Fahrzeugs.

route_polyline_points[]

LatLng

Eine Liste von Punkten, die bei Verbindung eine Polylinie der erwarteten Route des Fahrzeugs zum Standort dieser Aufgabe bilden.

remaining_stop_count

Int32Value

Gibt die Anzahl der Stopps an, die das Fahrzeug noch bis zum Erreichen des Taskstopps hat, einschließlich des Taskstopps. Wenn die nächste Haltestelle des Fahrzeugs beispielsweise die Aufgabenhaltestelle ist, ist der Wert „1“.

remaining_driving_distance_meters

Int32Value

Die gesamte verbleibende Entfernung in Metern zum gewünschten VehicleStop.

estimated_arrival_time

Timestamp

Der Zeitstempel, der die voraussichtliche Ankunftszeit an der Position der Haltestelle angibt.

estimated_task_completion_time

Timestamp

Der Zeitstempel, der die geschätzte Abschlusszeit einer Aufgabe angibt.

state

State

Der aktuelle Ausführungsstatus der Aufgabe.

task_outcome

TaskOutcome

Das Ergebnis des Versuchs, eine Aufgabe auszuführen.

task_outcome_time

Timestamp

Der Zeitstempel, der angibt, wann das Ergebnis der Aufgabe vom Anbieter festgelegt wurde.

planned_location

LocationInfo

Nicht veränderbar. Der Ort, an dem die Aufgabe erledigt wird.

target_time_window

TimeWindow

Das Zeitfenster, in dem die Aufgabe abgeschlossen werden sollte.

attributes[]

TaskAttribute

Die benutzerdefinierten Attribute, die für die Aufgabe festgelegt wurden.

TaskTrackingViewConfig

Die Konfigurationsnachricht, die definiert, wann ein Datenelement einer Aufgabe für Endnutzer sichtbar sein soll.

Felder
route_polyline_points_visibility

VisibilityOption

Das Feld, das angibt, wann Polylinienpunkte der Route sichtbar sind. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

estimated_arrival_time_visibility

VisibilityOption

Das Feld, das angibt, wann die voraussichtliche Ankunftszeit angezeigt werden kann. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

estimated_task_completion_time_visibility

VisibilityOption

Das Feld, das angibt, wann die geschätzte Aufgabenerledigungszeit angezeigt werden kann. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

remaining_driving_distance_visibility

VisibilityOption

Das Feld, das die verbleibende Fahrstrecke angibt, kann sichtbar sein. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

remaining_stop_count_visibility

VisibilityOption

Das Feld, das angibt, wann die Anzahl der verbleibenden Haltestellen sichtbar ist. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

vehicle_location_visibility

VisibilityOption

Das Feld, das angibt, wann der Fahrzeugstandort sichtbar ist. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

VisibilityOption

Die Optionsnachricht, die definiert, wann ein Datenelement für Endnutzer sichtbar sein soll.

Felder
Union-Feld visibility_option. Die ausgewählte Sichtbarkeitsoption. Für visibility_option ist nur einer der folgenden Werte zulässig:
remaining_stop_count_threshold

int32

Dieses Datenelement ist für Endnutzer sichtbar, wenn die Anzahl der verbleibenden Haltestellen <= verbleibenden_stop_count_threshold.

duration_until_estimated_arrival_time_threshold

Duration

Dieses Datenelement ist für Endnutzer sichtbar, wenn die voraussichtliche Ankunftszeit an der Haltestelle <= duration_bis_estimated_arrival_time_threshold.

remaining_driving_distance_meters_threshold

int32

Dieses Datenelement ist für Endnutzer sichtbar, wenn die verbleibende Fahrstrecke in Metern <= verbleibenden_driving_distance_meters_threshold.

always

bool

Wenn die Richtlinie auf „true“ gesetzt ist, ist dieses Datenelement für Endnutzer ohne Grenzwerte immer sichtbar. Dieses Feld darf nicht auf „false“ gesetzt werden.

never

bool

Wenn die Richtlinie auf „true“ gesetzt ist, wird dieses Datenelement für Endnutzer ohne Grenzwerte immer ausgeblendet. Dieses Feld darf nicht auf „false“ gesetzt werden.

TimeWindow

Zeitraum.

Felder
start_time

Timestamp

Erforderlich. Die Startzeit des Zeitfensters (einschließlich).

end_time

Timestamp

Erforderlich. Die Endzeit des Zeitfensters (einschließlich).

UpdateDeliveryVehicleRequest

Die Anfragenachricht UpdateDeliveryVehicle.

Felder
header

DeliveryRequestHeader

Optional. Der standardmäßige Anfrageheader der Delivery API

delivery_vehicle

DeliveryVehicle

Erforderlich. Die anzuwendende DeliveryVehicle-Entitätsaktualisierung. Hinweis: Sie können den Namen von DeliveryVehicle nicht aktualisieren.

update_mask

FieldMask

Erforderlich. Eine Feldmaske, die angibt, welche DeliveryVehicle-Felder aktualisiert werden sollen. Die update_mask muss mindestens ein Feld enthalten.

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "remaining_vehicle_journey_segments".

UpdateTaskRequest

Die Anfragenachricht UpdateTask.

Felder
header

DeliveryRequestHeader

Optional. Der standardmäßige Anfrageheader der Delivery API

task

Task

Erforderlich. Die mit der Aktualisierung verknüpfte Aufgabe. Die folgenden Felder werden von Fleet Engine verwaltet. Aktualisieren Sie sie nicht mit Task.update.

  • last_location.
  • last_location_snappable.
  • name.
  • remaining_vehicle_journey_segments.
  • task_outcome_location_source.

Hinweis: Sie können den Wert von task_outcome nicht mehr ändern, nachdem Sie ihn festgelegt haben.

Wenn die Aufgabe einem Lieferfahrzeug zugewiesen wurde, setzen Sie den Aufgabenstatus nicht mithilfe von Task.update auf GESCHLOSSEN. Entfernen Sie stattdessen die VehicleStop, die die Aufgabe enthält, aus dem Lieferfahrzeug. Dadurch wird der Aufgabenstatus automatisch auf „CLOSED“ gesetzt.

update_mask

FieldMask

Erforderlich. Die Feldmaske, die angibt, welche Aufgabenfelder aktualisiert werden sollen. Hinweis: Der update_mask muss mindestens ein Feld enthalten.

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "task_outcome,task_outcome_time,task_outcome_location".

VehicleJourneySegment

Die Fahrstrecke eines Fahrzeugs – von der vorherigen Haltestelle bis zur aktuellen Haltestelle. Wenn es sich um die erste aktive Haltestelle handelt, gelangt sie von der aktuellen Position des Fahrzeugs zu dieser Haltestelle.

Felder
stop

VehicleStop

Gibt die Position der Haltestelle zusammen mit den mit der Haltestelle verknüpften Tasks an. Einige Felder von VehicleStop sind möglicherweise nicht vorhanden, wenn dieses Fahrtsegment zu JourneySharingInfo gehört.

driving_distance_meters

Int32Value

Nur Ausgabe. Die Entfernung von der vorherigen Haltestelle bis zu dieser Haltestelle. Wenn die aktuelle Haltestelle die erste Haltestelle in der Liste der Fahrtabschnitte ist, ist der Startpunkt der Standort des Fahrzeugs, der erfasst wurde, als die Haltestelle der Liste hinzugefügt wurde. Dieses Feld ist möglicherweise nicht vorhanden, wenn dieses Pfadsegment Teil von JourneySharingInfo ist.

driving_duration

Duration

Nur Ausgabe. Die Fahrtzeit von der vorherigen Haltestelle zu dieser Haltestelle. Wenn die aktuelle Haltestelle die erste Haltestelle in der Liste der Fahrtabschnitte ist, ist der Startpunkt der Standort des Fahrzeugs, der erfasst wurde, als die Haltestelle der Liste hinzugefügt wurde.

Wenn dieses Feld im Pfad Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) oder Task.remainingVehicleJourneySegments[0].drivingDuration (REST) definiert ist, kann es mit dem Wert aus DeliveryVehicle.remaining_duration (gRPC) oder DeliveryVehicle.remainingDuration (REST) gefüllt werden. Dadurch wird die verbleibende Fahrtdauer vom letzten bekannten Standort der Fahrer-App und nicht von der Fahrzeit von der vorherigen Haltestelle abgerufen.

path[]

LatLng

Nur Ausgabe. Der Weg von der vorherigen Haltestelle zu dieser Haltestelle. Wenn die aktuelle Haltestelle die erste Haltestelle in der Liste der Fahrtabschnitte ist, ist dies der Pfad vom aktuellen Standort des Fahrzeugs zu dieser Haltestelle zu dem Zeitpunkt, als die Haltestelle der Liste hinzugefügt wurde. Dieses Feld ist möglicherweise nicht vorhanden, wenn dieses Pfadsegment Teil von JourneySharingInfo ist.

Wenn dieses Feld im Pfad Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) oder Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) definiert ist, kann es mit den LatLngs gefüllt werden, die aus DeliveryVehicle.current_route_segment (gRPC) oder DeliveryVehicle.currentRouteSegment (REST) decodiert wurden. Hier wird die Fahrstrecke ab dem letzten bekannten Standort der Fahrer-App angegeben, nicht der Pfad von der vorherigen Haltestelle.

VehicleStop

Beschreibt einen Punkt, an dem ein Fahrzeug anhält, um eine oder mehrere Tasks auszuführen.

Felder
planned_location

LocationInfo

Erforderlich. Die Position der Haltestelle. Beachten Sie, dass die Standorte in den Tasks möglicherweise nicht genau mit diesem Standort übereinstimmen, aber nicht weit davon entfernt sind. Dieses Feld wird in der Antwort auf einen GetTask-Aufruf nicht ausgefüllt.

tasks[]

TaskInfo

Die Liste der Tasks, die an dieser Haltestelle ausgeführt werden sollen. Dieses Feld wird in der Antwort auf einen GetTask-Aufruf nicht ausgefüllt.

state

State

Der Status von VehicleStop. Dieses Feld wird in der Antwort auf einen GetTask-Aufruf nicht ausgefüllt.

Status

Der aktuelle Status einer VehicleStop.

Enums
STATE_UNSPECIFIED Unbekannt
NEW Wird erstellt, aber nicht aktiv weitergeleitet.
ENROUTE Zugewiesen und aktiv weitergeleitet.
ARRIVED An der Haltestelle angekommen. Geht davon aus, dass alle vorherigen Haltestellen auf der Route des Fahrzeugs zur nächsten Haltestelle beendet wurden.

TaskInfo

Zusätzliche Informationen zur Aufgabe, die an dieser Haltestelle ausgeführt wurde.

Felder
task_id

string

Die Aufgaben-ID. Dieses Feld wird in der Antwort auf einen GetTask-Aufruf nicht ausgefüllt. Aufgaben-IDs unterliegen den folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Sie ist auf maximal 64 Zeichen beschränkt.
  • Nach der Unicode-Normalisierungsform C normalisiert.
  • Darf keines der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.
task_duration

Duration

Nur Ausgabe. Die zur Ausführung der Aufgabe erforderliche Zeit.

target_time_window

TimeWindow

Nur Ausgabe. Das Zeitfenster, in dem die Aufgabe abgeschlossen werden sollte. Dies wird nur in der Antwort auf GetDeliveryVehicle festgelegt.