Package maps.fleetengine.delivery.v1

Indeks

DeliveryService

Dostawa last Mile Delivery.

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

Tworzy i zwraca grupę nowych obiektów Task.

CreateDeliveryVehicle

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

Tworzy i zwraca nowy element DeliveryVehicle.

CreateTask

rpc CreateTask(CreateTaskRequest) returns (Task)

Tworzy i zwraca nowy obiekt Task.

GetDeliveryVehicle

rpc GetDeliveryVehicle(GetDeliveryVehicleRequest) returns (DeliveryVehicle)

Zwraca podaną instancję DeliveryVehicle.

GetTask

rpc GetTask(GetTaskRequest) returns (Task)

Pobiera informacje o: Task.

GetTaskTrackingInfo

rpc GetTaskTrackingInfo(GetTaskTrackingInfoRequest) returns (TaskTrackingInfo)

Zwraca podaną instancję TaskTrackingInfo.

ListDeliveryVehicles

rpc ListDeliveryVehicles(ListDeliveryVehiclesRequest) returns (ListDeliveryVehiclesResponse)

Pobiera wszystkie elementy typu DeliveryVehicle, które spełniają określone kryteria filtrowania.

ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

Pobiera wszystkie elementy typu Task, które spełniają określone kryteria filtrowania.

UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Zapisuje zaktualizowane dane DeliveryVehicle we Fleet Engine i przypisuje Tasks do funkcji DeliveryVehicle. Nie można zaktualizować nazwy elementu DeliveryVehicle. Możesz zaktualizować zasób remaining_vehicle_journey_segments, ale musi on zawierać wszystkie VehicleJourneySegment, aby zachować je w DeliveryVehicle. Elementy typu task_id są pobierane z elementu remaining_vehicle_journey_segments, a odpowiadające im Tasks są przypisywane do elementu DeliveryVehicle, jeśli nie zostały jeszcze przypisane.

UpdateTask

rpc UpdateTask(UpdateTaskRequest) returns (Task)

Aktualizuje dane: Task.

BatchCreateTasksRequest

Wiadomość z prośbą BatchCreateTask.

Pola
header

DeliveryRequestHeader

Opcjonalnie: Standardowy nagłówek żądania do interfejsu Delivery API. Uwaga: jeśli ustawisz to pole, pole nagłówka w wiadomościach CreateTaskRequest musi być puste lub pasować do tego pola.

parent

string

Wymagane. Zasób nadrzędny udostępniany przez wszystkie zadania. Wartość musi mieć format providers/{provider}. provider musi być identyfikatorem projektu Google Cloud. Na przykład: sample-cloud-project. Pole nadrzędne w wiadomościach CreateTaskRequest musi być puste lub pasować do tego pola.

requests[]

CreateTaskRequest

Wymagane. Komunikat żądania określający zasoby do utworzenia. Uwaga: w grupie możesz utworzyć maksymalnie 500 zadań.

BatchCreateTasksResponse

Komunikat z odpowiedzią BatchCreateTask.

Pola
tasks[]

Task

utworzone zadania.

CreateDeliveryVehicleRequest

Wiadomość z prośbą CreateDeliveryVehicle.

Pola
header

DeliveryRequestHeader

Opcjonalnie: Standardowy nagłówek żądania do interfejsu Delivery API.

parent

string

Wymagane. Musi mieć format providers/{provider}. Dostawcą musi być identyfikator projektu Google Cloud. Na przykład: sample-cloud-project.

delivery_vehicle_id

string

Wymagane. Identyfikator pojazdu dostarczanego na potrzeby dostawy musi być niepowtarzalny i podlega tym ograniczeniom:

  • Musi być prawidłowym ciągiem znaków Unicode.
  • Może mieć maksymalnie 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
delivery_vehicle

DeliveryVehicle

Wymagane. Element DeliveryVehicle do utworzenia. Podczas tworzenia nowego pojazdu dostawy możesz skonfigurować te pola opcjonalne:

  • typ
  • last_location
  • atrybuty

Uwaga: pole name w przypadku dostawy pojazdu jest ignorowane. W pozostałych polach nie można podawać wartości DeliveryProduct. w przeciwnym razie zwracany jest błąd.

CreateTaskRequest

Wiadomość z prośbą CreateTask.

Pola
header

DeliveryRequestHeader

Opcjonalnie: Standardowy nagłówek żądania do interfejsu Delivery API.

parent

string

Wymagane. Musi mieć format providers/{provider}. provider musi być identyfikatorem projektu Google Cloud. Na przykład: sample-cloud-project.

task_id

string

Wymagane. Identyfikator zadania musi być unikalny, ale nie powinien być identyfikatorem śledzenia przesyłki. Aby przechowywać identyfikator śledzenia przesyłki, użyj pola tracking_id. Pamiętaj, że do tego samego elementu tracking_id może należeć kilka zadań. Identyfikatory zadań podlegają tym ograniczeniom:

  • Musi być prawidłowym ciągiem znaków Unicode.
  • Może mieć maksymalnie 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
task

Task

Wymagane. Encja Task, która ma zostać utworzona. Podczas tworzenia zadania musisz wypełnić te pola:

  • type
  • state (musi mieć wartość OPEN)
  • tracking_id (nie może być ustawiony dla zadań UNAVAILABLE ani SCHEDULED_STOP, ale jest wymagany w przypadku wszystkich innych typów zadań)
  • planned_location (opcjonalny w przypadku UNAVAILABLE zadań)
  • task_duration

Uwaga: pole name zadania jest ignorowane. Żadne inne pola Zadania nie mogą być ustawione. w przeciwnym razie zwracany jest błąd.

DeliveryRequestHeader

Pole RequestHeader zawiera pola wspólne dla wszystkich żądań RPC wyświetlania.

Pola
language_code

string

Kod języka BCP-47, np. en-US lub sr-Latn. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jeśli nie podasz żadnej wartości, odpowiedź może być w dowolnym języku, a preferowany jest język angielski, o ile taka nazwa istnieje. Przykład wartości pola: en-US.

region_code

string

Wymagane. Kod regionu CLDR regionu, z którego pochodzi żądanie. Przykład wartości pola: US.

sdk_version

string

Wersja pakietu SDK wywołującego (jeśli dotyczy). Format wersji to „major.minor.patch”, np. 1.1.2.

os_version

string

Wersja systemu operacyjnego, w którym działa pakiet SDK wywołujący. Przykłady wartości pól: 4.4.1, 12.1.

device_model

string

Model urządzenia, na którym działa pakiet SDK wywołujący. Przykłady wartości pól: iPhone12,1, SM-G920F.

sdk_type

SdkType

Typ pakietu SDK, który wysyła żądanie.

maps_sdk_version

string

Wersja pakietu SDK MapSDK, od której zależy wywoływany pakiet SDK (w stosownych przypadkach). Format wersji to „major.minor.patch”, np. 5.2.1.

nav_sdk_version

string

Wersja pakietu NavSDK, od której zależy wywoływany pakiet SDK (w stosownych przypadkach). Format wersji to „major.minor.patch”, np. 2.1.0.

platform

Platform

Platforma pakietu SDK wywołującego.

manufacturer

string

Producent urządzenia z Androidem z pakietu SDK wywołującego. Dotyczy tylko pakietów Android SDK. Przykład wartości pola: Samsung.

android_api_level

int32

Poziom interfejsu API Androida wywołującego pakiet SDK, dotyczy tylko pakietów Android SDK. Przykład wartości pola: 23.

trace_id

string

Opcjonalny identyfikator, który można podać do celów logowania i zidentyfikować żądanie.

Platforma

Platforma wywołującego pakietu SDK.

Wartości w polu enum
PLATFORM_UNSPECIFIED Wartość domyślna. Ta wartość jest używana w przypadku pominięcia platformy.
ANDROID Prośba pochodzi z Androida.
IOS Prośba pochodzi z iOS.
WEB Żądanie pochodzi z internetu.

SdkType

Możliwe typy pakietu SDK.

Wartości w polu enum
SDK_TYPE_UNSPECIFIED Wartość domyślna. Ta wartość jest używana, jeśli pominiesz właściwość sdk_type.
CONSUMER Pakiet SDK wywołujący to wersja konsumenta.
DRIVER Wywołujący pakiet SDK to sterownik.
JAVASCRIPT Wywoływanie SDK to JavaScript.

DeliveryVehicle

Wiadomość DeliveryVehicle. Pojazd transportowy służy do transportu przesyłek z zajmu do miejsca dostawy oraz z miejsca odbioru do magazynu. W niektórych przypadkach pojazdy dostawcze transportują też przesyłki bezpośrednio z miejsca odbioru do miejsca dostawy.

Uwaga: interfejsy API gRPC i REST używają różnych konwencji nazewnictwa pól. Na przykład pole DeliveryVehicle.current_route_segment w interfejsie gRPC API i pole DeliveryVehicle.currentRouteSegment w interfejsie API REST odnoszą się do tego samego pola.

Pola
name

string

Niepowtarzalna nazwa tego pojazdu dostawczego. Format to providers/{provider}/deliveryVehicles/{vehicle}.

last_location

DeliveryVehicleLocation

Ostatnia zgłoszona lokalizacja pojazdu dostawy.

navigation_status

DeliveryVehicleNavigationStatus

Stan nawigacji pojazdu dostawy.

current_route_segment

bytes

Zakodowana linia łamana określająca trasę, którą według nawigacji zaleca przejście do następnego punktu pośredniego. Aplikacja kierowcy aktualizuje te dane po dotarciu do przystanku lub po jego upływie oraz po zmianie trasy przez nawigację. Te LatLng są zwracane w zasadzie Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) lub Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) w przypadku wszystkich aktywnych zadań przypisanych do pojazdu.

Jest kilka sytuacji, w których to pole może nie być używane do wypełniania funkcji Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) lub Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

  • Punkt końcowy instancji current_route_segment nie pasuje do typu DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) ani DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

  • Aplikacja sterownika nie aktualizowała ostatnio swojej lokalizacji, więc ostatnia zaktualizowana wartość tego pola może być nieaktualna.

  • Aplikacja kierowcy niedawno zaktualizowała swoją lokalizację, ale aplikacja current_route_segment jest nieaktualna i wskazuje poprzedni przystanek.

W takich przypadkach Fleet Engine wypełnia to pole trasą z ostatniego przekazanego VehicleStop do następnego elementu VehicleStop, aby mieć pewność, że klient z tego pola ma najdokładniejsze dostępne informacje o bieżącej ścieżce pojazdu dostarczanego.

current_route_segment_end_point

LatLng

Lokalizacja, w której kończy się current_route_segment. Te informacje nie są obecnie wypełniane przez aplikację kierowcy, ale możesz je podać w wywołaniach UpdateDeliveryVehicle. To LatLng ze najbliższego przystanku pojazdu lub ostatni LatLng z current_route_segment. Fleet Engine podejmie wówczas wszelkie możliwe działania, aby dokonać interpolacji na rzeczywistą wartość VehicleStop.

Jeśli pole current_route_segment jest puste, to pole jest ignorowane w wywołaniach funkcji UpdateDeliveryVehicle.

remaining_distance_meters

Int32Value

Pozostały dystans jazdy samochodem przez current_route_segment. Zwykle aplikacja Driver udostępnia to pole, ale w pewnych okolicznościach Fleet Engine zastępuje wartość wysłaną przez aplikację. Więcej informacji: DeliveryVehicle.current_route_segment. To pole jest zwracane w zasadzie Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) lub Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) w przypadku wszystkich aktywnych zasobów typu Task przypisanych do pojazdu dostawczego.

Fleet Engine ignoruje to pole w UpdateDeliveryVehicleRequest, jeśli pole current_route_segment jest puste.

remaining_duration

Duration

Pozostały czas jazdy samochodem current_route_segment. Zwykle aplikacja Driver udostępnia to pole, ale w pewnych okolicznościach Fleet Engine zastępuje wartość wysłaną przez aplikację. Więcej informacji: DeliveryVehicle.current_route_segment. To pole jest zwracane w metodzie Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) lub Task.remainingVehicleJourneySegments[0].drivingDuration (REST) w przypadku wszystkich aktywnych zadań przypisanych do pojazdu dostawczego.

Fleet Engine ignoruje to pole w UpdateDeliveryVehicleRequest, jeśli pole current_route_segment jest puste.

remaining_vehicle_journey_segments[]

VehicleJourneySegment

Segmenty podróży przypisane do tego pojazdu dostawczego, zaczynając od ostatnio zgłoszonej lokalizacji pojazdu. To pole nie zostanie wypełnione w odpowiedzi na żądanie ListDeliveryVehicles.

attributes[]

DeliveryVehicleAttribute

Lista niestandardowych atrybutów pojazdu dostawy. Pojazd może mieć maksymalnie 100 atrybutów, a każdy z nich musi mieć unikalny klucz.

type

DeliveryVehicleType

Typ tego pojazdu dostawy. Jeśli nie są ustawione, domyślna wartość to AUTO.

DeliveryVehicleType

Typ pojazdu dostawy.

Wartości w polu enum
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Wartość nie jest używana.
AUTO Samochód.
TWO_WHEELER Motocykl, motorower lub inny pojazd dwukołowy
BICYCLE Transport napędzany przez człowieka.
PEDESTRIAN Osobisty środek transportu, zwykle pieszo lub biegnący po ścieżkach.

DeliveryVehicleAttribute

Opisuje atrybut pojazdu w postaci pary klucz-wartość. Pole „klucz:wartość” Długość ciągu znaków nie może przekraczać 256 znaków.

Pola
key

string

Klucz atrybutu.

value

string

Wartość atrybutu.

Pole sumy delivery_vehicle_attribute_value. Wartość atrybutu może być ciągiem znaków, wartością logiczną lub liczbą zmiennoprzecinkową. delivery_vehicle_attribute_value może mieć tylko jedną z tych wartości:
string_value

string

Wartość atrybutu z ciągiem znaków.

Uwaga: działa tak samo jak pole value, które z czasem zostanie wycofane. Do tworzenia i aktualizacji danych możesz użyć dowolnego z tych pól, ale zdecydowanie zalecamy użycie string_value. Jeśli ustawione są zarówno wartości string_value, jak i value, muszą one być identyczne, w przeciwnym razie wystąpi błąd. Oba pola są wypełniane w odpowiedziach.

bool_value

bool

Wartość atrybutu wpisanego z użyciem wartości logicznej.

number_value

double

Wartość atrybutu została wpisana dwukrotnie.

DeliveryVehicleLocation

lokalizacja, prędkość i kierunek pojazdu w określonym czasie;

Pola
location

LatLng

Lokalizacja pojazdu. Gdy jest on wysyłany do Fleet Engine, lokalizacją pojazdu jest lokalizacja GPS. Po otrzymaniu odpowiedzi możesz określić lokalizację pojazdu na podstawie GPS-u, dodatkową lokalizację lub inną orientacyjną lokalizację. Źródło jest określone w polu location_sensor.

horizontal_accuracy
(deprecated)

DoubleValue

Wycofane: użyj atrybutu latlng_accuracy.

latlng_accuracy

DoubleValue

Dokładność promienia location w metrach.

heading

Int32Value

Kierunek, w którym pojazd porusza się w stopniach. 0 oznacza północ. Prawidłowy zakres to [0,360).

bearing_accuracy
(deprecated)

DoubleValue

Wycofane: użyj atrybutu heading_accuracy.

heading_accuracy

DoubleValue

Dokładność: heading w stopniach.

altitude

DoubleValue

Wysokość w metrach nad WGS84.

vertical_accuracy
(deprecated)

DoubleValue

Wycofane: użyj atrybutu altitude_accuracy.

altitude_accuracy

DoubleValue

Dokładność: altitude w metrach.

speed_kmph
(deprecated)

Int32Value

Prędkość pojazdu w kilometrach na godzinę. Wycofane: użyj atrybutu speed.

speed

DoubleValue

Prędkość pojazdu w metrach/s

speed_accuracy

DoubleValue

Dokładność speed w metrach/s.

update_time

Timestamp

Godzina, o której czujnik (location) został zgłoszony przez czujnik, zgodnie z jego zegarem.

server_time

Timestamp

Tylko dane wyjściowe. Czas otrzymania przez serwer informacji o lokalizacji.

location_sensor

DeliveryVehicleLocationSensor

Dostawca danych o lokalizacji (np. GPS).

is_road_snapped

BoolValue

Określa, czy obiekt location jest przyciągnięty do drogi.

is_gps_sensor_enabled

BoolValue

Tylko dane wejściowe. Wskazuje, czy czujnik GPS jest włączony w urządzeniu mobilnym.

time_since_update

Int32Value

Tylko dane wejściowe. Czas (w sekundach) od momentu wysłania tej lokalizacji do serwera po raz pierwszy. Przy pierwszej aktualizacji będzie to zero. Jeśli czas jest nieznany (na przykład po ponownym uruchomieniu aplikacji), ta wartość jest resetowana do 0.

num_stale_updates
(deprecated)

Int32Value

Tylko dane wejściowe. Wycofane: do określenia, czy lokalizacja jest nieaktualna, używane są teraz inne sygnały.

raw_location

LatLng

Nieprzetworzona lokalizacja pojazdu (nieprzetworzona przez narzędzie do wykrywania dróg).

raw_location_time

Timestamp

Sygnatura czasowa powiązana z nieprzetworzoną lokalizacją.

raw_location_sensor

DeliveryVehicleLocationSensor

Źródło nieprzetworzonej lokalizacji. Domyślna wartość to GPS.

raw_location_accuracy

DoubleValue

Dokładność raw_location w postaci promienia w metrach.

supplemental_location

LatLng

Dodatkowa lokalizacja udostępniana przez aplikację integracyjną.

supplemental_location_time

Timestamp

Sygnatura czasowa powiązana z dodatkową lokalizacją.

supplemental_location_sensor

DeliveryVehicleLocationSensor

Źródło dodatkowej lokalizacji. Domyślna wartość to CUSTOMER_SUPPLIED_LOCATION.

supplemental_location_accuracy

DoubleValue

Dokładność supplemental_location w postaci promienia w metrach.

road_snapped
(deprecated)

bool

Wycofane: użyj atrybutu is_road_snapped.

DeliveryVehicleLocationSensor

Czujnik lub metodologia używana do określenia lokalizacji.

Wartości w polu enum
UNKNOWN_SENSOR Czujnik jest nieokreślony lub nieznany.
GPS GPS lub Wspomagany GPS.
NETWORK Wspomagany GPS, identyfikator stacji bazowej sieci komórkowej lub punkt dostępu Wi-Fi.
PASSIVE Identyfikator stacji bazowej sieci komórkowej lub punkt dostępu Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Lokalizacja określona przez urządzenie mobilne jako najbardziej prawdopodobna lokalizacja drogi.
CUSTOMER_SUPPLIED_LOCATION Lokalizacja podana przez klienta z niezależnego źródła. Zwykle ta wartość jest używana w przypadku lokalizacji podanej ze źródeł innych niż urządzenie mobilne z pakietem Driver SDK. Jeśli oryginalne źródło jest opisane za pomocą jednej z pozostałych wartości wyliczeniowych, użyj tej wartości. Lokalizacje oznaczone jako CUSTOMER_SUPPLIED_LOCATION są zwykle dostarczane przez last_location.supplemental_location_sensor dostawy pojazdów.
FLEET_ENGINE_LOCATION Lokalizacja obliczana przez Fleet Engine na podstawie dostępnych dla niej sygnałów. Tylko dane wyjściowe. Ta wartość zostanie odrzucona, jeśli otrzyma ją w żądaniu.
FUSED_LOCATION_PROVIDER Dostawca uśrednionej lokalizacji na Androidzie.
CORE_LOCATION Dostawca lokalizacji w systemach operacyjnych Apple.

DeliveryVehicleNavigationStatus

Stan nawigacji pojazdu.

Wartości w polu enum
UNKNOWN_NAVIGATION_STATUS Nieokreślony stan nawigacji.
NO_GUIDANCE Nawigacja w aplikacji Kierowca jest w trybie FREE_NAV.
ENROUTE_TO_DESTINATION Dostępna jest szczegółowa nawigacja, a nawigacja w aplikacji Kierowca została przełączona w tryb GUIDED_NAV.
OFF_ROUTE Pojazd zjechał z sugerowanej trasy.
ARRIVED_AT_DESTINATION Pojazd znajduje się w odległości około 50 m od miejsca docelowego.

GetDeliveryVehicleRequest

Wiadomość z prośbą GetDeliveryVehicle.

Pola
header

DeliveryRequestHeader

Opcjonalnie: Standardowy nagłówek żądania do interfejsu Delivery API.

name

string

Wymagane. Musi mieć format providers/{provider}/deliveryVehicles/{delivery_vehicle}. provider musi być identyfikatorem projektu Google Cloud. Na przykład: sample-cloud-project.

GetTaskRequest

Wiadomość z prośbą GetTask.

Pola
header

DeliveryRequestHeader

Opcjonalnie: Standardowy nagłówek żądania do interfejsu Delivery API.

name

string

Wymagane. Musi mieć format providers/{provider}/tasks/{task}. provider musi być identyfikatorem projektu Google Cloud. Na przykład: sample-cloud-project.

GetTaskTrackingInfoRequest

Wiadomość z prośbą GetTaskTrackingInfoRequest.

Pola
header

DeliveryRequestHeader

Opcjonalnie: Standardowy nagłówek żądania do interfejsu Delivery API.

name

string

Wymagane. Musi mieć format providers/{provider}/taskTrackingInfo/{tracking_id}. provider musi być identyfikatorem projektu Google Cloud, a tracking_id musi być identyfikatorem śledzenia powiązanym z zadaniem. Przykładową nazwą może być providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id.

ListDeliveryVehiclesRequest

Wiadomość z prośbą ListDeliveryVehicles.

Pola
header

DeliveryRequestHeader

Opcjonalnie: Standardowy nagłówek żądania do interfejsu Delivery API.

parent

string

Wymagane. Musi mieć format providers/{provider}. provider musi być identyfikatorem projektu Google Cloud. Na przykład: sample-cloud-project.

page_size

int32

Opcjonalnie: Maksymalna liczba pojazdów do zwrotu. Usługa może zwrócić mniej niż ta liczba. Jeśli liczba ta nie zostanie określona, serwer określi liczbę wyników do zwrócenia.

page_token

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji ListDeliveryVehicles. Musisz go podać, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListDeliveryVehicles muszą być zgodne z wywołaniem, które dostarczyło token strony.

filter

string

Opcjonalnie: Zapytanie filtra, które ma być stosowane przy wyświetlaniu listy pojazdów dostawy. Przykłady składni filtrów znajdziesz na stronie http://aip.dev/160. Jeśli nie określisz wartości lub podasz pusty ciąg znaków, zwracane będą wszystkie pojazdy dostawcze.

Pamiętaj, że w przypadku ListDeliveryVehicles obsługiwane są tylko zapytania dotyczące atrybutów pojazdu (np. attributes.<key> = <value> lub attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Poza tym wszystkie atrybuty są przechowywane jako ciągi znaków, więc jedynym obsługiwanym porównaniam z atrybutami są porównania ciągów znaków. Aby można było porównać wartości z wartościami liczbowymi lub logicznymi, wartości muszą być jawnie ujęte w cudzysłów, aby były traktowane jako ciągi znaków (np. attributes.<key> = "10" lub attributes.<key> = "true").

Maksymalna dozwolona liczba ograniczeń w zapytaniu filtra to 50. Ograniczenie jest częścią zapytania w formularzu attribute.<KEY> <COMPARATOR> <VALUE>, np. attributes.foo = bar to 1 ograniczenie.

viewport

Viewport

Opcjonalnie: Filtr ograniczający liczbę pojazdów zwracanych do tych, których ostatnia znana lokalizacja znajdowała się w prostokątnym obszarze zdefiniowanym w widocznym obszarze.

ListDeliveryVehiclesResponse

Komunikat z odpowiedzią ListDeliveryVehicles.

Pola
delivery_vehicles[]

DeliveryVehicle

Zestaw pojazdów dostawczych, które spełniają żądane kryteria filtrowania. Jeśli nie określisz filtra, żądanie zwróci wszystkie pojazdy dostawcze. Pomyślna odpowiedź może być pusta. Pusta odpowiedź oznacza, że nie znaleziono żadnych pojazdów dostawczych spełniających żądane kryteria filtrowania.

next_page_token

string

Aby przejść do wyświetlania wyników, możesz przekazać ten token w ListDeliveryVehiclesRequest. Gdy zostaną zwrócone wszystkie wyniki, to pole nie będzie zawarte w odpowiedzi lub będzie pustym ciągiem znaków.

total_size

int64

Łączna liczba pojazdów dostawy spełniających kryteria żądania na wszystkich stronach.

ListTasksRequest

Wiadomość z prośbą ListTasks.

Pola
header

DeliveryRequestHeader

Opcjonalnie: Standardowy nagłówek żądania do interfejsu Delivery API.

parent

string

Wymagane. Musi mieć format providers/{provider}. provider musi być identyfikatorem projektu Google Cloud. Na przykład: sample-cloud-project.

page_size

int32

Opcjonalnie: Maksymalna liczba zadań do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określisz tej wartości, serwer określi liczbę wyników do zwrócenia.

page_token

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji ListTasks. Dzięki temu można pobierać kolejne strony.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListTasks muszą być zgodne z wywołaniem, które dostarczyło token strony.

filter

string

Opcjonalnie: Zapytanie filtra, które ma być stosowane przy wyświetlaniu listy zadań. Przykłady składni filtrów znajdziesz na stronie http://aip.dev/160. Jeśli nie określisz wartości lub filtrujesz pusty ciąg znaków, zwracane są wszystkie zadania. Informacje o właściwościach Listy zadań, według których można filtrować, znajdziesz w sekcji Wyświetlanie listy zadań.

ListTasksResponse

Odpowiedź ListTasks zawierająca zbiór zadań, które spełniają kryteria filtrowania w tabeli ListTasksRequest.

Pola
tasks[]

Task

Zestaw zadań, które spełniają żądane kryteria filtrowania. Jeśli nie określisz filtra, żądanie zwróci wszystkie zadania. Pomyślna odpowiedź może być pusta. Pusta odpowiedź oznacza, że nie znaleziono Listy zadań spełniającej żądane kryteria filtrowania.

next_page_token

string

Przekaż ten token w ListTasksRequest, aby przejść do listy wyników. Jeśli zostały zwrócone wszystkie wyniki, to pole jest puste lub nie pojawia się w odpowiedzi.

total_size

int64

Łączna liczba zadań na wszystkich stronach spełniających kryteria żądania.

LocationInfo

lokalizacja z dodatkowymi identyfikatorami;

Pola
point

LatLng

Współrzędne lokalizacji.

Zadanie

Zadanie w interfejsie Delivery API reprezentuje jedno działanie do śledzenia. Ogólnie istnieje rozróżnienie między zadaniami związanymi z dostawą a zadaniami przerwania zadań. Z przesyłką może być powiązanych kilka zadań. Może być na przykład jedno zadanie dotyczące odbioru i jedno zadanie dotyczące dostawy lub przenoszenia. Różne pojazdy mogą też obsługiwać różne zadania dotyczące danej przesyłki. Na przykład jeden pojazd może przewieźć przesyłkę do centrum, a drugi przewieźć ją z centrum do miejsca nadania.

Uwaga: interfejsy API gRPC i REST używają różnych konwencji nazewnictwa pól. Na przykład pole Task.journey_sharing_info w interfejsie gRPC API i pole Task.journeySharingInfo w interfejsie API REST odnoszą się do tego samego pola.

Pola
name

string

Musi mieć format providers/{provider}/tasks/{task}.

type

Type

Wymagane. Stała. Określa typ zadania. Może to być na przykład przerwa lub dostawa.

state

State

Wymagane. Bieżący stan wykonania zadania.

task_outcome

TaskOutcome

Rezultat zadania.

task_outcome_time

Timestamp

Sygnatura czasowa wskazująca, kiedy dostawca Task ustalił wynik.

task_outcome_location

LocationInfo

Lokalizacja, w której ustalono wynik funkcji Task. Ta wartość jest aktualizowana w ramach UpdateTask. Jeśli ta wartość nie jest aktualizowana bezpośrednio przez dostawcę, Fleet Engine wypełnia ją domyślnie ostatnią znaną lokalizacją pojazdu (lokalizacja nieprzetworzona).

task_outcome_location_source

TaskOutcomeLocationSource

Wskazuje, skąd pochodzi wartość pola task_outcome_location.

tracking_id

string

Stała. To pole ułatwia przechowywanie identyfikatora, dzięki czemu nie musisz używać skomplikowanego mapowania. Nie możesz ustawić zasady tracking_id na Liście zadań typu UNAVAILABLE i SCHEDULED_STOP. Identyfikatory te podlegają następującym ograniczeniom:

  • Musi być prawidłowym ciągiem znaków Unicode.
  • Może mieć maksymalnie 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
delivery_vehicle_id

string

Tylko dane wyjściowe. Identyfikator pojazdu, który wykonuje to zadanie. Identyfikatory pojazdów dostawy podlegają tym ograniczeniom:

  • Musi być prawidłowym ciągiem znaków Unicode.
  • Może mieć maksymalnie 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
planned_location

LocationInfo

Stała. Lokalizacja, w której zadanie zostanie wykonane. Opcjonalny w przypadku zadań UNAVAILABLE, ale wymagany w przypadku wszystkich innych zadań.

task_duration

Duration

Wymagane. Stała. Czas potrzebny na wykonanie zadania w tej lokalizacji.

target_time_window

TimeWindow

Przedział czasu, w którym zadanie ma zostać wykonane.

journey_sharing_info

JourneySharingInfo

Tylko dane wyjściowe. Pola dotyczące udostępniania ścieżki. Wartość nie jest wypełniona, gdy stan to CLOSED.

task_tracking_view_config

TaskTrackingViewConfig

Konfiguracja śledzenia zadań określająca, które elementy danych są widoczne dla użytkowników w konkretnych okolicznościach.

attributes[]

TaskAttribute

Lista niestandardowych atrybutów Listy zadań. Każdy atrybut musi mieć unikalny klucz.

JourneySharingInfo

Określone pola dotyczące udostępniania serii czynności.

Pola
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Informacje o śledzeniu zatrzymania, które przydzieli przypisany pojazd, zanim ukończy to zadanie. Pamiętaj, że lista może zawierać przystanki z innych zadań.

Pierwszy segment, Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) lub Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), zawiera informacje o trasie od ostatniej znanej lokalizacji kierowcy do najbliższego VehicleStop. Informacje o aktualnej trasie zwykle pochodzą z aplikacji kierowcy. Wyjątkiem są sytuacje określone w dokumentacji funkcji DeliveryVehicle.current_route_segment. Pozostałe segmenty w Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) lub Task.journeySharingInfo.remainingVehicleJourneySegments (REST) są wypełniane przez Fleet Engine. Zapewniają informacje o trasie między VehicleStops.

last_location

DeliveryVehicleLocation

Wskazuje ostatnią zarejestrowaną lokalizację przypisanego pojazdu.

last_location_snappable

bool

Wskazuje, czy parametr lastLocation pojazdu może być przypięty do current_route_segment. Jeśli last_location lub current_route_segment nie istnieją, ta wartość to False. Ta wartość jest obliczana przez Fleet Engine. Aktualizacje od klientów są ignorowane.

Stan

Stan zadania. Ta wartość wskazuje postęp na Liście zadań.

Wartości w polu enum
STATE_UNSPECIFIED Domyślny: Używana w przypadku nieokreślonego lub nierozpoznanego stanu zadania.
OPEN Zadanie nie zostało jeszcze przypisane do pojazdu dostawczego lub ten pojazd nie dotarł jeszcze do przystanku pojazdu przypisanego do Task.
CLOSED Gdy pojazd minie zatrzyma się w ramach tego zadania.

TaskOutcome

Wynik próby wykonania zadania. Gdy zasada TaskState jest zamknięta, TaskOutcome wskazuje, czy udało się wykonać tę czynność.

Wartości w polu enum
TASK_OUTCOME_UNSPECIFIED Wynik zadania przed ustawieniem jego wartości.
SUCCEEDED Zadanie zostało wykonane.
FAILED Nie udało się ukończyć zadania lub zostało ono anulowane.

TaskOutcomeLocationSource

Tożsamość źródła, które wypełniło task_outcome_location.

Wartości w polu enum
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED Wynik zadania przed jego ustawieniem.
PROVIDER Parametr task_outcome_location określony przez dostawcę.
LAST_VEHICLE_LOCATION Dostawca nie podał: task_outcome_location, więc Fleet Engine użyła ostatniej znanej lokalizacji pojazdu.

Typ

Typ zadania.

Wartości w polu enum
TYPE_UNSPECIFIED Domyślnie typ zadania jest nieznany.
PICKUP Zadanie odbioru to działanie związane z odebraniem przesyłki od klienta. Odbiór pojazdów z magazynu lub uzupełniania powinien być taki sam jak typ SCHEDULED_STOP.
DELIVERY Zadanie dostawy to działanie podjęte w celu dostarczenia przesyłki do klienta końcowego. Zwrot pojazdów z magazynu lub uzupełniania powinien być zgodny z typem SCHEDULED_STOP.
SCHEDULED_STOP Zaplanowane zatrzymanie Zadanie służy do planowania. Może to być na przykład odbieranie lub odbieranie przesyłek z pojazdów dostawczych lub składów. Nie należy go używać w przypadku żadnych przesyłek odbieranych lub dostarczanych przez klienta końcowego.
UNAVAILABLE Zadanie, które oznacza, że pojazd nie jest dostępny do naprawy. Może się tak na przykład zdarzyć, gdy kierowca robi sobie przerwę lub uzupełnia paliwo w pojeździe.

TaskAttribute

Opisuje atrybut zadania w postaci pary klucz-wartość. Pole „klucz:wartość” Długość ciągu znaków nie może przekraczać 256 znaków.

Pola
key

string

Klucz atrybutu. Klucze nie mogą zawierać znaku dwukropka (:).

Pole sumy task_attribute_value. Wartość atrybutu może być ciągiem znaków, wartością logiczną lub liczbą zmiennoprzecinkową. Jeśli nie zostanie ustawiona żadna wartość, parametr string_value będzie przechowywany jako pusty ciąg „”. task_attribute_value może mieć tylko jedną z tych wartości:
string_value

string

Wartość atrybutu z ciągiem znaków.

bool_value

bool

Wartość atrybutu wpisanego z użyciem wartości logicznej.

number_value

double

Wartość atrybutu została wpisana dwukrotnie.

TaskTrackingInfo

Wiadomość TaskTrackingInfo. Wiadomość zawiera informacje o śledzeniu zadań, które zostaną wykorzystane do wyświetlenia. Jeśli identyfikator śledzenia jest powiązany z wieloma zadaniami, Fleet Engine używa heurystyki do określania, które zadanie TaskTrackingInfo ma zostać wybrane.

Pola
name

string

Musi mieć format providers/{provider}/taskTrackingInfo/{tracking}, gdzie tracking to identyfikator śledzenia.

tracking_id

string

Stała. Identyfikator śledzenia zadania. * To musi być prawidłowy ciąg Unicode. * Maksymalna długość wynosi 64 znaki. * Znormalizowane zgodnie z formularzem normalizacji Unicode C. * Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, , „#”.

vehicle_location

DeliveryVehicleLocation

Ostatnia lokalizacja pojazdu.

route_polyline_points[]

LatLng

Lista punktów, które po połączeniu tworzą linię łamaną oczekiwanej trasy pojazdu do lokalizacji, w której wykonano to zadanie.

remaining_stop_count

Int32Value

Wskazuje liczbę przystanków pojazdu pozostałych do momentu zakończenia zadania, w tym do postoju. Jeśli na przykład następny przystanek pojazdu jest zatrzymaniem zadania, wartość będzie wynosić 1.

remaining_driving_distance_meters

Int32Value

Całkowita pozostała odległość (w metrach) do interesującego Cię obszaru (VehicleStop).

estimated_arrival_time

Timestamp

Sygnatura czasowa, która wskazuje szacowany czas przybycia do lokalizacji przystanku.

estimated_task_completion_time

Timestamp

Sygnatura czasowa wskazująca szacowany czas ukończenia zadania.

state

State

Bieżący stan wykonania zadania.

task_outcome

TaskOutcome

Wynik próby wykonania zadania.

task_outcome_time

Timestamp

Sygnatura czasowa wskazująca, kiedy dostawca zadania określił wynik zadania.

planned_location

LocationInfo

Stała. Lokalizacja, w której zadanie zostanie wykonane.

target_time_window

TimeWindow

Przedział czasu, w którym zadanie ma zostać wykonane.

attributes[]

TaskAttribute

Atrybuty niestandardowe ustawione w zadaniu.

TaskTrackingViewConfig

Komunikat konfiguracyjny, który określa, kiedy element danych zadania powinien być widoczny dla użytkowników.

Pola
route_polyline_points_visibility

VisibilityOption

Pole określające, kiedy punkty linii łamanej trasy mogą być widoczne. Jeśli to pole nie jest określone, w przypadku tych danych używana będzie domyślna konfiguracja widoczności na poziomie projektu.

estimated_arrival_time_visibility

VisibilityOption

Pole określające, kiedy szacowany czas przyjazdu może być widoczny. Jeśli to pole nie jest określone, w przypadku tych danych używana będzie domyślna konfiguracja widoczności na poziomie projektu.

estimated_task_completion_time_visibility

VisibilityOption

Pole, które określa, kiedy może być widoczny szacowany czas ukończenia zadania. Jeśli to pole nie jest określone, w przypadku tych danych używana będzie domyślna konfiguracja widoczności na poziomie projektu.

remaining_driving_distance_visibility

VisibilityOption

Pole określające, kiedy pozostała odległość jazdy może być widoczna. Jeśli to pole nie jest określone, w przypadku tych danych używana będzie domyślna konfiguracja widoczności na poziomie projektu.

remaining_stop_count_visibility

VisibilityOption

Pole określające, kiedy liczba pozostałych przystanków może być widoczna. Jeśli to pole nie jest określone, w przypadku tych danych używana będzie domyślna konfiguracja widoczności na poziomie projektu.

vehicle_location_visibility

VisibilityOption

Pole, które określa, kiedy lokalizacja pojazdu może być widoczna. Jeśli to pole nie jest określone, w przypadku tych danych używana będzie domyślna konfiguracja widoczności na poziomie projektu.

VisibilityOption

Komunikat dotyczący opcji, który określa, kiedy element danych powinien być widoczny dla użytkowników.

Pola
Pole sumy visibility_option. Wybrana opcja widoczności. visibility_option może mieć tylko jedną z tych wartości:
remaining_stop_count_threshold

int32

Ten element danych jest widoczny dla użytkowników, jeśli liczba pozostałych przystanków <= remaining_stop_count_threshold.

duration_until_estimated_arrival_time_threshold

Duration

Ten element danych jest widoczny dla użytkowników, jeśli szacowany czas dotarcia na miejsce do przystanku <= duration_until_estimated_arrival_time_threshold.

remaining_driving_distance_meters_threshold

int32

Ten element danych jest widoczny dla użytkowników, jeśli pozostała odległość przejechana w metrach wynosi <= remaining_driving_distance_meters_threshold.

always

bool

Jeśli ma wartość Prawda, ten element danych jest zawsze widoczny dla użytkowników bez wartości progowych. W tym polu nie można ustawić wartości false (fałsz).

never

bool

Jeśli ma wartość Prawda, ten element danych jest zawsze ukryty przed użytkownikami bez wartości progowych. W tym polu nie można ustawić wartości false (fałsz).

TimeWindow

Zakres czasowy.

Pola
start_time

Timestamp

Wymagane. Godzina rozpoczęcia przedziału czasu (włącznie).

end_time

Timestamp

Wymagane. Godzina zakończenia przedziału czasu (włącznie).

UpdateDeliveryVehicleRequest

Wiadomość z prośbą UpdateDeliveryVehicle.

Pola
header

DeliveryRequestHeader

Opcjonalnie: Standardowy nagłówek żądania do interfejsu Delivery API.

delivery_vehicle

DeliveryVehicle

Wymagane. Aktualizacja elementu DeliveryVehicle, która ma zostać zastosowana. Uwaga: nie możesz zmienić nazwy elementu DeliveryVehicle.

update_mask

FieldMask

Wymagane. Maska pola wskazująca, które pola DeliveryVehicle mają zostać zaktualizowane. Pamiętaj, że parametr update_mask musi zawierać co najmniej jedno pole.

Jest to rozdzielana przecinkami lista w pełni kwalifikowanych nazw pól. Przykład: "remaining_vehicle_journey_segments".

UpdateTaskRequest

Wiadomość z prośbą UpdateTask.

Pola
header

DeliveryRequestHeader

Opcjonalnie: Standardowy nagłówek żądania do interfejsu Delivery API.

task

Task

Wymagane. Zadanie powiązane z aktualizacją. Poniższe pola są obsługiwane przez Fleet Engine. Nie aktualizuj ich za pomocą: Task.update.

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

Uwaga: po ustawieniu wartości task_outcome nie można jej zmienić.

Jeśli zadanie zostało przypisane do pojazdu dostawcy, nie ustawiaj Stan zadania na ZAMKNIĘTE przy użyciu funkcji Task.update. Zamiast tego usuń z pojazdu dostarczania zadania VehicleStop, które zawiera zadanie, co spowoduje automatyczne ustawienie stanu zadania na ZAMKNIĘTE.

update_mask

FieldMask

Wymagane. Maska pola wskazująca, które pola Listy zadań mają zostać zaktualizowane. Uwaga: update_mask musi zawierać co najmniej 1 pole.

Jest to rozdzielana przecinkami lista w pełni kwalifikowanych nazw pól. Przykład: "task_outcome,task_outcome_time,task_outcome_location".

VehicleJourneySegment

Przedstawia segment podróży pojazdu – od poprzedniego przystanku do bieżącego przystanku. Jeśli jest to pierwszy aktywny przystanek, oznacza to, że do tego przystanku dojedziesz od aktualnej lokalizacji pojazdu.

Pola
stop

VehicleStop

Określa lokalizację przystanku oraz powiązane z nim Task. Niektóre pola obiektu VehicleStop mogą nie być dostępne, jeśli ten segment podróży należy do: JourneySharingInfo.

driving_distance_meters

Int32Value

Tylko dane wyjściowe. Odległość przebyta od poprzedniego przystanku do tego przystanku. Jeśli obecny przystanek jest pierwszym przystankiem na liście segmentów podróży, punktem początkowym jest lokalizacja pojazdu zarejestrowana w momencie dodania tego przystanku do listy. To pole może się nie pojawić, jeśli ten segment podróży należy do domeny JourneySharingInfo.

driving_duration

Duration

Tylko dane wyjściowe. Czas podróży z poprzedniego przystanku do tego przystanku. Jeśli obecny przystanek jest pierwszym przystankiem na liście segmentów podróży, punktem początkowym jest lokalizacja pojazdu zarejestrowana w momencie dodania tego przystanku do listy.

Jeśli to pole jest zdefiniowane w ścieżce Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) lub Task.remainingVehicleJourneySegments[0].drivingDuration (REST), może być wypełnione wartością z DeliveryVehicle.remaining_duration (gRPC) lub DeliveryVehicle.remainingDuration (REST). Podaje pozostały czas jazdy z ostatniej znanej lokalizacji aplikacji kierowcy zamiast czasu jazdy z poprzedniego przystanku.

path[]

LatLng

Tylko dane wyjściowe. Ścieżka z poprzedniego przystanku do tego przystanku. Jeśli bieżący przystanek jest pierwszym przystankiem na liście segmentów podróży, jest to trasa z bieżącej lokalizacji pojazdu do tego przystanku w momencie dodania tego przystanku do listy. To pole może się nie pojawić, jeśli ten segment podróży należy do domeny JourneySharingInfo.

Jeśli to pole jest zdefiniowane w ścieżce Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) lub Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST), można je zapełnić wartościami LatLng zdekodowanymi z kodu DeliveryVehicle.current_route_segment (gRPC) lub DeliveryVehicle.currentRouteSegment (REST). Powoduje to podanie trasy z najnowszej znanej lokalizacji aplikacji kierowcy, a nie trasy z poprzedniego przystanku.

VehicleStop

Wskazuje punkt, w którym pojazd zatrzymuje się, aby wykonać co najmniej 1 Task.

Pola
planned_location

LocationInfo

Wymagane. Lokalizacja przystanku. Pamiętaj, że lokalizacje w lokalizacji Task mogą nie być dokładnie takie same jak to, ale znajdujące się w niewielkiej odległości od niego. To pole nie będzie wypełniane w odpowiedzi na wywołanie GetTask.

tasks[]

TaskInfo

Lista Task s do wykonania w tym przystanku. To pole nie będzie wypełniane w odpowiedzi na wywołanie GetTask.

state

State

Stan VehicleStop. To pole nie będzie wypełniane w odpowiedzi na wywołanie GetTask.

Stan

Bieżący stan elementu VehicleStop.

Wartości w polu enum
STATE_UNSPECIFIED Nieznany.
NEW Utworzono, ale kierowanie nie jest aktywne.
ENROUTE Przypisana i aktywnie routing.
ARRIVED Dotarł(a) do przystanku. Zakładamy, że gdy pojazd jedziesz do następnego przystanku, wszystkie poprzednie przystanki zostały ukończone.

TaskInfo

Dodatkowe informacje o zadaniu wykonanym w tym miejscu.

Pola
task_id

string

Identyfikator zadania. To pole nie będzie wypełniane w odpowiedzi na wywołanie GetTask. Identyfikatory zadań podlegają tym ograniczeniom:

  • Musi być prawidłowym ciągiem znaków Unicode.
  • Może mieć maksymalnie 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
task_duration

Duration

Tylko dane wyjściowe. Czas wymagany do wykonania zadania.

target_time_window

TimeWindow

Tylko dane wyjściowe. Przedział czasu, w którym zadanie ma zostać wykonane. To ustawienie jest ustawiane tylko w odpowiedzi na GetDeliveryVehicle.