Package maps.fleetengine.delivery.v1

Index

DeliveryService

Der Lieferservice für die letzte Meile.

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

Erstellt und gibt eine Reihe neuer Task-Objekte zurück.
CreateDeliveryVehicle

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

Erstellt eine neue DeliveryVehicle und gibt sie zurück.
CreateTask

rpc CreateTask(CreateTaskRequest) returns (Task)

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

rpc DeleteDeliveryVehicle(DeleteDeliveryVehicleRequest) returns (Empty)

Löscht ein DeliveryVehicle aus der Fleet Engine.

Gibt FAILED_PRECONDITION zurück, wenn dem Lieferfahrzeug OFFENE Aufgaben zugewiesen sind.
DeleteTask

rpc DeleteTask(DeleteTaskRequest) returns (Empty)

Löscht eine einzelne Aufgabe.

Gibt FAILED_PRECONDITION zurück, wenn die Aufgabe OFFEN ist und einem Lieferfahrzeug zugewiesen ist.
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)

Alle DeliveryVehicles abrufen, die die angegebenen Filterkriterien erfüllen
ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

Alle Tasks abrufen, die die angegebenen Filterkriterien erfüllen
UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Schreibt aktualisierte DeliveryVehicle-Daten in die Fleet Engine und weist der DeliveryVehicle Tasks zu. Der Name der DeliveryVehicle kann nicht aktualisiert werden. Sie können remaining_vehicle_journey_segments aktualisieren, sie muss jedoch alle VehicleJourneySegments enthalten, die auf der DeliveryVehicle gespeichert werden sollen. Die task_ids werden aus remaining_vehicle_journey_segments abgerufen und die entsprechenden Tasks werden den DeliveryVehicle zugewiesen, falls sie noch nicht zugewiesen wurden.
UpdateTask

rpc UpdateTask(UpdateTaskRequest) returns (Task)

Aktualisiert Task-Daten.

BatchCreateTasksRequest

Die BatchCreateTask-Anfragenachricht.

Felder
header

DeliveryRequestHeader

Optional. Der Standard-Anfrageheader der Delivery API. Hinweis: Wenn Sie dieses Feld festlegen, muss das Header-Feld 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, in der die zu erstellenden Ressourcen angegeben sind. Hinweis: Sie können maximal 500 Aufgaben in einem Batch erstellen.

BatchCreateTasksResponse

Die BatchCreateTask-Antwortnachricht.

Felder
tasks[]

Task

Die erstellten Aufgaben.

CreateDeliveryVehicleRequest

Die CreateDeliveryVehicle-Anfragenachricht.

Felder
header

DeliveryRequestHeader

Optional. Der Standard-Anfrageheader der Delivery API.
parent

string

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

string

Erforderlich. Die ID des Lieferfahrzeugs muss eindeutig sein und unterliegt den folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Ist auf eine maximale Länge von 64 Zeichen beschränkt.
  • Normalisiert gemäß Unicode-Normalisierungsform C.
  • Darf keines der folgenden ASCII-Zeichen enthalten: „/“, „:“, „?“, „,“ oder „#“.
delivery_vehicle

DeliveryVehicle

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

  • Typ
  • last_location
  • Attribute

Hinweis: Das Feld name des Lieferfahrzeugs wird ignoriert. Alle anderen Felder von „DeliveryVehicle“ dürfen nicht festgelegt sein. Andernfalls wird ein Fehler zurückgegeben.

CreateTaskRequest

Die CreateTask-Anfragenachricht.

Felder
header

DeliveryRequestHeader

Optional. Der Standard-Anfrageheader der Delivery API.
parent

string

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

string

Erforderlich. Die Aufgabe muss eine eindeutige ID haben, darf aber keine Sendungs-ID sein. Verwenden Sie das Feld tracking_id, um eine Sendungs-Tracking-ID zu speichern. Mehrere Aufgaben können dieselbe tracking_id haben. Für Aufgaben-IDs gelten die folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Ist auf eine maximale Länge von 64 Zeichen beschränkt.
  • Normalisiert gemäß Unicode-Normalisierungsform C.
  • Darf keines der folgenden ASCII-Zeichen enthalten: „/“, „:“, „?“, „,“ oder „#“.
task

Task

Erforderlich. Die zu erstellende Aufgabe. Beim Erstellen einer Aufgabe sind die folgenden Felder erforderlich:

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

Die folgenden Felder können optional festgelegt werden:

  • target_time_window
  • task_tracking_view_config
  • attributes

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

DeleteDeliveryVehicleRequest

Anfragenachricht für DeleteDeliveryVehicle

Felder
header

DeliveryRequestHeader

Optional. Der Standard-Anfrageheader der Delivery API.
name

string

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

DeleteTaskRequest

DeleteTask-Anfrage

Felder
header

DeliveryRequestHeader

Optional. Der Standard-Anfrageheader der Delivery API.
name

string

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

DeliveryRequestHeader

Ein RequestHeader enthält Felder, die allen Delivery RPC-Anfragen gemeinsam sind.

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. Wenn keine Sprache angegeben ist, kann die Antwort in jeder Sprache erfolgen. Wenn ein Name vorhanden ist, wird Englisch bevorzugt. Beispiel für einen Feldwert: en-US.
region_code

string

Erforderlich. CLDR-Regionscode der Region, aus der die Anfrage stammt. Beispiel für einen 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 anrufende 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 Typ des SDKs, über das die Anfrage gesendet wird.
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 dem das aufrufende SDK abhängt (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, von dem das SDK aufgerufen wird. Gilt nur für Android-SDKs. Beispiel für einen Feldwert: Samsung.
android_api_level

int32

Android-API-Level des aufrufenden SDKs, nur für Android-SDKs gültig. Beispiel für einen Feldwert: 23.
trace_id

string

Optionale ID, die zu Logging-Zwecken zur Identifizierung der Anfrage angegeben werden kann.

Plattform

Die Plattform des aufrufenden SDKs.

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 stammt 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 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.

Felder
name

string

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

DeliveryVehicleLocation

Der zuletzt gemeldete Standort des Lieferfahrzeugs.
past_locations[]

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.
navigation_status

DeliveryVehicleNavigationStatus

Der Navigationsstatus des Lieferfahrzeugs.
current_route_segment

bytes

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 current_route_segment 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 current_route_segment 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.
current_route_segment_end_point

LatLng

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

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

Int32Value

Die verbleibende Fahrstrecke für den current_route_segment. 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 current_route_segment leer ist.
remaining_duration

Duration

Die verbleibende Fahrtzeit für die current_route_segment. 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 Auslieferungsmedium zugewiesen sind.

Die Fleet Engine ignoriert dieses Feld in UpdateDeliveryVehicleRequest, wenn das Feld current_route_segment leer ist.
remaining_vehicle_journey_segments[]

VehicleJourneySegment

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

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

DeliveryVehicleType

Der Typ dieses Lieferfahrzeugs. Wenn dieser Wert nicht 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 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.

DeliveryVehicleAttribute

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

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

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, string_value zu verwenden. Wenn sowohl string_value als auch value festgelegt sind, müssen sie identisch sein, da sonst ein Fehler auftritt. Beide Felder werden in Antworten ausgefüllt.
bool_value

bool

Boolescher Attributwert.
number_value

double

Attributwert mit doppeltem Typ.

DeliveryVehicleLocation

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

Felder
location

LatLng

Der Standort des Fahrzeugs. Wenn die Daten an Fleet Engine gesendet werden, ist der Standort des Fahrzeugs ein GPS-Standort. Wenn Sie diese Informationen in einer Antwort erhalten, kann der Standort des Fahrzeugs entweder ein GPS-Standort, ein ergänzender Standort oder ein anderer geschätzter Standort sein. Die Quelle wird in location_sensor angegeben.
horizontal_accuracy
(deprecated)

DoubleValue

Verworfen. Verwenden Sie stattdessen latlng_accuracy.
latlng_accuracy

DoubleValue

Genauigkeit von location Metern als Radius.
heading

Int32Value

Die Fahrtrichtung des Fahrzeugs in Grad. „0“ steht für Norden. Der gültige Bereich ist [0,360].
bearing_accuracy
(deprecated)

DoubleValue

Verworfen. Verwenden Sie stattdessen heading_accuracy.
heading_accuracy

DoubleValue

Genauigkeit von heading Grad.
altitude

DoubleValue

Höhe in Metern über WGS84.
vertical_accuracy
(deprecated)

DoubleValue

Verworfen. Verwenden Sie stattdessen altitude_accuracy.
altitude_accuracy

DoubleValue

Genauigkeit von altitude Metern.
speed_kmph
(deprecated)

Int32Value

Geschwindigkeit des Fahrzeugs in Kilometern pro Stunde. Verworfen. Verwenden Sie stattdessen speed.
speed

DoubleValue

Geschwindigkeit des Fahrzeugs in Metern pro Sekunde
speed_accuracy

DoubleValue

Genauigkeit von speed in Metern/Sekunde.
update_time

Timestamp

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

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Server die Standortinformationen empfangen hat.
location_sensor

DeliveryVehicleLocationSensor

Anbieter von Standortdaten (z. B. GPS).
is_road_snapped

BoolValue

Gibt an, ob location an einer Straße angedockt 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 der Wert „0“. Wenn die Uhrzeit nicht bekannt ist (z. B. beim Neustart der App), wird dieser Wert auf null zurückgesetzt.
num_stale_updates
(deprecated)

Int32Value

Nur Eingabe. Eingestellt: Es werden jetzt andere Signale verwendet, um zu ermitteln, ob ein Standort veraltet ist.
raw_location

LatLng

Roher Fahrzeugstandort (nicht von RoadSnapper verarbeitet).
raw_location_time

Timestamp

Zeitstempel, der mit dem Rohstandort verknüpft ist.
raw_location_sensor

DeliveryVehicleLocationSensor

Quelle des Rohstandorts. Die Standardeinstellung ist GPS.
raw_location_accuracy

DoubleValue

Genauigkeit von raw_location als Radius in Metern.
supplemental_location

LatLng

Zusätzlicher Standort, der von der integrierten App bereitgestellt wird.
supplemental_location_time

Timestamp

Zeitstempel, der mit dem zusätzlichen Standort verknüpft ist.
supplemental_location_sensor

DeliveryVehicleLocationSensor

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

DoubleValue

Genauigkeit von supplemental_location als Radius in Metern.
road_snapped
(deprecated)

bool

Verworfen. Verwenden Sie stattdessen is_road_snapped.

DeliveryVehicleLocationSensor

Der Sensor oder die Methode, die zur Standortbestimmung verwendet wird.

Enums
UNKNOWN_SENSOR Der Sensor ist nicht angegeben oder unbekannt.
GPS GPS oder unterstütztes GPS
NETWORK Assisted GPS, ID des Mobilfunkmasts oder WLAN-Zugangspunkt
PASSIVE ID des Mobilfunkmasts oder WLAN-Zugangspunkts
ROAD_SNAPPED_LOCATION_PROVIDER Ein Standort, der vom Mobilgerät als wahrscheinlichste Straßenposition bestimmt wird.
CUSTOMER_SUPPLIED_LOCATION Ein vom Kunden angegebener Standort aus einer unabhängigen Quelle. Normalerweise wird dieser Wert für einen Standort verwendet, der aus anderen Quellen als dem Mobilgerät mit Driver SDK bereitgestellt wird. Wenn die ursprüngliche Quelle durch einen der anderen Aufzählungswerte beschrieben wird, verwenden Sie diesen Wert. Standorte mit der Kennzeichnung CUSTOMER_SUPPLIED_LOCATION werden in der Regel über die last_location.supplemental_location_sensor eines Lieferfahrzeugs angegeben.
FLEET_ENGINE_LOCATION Ein Standort, der von der Fleet Engine anhand der verfügbaren Signale berechnet wird. Nur Ausgabe. Dieser Wert wird abgelehnt, wenn er in einer Anfrage empfangen wird.
FUSED_LOCATION_PROVIDER Der Anbieter für kombinierte Standortbestimmung von Android.
CORE_LOCATION Der Standortanbieter unter Apple-Betriebssystemen.

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.

GetDeliveryVehicleRequest

Die GetDeliveryVehicle-Anfragenachricht.

Felder
header

DeliveryRequestHeader

Optional. Der Standard-Anfrageheader der Delivery API.
name

string

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

GetTaskRequest

Die GetTask-Anfragenachricht.

Felder
header

DeliveryRequestHeader

Optional. Der Standard-Anfrageheader der Delivery API.
name

string

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

GetTaskTrackingInfoRequest

Die GetTaskTrackingInfoRequest-Anfragenachricht.

Felder
header

DeliveryRequestHeader

Optional. Der Standard-Anfrageheader der Delivery API.
name

string

Erforderlich. Muss im Format providers/{provider}/taskTrackingInfo/{tracking_id} vorliegen. provider muss die Google Cloud-Projekt-ID und tracking_id die Tracking-ID sein, die mit der Aufgabe verknüpft ist. Ein Beispielname könnte providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id sein.

ListDeliveryVehiclesRequest

Die ListDeliveryVehicles-Anfragenachricht.

Felder
header

DeliveryRequestHeader

Optional. Der Standard-Anfrageheader der Delivery API.
parent

string

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

int32

Optional. Die maximale Anzahl der zurückzugebenden Fahrzeuge. 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 diese 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 angeben oder einen leeren String für den Filter angeben, werden alle Lieferfahrzeuge zurückgegeben.

Für ListDeliveryVehicles werden nur Abfragen zu Fahrzeugattributen unterstützt (z. B. attributes.<key> = <value> oder attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Außerdem werden alle Attribute als Strings gespeichert. Daher sind nur Stringvergleiche zulässig. Damit ein Vergleich mit numerischen oder booleschen Werten möglich ist, 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 ein Teil der Abfrage vom Typ attribute.<KEY> <COMPARATOR> <VALUE>. attributes.foo = bar ist beispielsweise eine Einschränkung.
viewport

Viewport

Optional. Ein Filter, der die zurückgegebenen Fahrzeuge auf diejenigen beschränkt, deren letzter bekannter Standort sich im rechteckigen Bereich befindet, der durch den Darstellungsbereich definiert ist.

ListDeliveryVehiclesResponse

Die ListDeliveryVehicles-Antwortnachricht.

Felder
delivery_vehicles[]

DeliveryVehicle

Die Lieferfahrzeuge, die die angeforderten Filterkriterien erfüllen. Wenn kein Filter angegeben ist, werden in der Anfrage alle Lieferfahrzeuge zurückgegeben. Eine erfolgreiche Antwort kann auch leer sein. Eine leere Antwort gibt an, dass keine Übermittlungsmedien gefunden wurden, die den angeforderten Filterkriterien entsprechen.
next_page_token

string

Du kannst dieses Token in ListDeliveryVehiclesRequest übergeben, um weitere Ergebnisse aufzulisten. 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 Übermittlungsfahrzeuge, die den Anfragekriterien entsprechen, auf allen Seiten.

ListTasksRequest

Die ListTasks-Anfragenachricht.

Felder
header

DeliveryRequestHeader

Optional. Der Standard-Anfrageheader der Delivery API.
parent

string

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

int32

Optional. Die maximale Anzahl der 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. Geben Sie diese an, 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 einer leeren Zeichenfolge 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, werden in der Anfrage alle Aufgaben zurückgegeben. Eine erfolgreiche Antwort kann auch leer sein. Eine leere Antwort gibt an, dass keine Aufgaben gefunden wurden, die den angeforderten Filterkriterien entsprechen.
next_page_token

string

Übergeben Sie dieses Token in ListTasksRequest, um weitere Ergebnisse aufzulisten. Wenn alle Ergebnisse zurückgegeben wurden, ist dieses Feld entweder ein leerer String oder es ist nicht in der Antwort enthalten.
total_size

int64

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

LocationInfo

Ein Standort mit zusätzlichen Kennzeichnungen.

Felder
point

LatLng

Die Koordinaten des Standorts.

Aufgabe

Eine Aufgabe in der Delivery API stellt eine einzelne zu erfassende Aktion dar. Im Allgemeinen wird zwischen versandbezogenen Aufgaben und Pausenaufgaben unterschieden. Einem Versand können mehrere Aufgaben zugeordnet sein. So kann es beispielsweise eine Aufgabe für die Abholung und eine für die Rückgabe oder den Transport geben. Außerdem können verschiedene Aufgaben für eine bestimmte Sendung von verschiedenen Fahrzeugen ausgeführt werden. So kann beispielsweise ein Fahrzeug die Abholung übernehmen und die Sendung zum Hub fahren, während ein anderes Fahrzeug dieselbe Sendung vom Hub zum Abgabeort fährt.

Hinweis: gRPC- und REST-APIs verwenden unterschiedliche Feldbenennungskonventionen. Beispiel: Das Feld Task.journey_sharing_info in der gRPC API und das Feld Task.journeySharingInfo in der REST API beziehen sich auf dasselbe Feld.

Felder
name

string

Muss im Format providers/{provider}/tasks/{task} vorliegen.
type

Type

Erforderlich. Nicht veränderbar. Definiert den Typ der Aufgabe. Beispiel: Pause oder 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 Speicherort, an dem das Ergebnis der Task festgelegt wurde. Dieser Wert wird im Rahmen von UpdateTask aktualisiert. Wenn dieser Wert nicht explizit vom Anbieter aktualisiert wird, wird er in der Fleet Engine standardmäßig mit dem letzten bekannten Fahrzeugstandort (der rohen Position) ausgefüllt.
task_outcome_location_source

TaskOutcomeLocationSource

Gibt an, woher der Wert der task_outcome_location stammt.
tracking_id

string

Nicht veränderbar. Dieses Feld erleichtert das Speichern einer ID, sodass Sie keine komplizierte Zuordnung verwenden müssen. Sie können tracking_id nicht für Aufgaben vom Typ UNAVAILABLE und SCHEDULED_STOP festlegen. Für diese IDs gelten die folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Ist auf eine maximale Länge von 64 Zeichen beschränkt.
  • Normalisiert gemäß Unicode-Normalisierungsform C.
  • Darf keines der folgenden ASCII-Zeichen enthalten: „/“, „:“, „?“, „,“ oder „#“.
delivery_vehicle_id

string

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

  • Muss ein gültiger Unicode-String sein.
  • Ist auf eine maximale Länge von 64 Zeichen beschränkt.
  • Normalisiert gemäß Unicode-Normalisierungsform C.
  • Darf keines der folgenden ASCII-Zeichen enthalten: „/“, „:“, „?“, „,“ oder „#“.
planned_location

LocationInfo

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

Duration

Erforderlich. Nicht veränderbar. Die Zeit, die für die Ausführung einer Aufgabe an diesem Standort benötigt wird.
target_time_window

TimeWindow

Das Zeitfenster, in dem die Aufgabe erledigt werden soll.
journey_sharing_info

JourneySharingInfo

Nur Ausgabe. Felder, die speziell für die Freigabe von Reisedaten gelten. Wird nicht ausgefüllt, wenn der Status CLOSED ist.
task_tracking_view_config

TaskTrackingViewConfig

Die Konfiguration für die Aufgabenverfolgung, in der angegeben wird, welche Datenelemente für Endnutzer unter welchen Umständen sichtbar sind.
attributes[]

TaskAttribute

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

JourneySharingInfo

Bestimmte Felder für die Freigabe von Informationen zur Kaufentscheidung

Felder
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Informationen zur Verfolgung der Haltestellen, die das zugewiesene Fahrzeug anfährt, bevor es diese Aufgabe abschließt. Diese Liste kann Haltestellen aus anderen Aufgaben enthalten.

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 bis zum nächsten VehicleStop. Aktuelle Routeninformationen stammen in der Regel von der Fahrer-App, mit Ausnahme einiger Fälle, die in der Dokumentation für 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 der Fleet Engine ausgefüllt. Sie liefern Routeninformationen zwischen den verbleibenden VehicleStops.
last_location

DeliveryVehicleLocation

Der zuletzt gemeldete Standort des zugewiesenen Fahrzeugs.
last_location_snappable

bool

Gibt an, ob der letzte Standort des Fahrzeugs an die current_route_segment angedockt werden kann. Dieser Wert ist „False“, wenn entweder last_location oder current_route_segment nicht vorhanden ist. Dieser Wert wird von der Fleet Engine berechnet. Updates von Kunden werden ignoriert.

Status

Der Status einer Aufgabe. Dies gibt Aufschluss über den Fortschritt der Aufgaben.

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 von Task noch nicht passiert.
CLOSED Wenn das Fahrzeug die Haltestelle für diese Aufgabe passiert.

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 erfolgreich abgeschlossen.
FAILED Die Aufgabe konnte entweder nicht abgeschlossen oder abgebrochen werden.

TaskOutcomeLocationSource

Die Identität der Quelle, aus der die task_outcome_location stammen.

Enums
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED Das Aufgabenergebnis, bevor es festgelegt wird.
PROVIDER Der Anbieter hat die task_outcome_location angegeben.
LAST_VEHICLE_LOCATION Der Anbieter hat die task_outcome_location nicht angegeben. Daher wurde in Fleet Engine der zuletzt bekannte Fahrzeugstandort verwendet.

Typ

Der Aufgabentyp.

Enums
TYPE_UNSPECIFIED Standardmäßig ist der Aufgabentyp unbekannt.
PICKUP Eine Abholaufgabe ist die Aktion, die für die Abholung einer Sendung bei einem Kunden ausgeführt wird. Für die Abholung von Fahrzeugen im Depot oder in einem Zubringer sollte der Typ SCHEDULED_STOP verwendet werden.
DELIVERY Eine Zustellaufgabe ist die Aktion, die für die Zustellung einer Sendung an einen Endkunden ausgeführt wird. Für Depot- oder Zubringer-Fahrzeugabgabestellen sollte der Typ SCHEDULED_STOP verwendet werden.
SCHEDULED_STOP Eine geplante Aufgabe für Haltestellen wird zu Planungszwecken verwendet. Das kann beispielsweise die Abholung oder Abgabe von Sendungen von Zubringerfahrzeugen oder Depots sein. Sie sollte nicht für Sendungen verwendet werden, die von einem Endkunden abgeholt oder abgegeben werden.
UNAVAILABLE Eine Aufgabe, die bedeutet, dass das Fahrzeug nicht für den Service verfügbar ist. Das kann beispielsweise passieren, wenn der Fahrer eine Pause macht oder das Fahrzeug betankt wird.

TaskAttribute

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

Felder
key

string

Der Schlüssel des Attributs. Schlüssel dürfen das Doppelpunktzeichen (:) nicht enthalten.
Union-Feld task_attribute_value. Der Wert des Attributs kann vom Typ „String“, „Boole“ oder „Doppelt“ sein. Wenn keine festgelegt sind, wird der Stringwert „string_value“ des TaskAttributes als leerer String „"" gespeichert. task_attribute_value kann nur einen der folgenden Werte haben:
string_value

string

Attributwert vom Typ „String“.
bool_value

bool

Boolescher Attributwert.
number_value

double

Attributwert mit doppeltem Typ.

TaskTrackingInfo

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

Felder
name

string

Muss im Format providers/{provider}/taskTrackingInfo/{tracking} vorliegen, wobei tracking die Tracking-ID ist.
tracking_id

string

Nicht veränderbar. Die Tracking-ID einer Aufgabe. * Muss ein gültiger Unicode-String sein. * Begrenzt auf eine maximale Länge von 64 Zeichen. * Normalisiert gemäß Unicode-Normalisierungsform C. * 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 verbunden eine Polylinie der voraussichtlichen Route des Fahrzeugs zum Standort dieser Aufgabe bilden.
remaining_stop_count

Int32Value

Gibt die Anzahl der Haltestellen an, die das Fahrzeug bis zur Aufgabe noch hat, einschließlich der Aufgabe. Wenn die nächste Haltestelle des Fahrzeugs beispielsweise die Haltestelle der Aufgabe ist, ist der Wert „1“.
remaining_driving_distance_meters

Int32Value

Die verbleibende Gesamtstrecke in Metern bis zum gewünschten VehicleStop.
estimated_arrival_time

Timestamp

Der Zeitstempel, der die geschätzte Ankunftszeit an der Haltestelle angibt.
estimated_task_completion_time

Timestamp

Der Zeitstempel, der den geschätzten Abschlusszeitpunkt 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 abgeschlossen wird.
target_time_window

TimeWindow

Das Zeitfenster, in dem die Aufgabe erledigt werden soll.
attributes[]

TaskAttribute

Die für die Aufgabe festgelegten benutzerdefinierten Attribute.

TaskTrackingViewConfig

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

Felder
route_polyline_points_visibility

VisibilityOption

In diesem Feld wird angegeben, wann Polylinienpunkte einer Route sichtbar sein können. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration für die Sichtbarkeit auf Projektebene für diese Daten verwendet.
estimated_arrival_time_visibility

VisibilityOption

Das Feld, in dem festgelegt wird, wann die voraussichtliche Ankunftszeit sichtbar sein kann. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration für die Sichtbarkeit auf Projektebene für diese Daten verwendet.
estimated_task_completion_time_visibility

VisibilityOption

Das Feld, in dem angegeben wird, wann die geschätzte Zeit für die Erledigung der Aufgabe sichtbar sein kann. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration für die Sichtbarkeit auf Projektebene für diese Daten verwendet.
remaining_driving_distance_visibility

VisibilityOption

Das Feld, in dem angegeben wird, wann die verbleibende Fahrstrecke sichtbar sein kann. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration für die Sichtbarkeit auf Projektebene für diese Daten verwendet.
remaining_stop_count_visibility

VisibilityOption

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

VisibilityOption

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

VisibilityOption

Die Option, mit der festgelegt wird, 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 verbleibende Anzahl der Haltestellen <= remaining_stop_count_threshold ist.
duration_until_estimated_arrival_time_threshold

Duration

Dieses Datenelement ist für Endnutzer sichtbar, wenn die geschätzte Ankunftszeit an der Haltestelle <= duration_until_estimated_arrival_time_threshold ist.
remaining_driving_distance_meters_threshold

int32

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

bool

Wenn diese Option auf „wahr“ gesetzt ist, ist dieses Datenelement für Endnutzer immer ohne Grenzwerte sichtbar. Dieses Feld kann nicht auf „false“ gesetzt werden.
never

bool

Wenn diese Option auf „wahr“ gesetzt ist, wird dieses Datenelement den Endnutzern immer ohne Grenzwerte ausgeblendet. Dieses Feld kann nicht auf „false“ gesetzt werden.

TimeWindow

Einen Zeitraum.

Felder
start_time

Timestamp

Erforderlich. Der Beginn des Zeitfensters (einschließlich).
end_time

Timestamp

Erforderlich. Das Ende des Zeitfensters (einschließlich).

UpdateDeliveryVehicleRequest

Die UpdateDeliveryVehicle-Anfragenachricht.

Felder
header

DeliveryRequestHeader

Optional. Der Standard-Anfrageheader der Delivery API.
delivery_vehicle

DeliveryVehicle

Erforderlich. Das anzuwendende DeliveryVehicle-Entitätsupdate. Hinweis: Der Name der DeliveryVehicle kann nicht aktualisiert werden.
update_mask

FieldMask

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

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

UpdateTaskRequest

Die UpdateTask-Anfragenachricht.

Felder
header

DeliveryRequestHeader

Optional. Der Standard-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: Der Wert von task_outcome kann nach der Festlegung nicht mehr geändert werden.

Wenn die Aufgabe einem Lieferfahrzeug zugewiesen wurde, setzen Sie den Aufgabenstatus nicht mit Task.update auf „GELÖST“. Entfernen Sie stattdessen die VehicleStop, die die Aufgabe enthält, aus dem Übermittlungsmedium. Dadurch wird der Aufgabenstatus automatisch auf „GELÖST“ gesetzt.
update_mask

FieldMask

Erforderlich. Die Feldmaske, die angibt, welche Aufgabenfelder aktualisiert werden sollen. Hinweis: Die 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

Stellt das Fahrtsegment eines Fahrzeugs dar – von der vorherigen Haltestelle bis zur aktuellen Haltestelle. Wenn es sich um die erste aktive Haltestelle handelt, ist es der Weg vom aktuellen Standort des Fahrzeugs zu dieser Haltestelle.

Felder
stop

VehicleStop

Gibt den Standort der Haltestelle sowie die mit der Haltestelle verknüpften Task an. Einige Felder des „VehicleStop“ sind möglicherweise nicht vorhanden, wenn dieses Fahrtsegment zu JourneySharingInfo gehört.
driving_distance_meters

Int32Value

Nur Ausgabe. Die Fahrstrecke 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 zum Zeitpunkt der Aufnahme dieser Haltestelle in die Liste erfasst wurde. Dieses Feld ist möglicherweise nicht vorhanden, wenn dieses Navigationssegment 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 Fahrtsegmente ist, ist der Startpunkt der Standort des Fahrzeugs, der zum Zeitpunkt der Aufnahme dieser Haltestelle in die Liste erfasst 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) ausgefüllt werden. Hier sehen Sie die verbleibende Fahrdauer ab dem letzten bekannten Standort der Fahrer App, nicht die Fahrzeit ab der vorherigen Haltestelle.
path[]

LatLng

Nur Ausgabe. Der Weg von der vorherigen Haltestelle zu dieser Haltestelle. Wenn die aktuelle Haltestelle die erste Haltestelle in der Liste der Fahrtsegmente ist, ist dies der Weg vom aktuellen Standort des Fahrzeugs zu dieser Haltestelle zum Zeitpunkt, als die Haltestelle der Liste hinzugefügt wurde. Dieses Feld ist möglicherweise nicht vorhanden, wenn dieses Navigationssegment 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 ausgefüllt werden, die aus DeliveryVehicle.current_route_segment (gRPC) oder DeliveryVehicle.currentRouteSegment (REST) decodiert wurden. Dies liefert den Fahrweg vom letzten bekannten Standort der Fahrer-App anstelle des Pfads von der vorherigen Haltestelle.

VehicleStop

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

Felder
planned_location

LocationInfo

Erforderlich. Der Standort der Haltestelle. Die Standorte in den Tasks stimmen möglicherweise nicht genau mit diesem Standort überein, befinden sich aber in unmittelbarer Nähe. Dieses Feld wird in der Antwort eines GetTask-Aufrufs nicht ausgefüllt.
tasks[]

TaskInfo

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

State

Der Status von VehicleStop. Dieses Feld wird in der Antwort eines GetTask-Aufrufs nicht ausgefüllt.

Status

Der aktuelle Status einer VehicleStop.

Enums
STATE_UNSPECIFIED Unbekannt
NEW Erstellt, aber nicht aktiv geroutet.
ENROUTE Zugewiesen und aktiv geroutet.
ARRIVED Angekommen an der Haltestelle. Es wird davon ausgegangen, dass alle vorherigen Haltestellen bereits angefahren wurden, wenn das Fahrzeug zur nächsten Haltestelle fährt.

TaskInfo

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

Felder
task_id

string

Die Aufgaben-ID. Dieses Feld wird in der Antwort eines GetTask-Aufrufs nicht ausgefüllt. Für Aufgaben-IDs gelten die folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Ist auf eine maximale Länge von 64 Zeichen beschränkt.
  • Normalisiert gemäß Unicode-Normalisierungsform C.
  • Darf keines der folgenden ASCII-Zeichen enthalten: „/“, „:“, „?“, „,“ oder „#“.
task_duration

Duration

Nur Ausgabe. Die Zeit, die für die Ausführung der Aufgabe erforderlich ist.
target_time_window

TimeWindow

Nur Ausgabe. Das Zeitfenster, in dem die Aufgabe erledigt werden soll. Dieser Wert wird nur in der Antwort auf GetDeliveryVehicle festgelegt.