Package maps.fleetengine.delivery.v1

Indeks

DeliveryService

usługi dostawy ostatniej mili,

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

Tworzy i zwraca partię nowych obiektów Task.
CreateDeliveryVehicle

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

Tworzy i zwraca nowy obiekt DeliveryVehicle.
CreateTask

rpc CreateTask(CreateTaskRequest) returns (Task)

Tworzy i zwraca nowy obiekt Task.
DeleteDeliveryVehicle

rpc DeleteDeliveryVehicle(DeleteDeliveryVehicleRequest) returns (Empty)

Usuwa pojazd dostawczy z Fleet Engine.

Zwraca wartość FAILED_PRECONDITION, jeśli do pojazdu dostawczego przypisane są zadania w stanie OPEN.
DeleteTask

rpc DeleteTask(DeleteTaskRequest) returns (Empty)

Usuwa pojedyncze zadanie.

Zwraca wartość FAILED_PRECONDITION, jeśli zadanie ma stan OPEN i jest przypisane do pojazdu dostawczego.
GetDeliveryVehicle

rpc GetDeliveryVehicle(GetDeliveryVehicleRequest) returns (DeliveryVehicle)

Zwraca określoną instancję DeliveryVehicle.
GetTask

rpc GetTask(GetTaskRequest) returns (Task)

Pobiera informacje o Task.
GetTaskTrackingInfo

rpc GetTaskTrackingInfo(GetTaskTrackingInfoRequest) returns (TaskTrackingInfo)

Zwraca określoną instancję TaskTrackingInfo.
ListDeliveryVehicles

rpc ListDeliveryVehicles(ListDeliveryVehiclesRequest) returns (ListDeliveryVehiclesResponse)

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

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

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

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Zapisuje zaktualizowane dane DeliveryVehicle w Fleet Engine i przypisuje Tasks do DeliveryVehicle. Nie możesz zaktualizować nazwy DeliveryVehicle. Możesz zaktualizować remaining_vehicle_journey_segments, ale musi on zawierać wszystkie elementy VehicleJourneySegment, aby można było go zapisać na urządzeniu DeliveryVehicle. task_id są pobierane z remaining_vehicle_journey_segments, a odpowiednie Tasks są przypisywane do DeliveryVehicle, jeśli nie zostały jeszcze przypisane.
UpdateTask

rpc UpdateTask(UpdateTaskRequest) returns (Task)

Aktualizuje dane Task.

BatchCreateTasksRequest

Wiadomość z prośbą o 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 musi być zgodne z tym polem.
parent

string

Wymagany. Zasób nadrzędny udostępniany wszystkim zadaniom. Wartość musi być w formacie providers/{provider}. W miejsce provider należy wpisać identyfikator projektu Google Cloud. Na przykład: sample-cloud-project. Pole nadrzędne w wiadomościach CreateTaskRequest musi być puste lub musi odpowiadać temu polu.
requests[]

CreateTaskRequest

Wymagany. Wiadomość z żądaniem, która określa zasoby do utworzenia. Uwaga: w jednej partii możesz utworzyć maksymalnie 500 zadań.

BatchCreateTasksResponse

BatchCreateTask wiadomość z odpowiedzią;

Pola
tasks[]

Task

utworzone zadania.

CreateDeliveryVehicleRequest

Wiadomość z prośbą o CreateDeliveryVehicle.

Pola
header

DeliveryRequestHeader

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

string

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

string

Wymagany. Identyfikator pojazdu dostawczego musi być unikalny i podlegać tym ograniczeniom:

  • Musi to być prawidłowy ciąg znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowane zgodnie z formą normalizacji Unicode C.
  • Nie może zawierać żadnego z tych znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
delivery_vehicle

DeliveryVehicle

Wymagany. DeliveryVehicle encja do utworzenia. Podczas tworzenia nowego pojazdu dostawczego możesz ustawić te opcjonalne pola:

  • typ
  • last_location
  • atrybuty

Uwaga: pole name w obiekcie DeliveryVehicle jest ignorowane. Nie można ustawić żadnych innych pól DeliveryVehicle. W przeciwnym razie zwracany jest błąd.

CreateTaskRequest

Wiadomość z prośbą o CreateTask.

Pola
header

DeliveryRequestHeader

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

string

Wymagany. Musi mieć format providers/{provider}. W miejsce provider należy wpisać identyfikator projektu Google Cloud. Na przykład: sample-cloud-project.
task_id

string

Wymagany. Identyfikator zadania musi być unikalny, ale nie powinien być identyfikatorem śledzenia przesyłki. Aby zapisać identyfikator śledzenia przesyłki, użyj pola tracking_id. Pamiętaj, że wiele zadań może mieć ten sam symbol tracking_id. Identyfikatory zadań podlegają tym ograniczeniom:

  • Musi to być prawidłowy ciąg znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowane zgodnie z formą normalizacji Unicode C.
  • Nie może zawierać żadnego z tych znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
task

Task

Wymagany. Encja zadania do utworzenia. Podczas tworzenia zadania wymagane są te pola:

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

Możesz opcjonalnie ustawić te pola:

  • target_time_window
  • task_tracking_view_config
  • attributes

Uwaga: pole name zadania jest ignorowane. Wszystkie pozostałe pola zadania nie mogą być ustawione. W przeciwnym razie zwracany jest błąd.

DeleteDeliveryVehicleRequest

Komunikat żądania DeleteDeliveryVehicle.

Pola
header

DeliveryRequestHeader

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

string

Wymagany. Musi mieć format providers/{provider}/deliveryVehicles/{delivery_vehicle}. W miejsce provider należy wpisać identyfikator projektu Google Cloud. Na przykład: sample-cloud-project.

DeleteTaskRequest

Wiadomość z prośbą DeleteTask.

Pola
header

DeliveryRequestHeader

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

string

Wymagany. Musi mieć format providers/{provider}/tasks/{task}. W miejsce provider należy wpisać identyfikator projektu Google Cloud. Na przykład: sample-cloud-project.

DeliveryRequestHeader

RequestHeader zawiera pola wspólne dla wszystkich żądań RPC dostarczania.

Pola
language_code

string

Kod języka w formacie 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 określono żadnego języka, odpowiedź może być w dowolnym języku, ale jeśli istnieje nazwa w języku angielskim, będzie ona preferowana. Przykład wartości pola: en-US.
region_code

string

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

string

Wersja pakietu SDK do połączeń (w stosownych przypadkach). Format wersji to „główna.pomniejsza.poprawka”, np. 1.1.2.
os_version

string

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

string

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

SdkType

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

string

Wersja pakietu MapSDK, od której zależy wywołujący pakiet SDK (w odpowiednich przypadkach). Format wersji to „główna.pomniejsza.poprawka”, np. 5.2.1.
nav_sdk_version

string

Wersja pakietu NavSDK, od której zależy wywołujący pakiet SDK (w odpowiednich przypadkach). Format wersji to „główna.pomniejsza.poprawka”, np. 2.1.0.
platform

Platform

Platforma wywołującego pakietu SDK.
manufacturer

string

Producent urządzenia z Androidem, z którego wywoływany jest pakiet SDK. Dotyczy to tylko pakietów SDK na Androida. Przykład wartości pola: Samsung.
android_api_level

int32

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

string

Opcjonalny identyfikator, który można podać na potrzeby rejestrowania, aby zidentyfikować żądanie.

Platforma

Platforma wywołującego pakietu SDK.

Wartości w polu enum
PLATFORM_UNSPECIFIED Wartość domyślna. Ta wartość jest używana, jeśli platforma jest pominięta.
ANDROID Żądanie pochodzi z Androida.
IOS Żądanie 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 pominięto element sdk_type.
CONSUMER Wywołujący pakiet SDK to Consumer.
DRIVER Wywołujący pakiet SDK to Driver.
JAVASCRIPT Wywołujący pakiet SDK to JavaScript.

DeliveryVehicle

Wiadomość DeliveryVehicle. Pojazd dostawczy przewozi przesyłki z magazynu do miejsca dostawy i z miejsca odbioru do magazynu. W niektórych przypadkach pojazdy dostawcze transportują przesyłki bezpośrednio z miejsca odbioru do miejsca dostawy.

Uwaga: interfejsy gRPC i REST API 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 REST API odnoszą się do tego samego pola.

Pola
name

string

Unikalna nazwa pojazdu dostawczego. Format to providers/{provider}/deliveryVehicles/{vehicle}.
last_location

DeliveryVehicleLocation

Ostatnia zgłoszona lokalizacja pojazdu dostawczego.
past_locations[]

DeliveryVehicleLocation

Tylko dane wejściowe. Lokalizacje, w których w przeszłości znajdował się ten pojazd dostawczy, ale nie zostały jeszcze zgłoszone do Fleet Engine. Jest on używany w UpdateDeliveryVehicleRequest do rejestrowania lokalizacji, których wcześniej nie można było wysłać na serwer. Zwykle dzieje się tak, gdy pojazd dostawczy nie ma połączenia z internetem.
navigation_status

DeliveryVehicleNavigationStatus

Stan nawigacji pojazdu dostawczego.
current_route_segment

bytes

Zakodowana linia łamana określająca trasę, którą nawigacja zaleca dojazdu do następnego punktu pośredniego. Aplikacja dla kierowców aktualizuje tę informację, gdy dotrzesz do przystanku lub go miniesz oraz gdy nawigacja zmieni trasę. Te LatLng są zwracane w 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.

W kilku przypadkach to pole może nie być używane do wypełniania pól Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) lub Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

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

  • Aplikacja dla kierowców nie zaktualizowała ostatnio swojej lokalizacji, więc ostatnia zaktualizowana wartość tego pola może być nieaktualna.

  • Aplikacja dla kierowców niedawno zaktualizowała swoją lokalizację, ale current_route_segment jest nieaktualny i wskazuje poprzedni przystanek pojazdu.

W takich przypadkach Fleet Engine wypełnia to pole trasą od ostatniego przystanku pojazdu do następnego przystanku, aby odbiorca tych informacji miał jak najlepsze dane o bieżącej trasie pojazdu dostawczego.
current_route_segment_end_point

LatLng

Miejsce, w którym kończy się current_route_segment. Ta informacja nie jest obecnie wypełniana przez aplikację dla kierowców, ale możesz ją podać podczas rozmów telefonicznych z UpdateDeliveryVehicle. Jest to LatLng od najbliższego przystanku lub ostatni LatLng z current_route_segment. Fleet Engine postara się wtedy dokonać interpolacji do rzeczywistej wartości VehicleStop.

To pole jest ignorowane w wywołaniach UpdateDeliveryVehicle, jeśli pole current_route_segment jest puste.
remaining_distance_meters

Int32Value

Pozostała odległość do przejechania w przypadku current_route_segment. Aplikacja dla kierowców zwykle podaje to pole, ale w niektórych przypadkach Fleet Engine zastępuje wartość wysłaną przez aplikację. Więcej informacji znajdziesz w DeliveryVehicle.current_route_segment. To pole jest zwracane w przypadku wszystkich aktywnych Task przypisanych do pojazdu dostawczego w Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) lub Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST).

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

Duration

Pozostały czas jazdy w przypadku current_route_segment. Aplikacja dla kierowców zwykle podaje to pole, ale w niektórych przypadkach Fleet Engine zastępuje wartość wysłaną przez aplikację. Więcej informacji znajdziesz w DeliveryVehicle.current_route_segment. To pole jest zwracane w przypadku wszystkich aktywnych zadań przypisanych do pojazdu dostawczego w Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) lub Task.remainingVehicleJourneySegments[0].drivingDuration (REST).

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

VehicleJourneySegment

Odcinki podróży przypisane do tego pojazdu dostawczego, począwszy od ostatnio zgłoszonej lokalizacji pojazdu. To pole nie będzie wypełnione w odpowiedzi ListDeliveryVehicles.
attributes[]

DeliveryVehicleAttribute

Lista niestandardowych atrybutów pojazdu dostawczego. Pojazd dostawczy może mieć maksymalnie 100 atrybutów, a każdy atrybut musi mieć unikalny klucz.
type

DeliveryVehicleType

Typ pojazdu dostawczego. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość AUTO.

DeliveryVehicleType

Rodzaj pojazdu dostawczego.

Wartości w polu enum
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Wartość jest nieużywana.
AUTO samochód,
TWO_WHEELER motocykl, skuter lub inny pojazd dwukołowy;
BICYCLE transport napędzany siłą ludzkich mięśni,
PEDESTRIAN Osoba transportująca, zwykle pieszo lub biegiem, poruszająca się po ścieżkach dla pieszych.

DeliveryVehicleAttribute

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

Pola
key

string

Klucz atrybutu.
value

string

Wartość atrybutu.
Pole unii 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 typu ciąg znaków.

Uwaga: to pole jest identyczne z polem value, które zostanie w końcu wycofane. W przypadku metod tworzenia lub aktualizowania można użyć dowolnego pola, ale zdecydowanie zalecamy używanie pola string_value. Jeśli ustawione są oba parametry string_value i value, muszą być identyczne. W przeciwnym razie zostanie zgłoszony błąd. Oba pola są wypełniane w odpowiedziach.
bool_value

bool

Wartość atrybutu typu logicznego.
number_value

double

Wartość atrybutu typu double.

DeliveryVehicleLocation

Lokalizacja, prędkość i kierunek pojazdu w danym momencie.

Pola
location

LatLng

Lokalizacja pojazdu. Gdy jest wysyłana do Fleet Engine, lokalizacja pojazdu jest lokalizacją GPS. Gdy otrzymasz ją w odpowiedzi, lokalizacja pojazdu może być lokalizacją GPS, lokalizacją dodatkową lub inną lokalizacją szacunkową. Źródło jest określone w location_sensor.
horizontal_accuracy
(deprecated)

DoubleValue

Wycofana: zamiast niej używaj zasady latlng_accuracy.
latlng_accuracy

DoubleValue

Dokładność location w metrach jako promień.
heading

Int32Value

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

DoubleValue

Wycofana: zamiast niej używaj zasady heading_accuracy.
heading_accuracy

DoubleValue

Dokładność heading w stopniach.
altitude

DoubleValue

Wysokość w metrach nad poziomem WGS84.
vertical_accuracy
(deprecated)

DoubleValue

Wycofana: zamiast niej używaj zasady altitude_accuracy.
altitude_accuracy

DoubleValue

Dokładność altitude w metrach.
speed_kmph
(deprecated)

Int32Value

Prędkość pojazdu w kilometrach na godzinę. Wycofana: zamiast niej używaj zasady speed.
speed

DoubleValue

Prędkość pojazdu w metrach na sekundę
speed_accuracy

DoubleValue

Dokładność speed w metrach na sekundę.
update_time

Timestamp

Czas, w którym czujnik zgłosił wartość location zgodnie z zegarem czujnika.
server_time

Timestamp

Tylko dane wyjściowe. Czas, w którym serwer otrzymał informacje o lokalizacji.
location_sensor

DeliveryVehicleLocationSensor

Dostawca danych o lokalizacji (np. GPS).
is_road_snapped

BoolValue

Określa, czy ikona location jest przyciągana do drogi.
is_gps_sensor_enabled

BoolValue

Tylko dane wejściowe. Określa, czy na urządzeniu mobilnym jest włączony czujnik GPS.
time_since_update

Int32Value

Tylko dane wejściowe. Czas (w sekundach) od momentu, gdy ta lokalizacja została po raz pierwszy wysłana na serwer. W przypadku pierwszej aktualizacji będzie to zero. Jeśli czas jest nieznany (np. po ponownym uruchomieniu aplikacji), ta wartość jest resetowana do zera.
num_stale_updates
(deprecated)

Int32Value

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

LatLng

Surowa lokalizacja pojazdu (nieprzetworzona przez funkcję przyciągania do drogi).
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 jako promień w metrach.
flp_location

LatLng

Lokalizacja z usługi lokalizacyjnej Androida.
flp_update_time

Timestamp

Aktualizacja sygnatury czasowej flp_location
flp_latlng_accuracy_meters

DoubleValue

Dokładność flp_location w metrach jako promień.
flp_heading_degrees

Int32Value

Kierunek, w którym porusza się pojazd, w stopniach, określony przez dostawcę połączonej lokalizacji. 0 oznacza północ. Prawidłowy zakres to [0,360).
supplemental_location

LatLng

Dodatkowa lokalizacja podana przez aplikację integrującą.
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 jako promień w metrach.
road_snapped
(deprecated)

bool

Wycofana: zamiast niej używaj zasady is_road_snapped.

DeliveryVehicleLocationSensor

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

Wartości w polu enum
UNKNOWN_SENSOR Czujnik jest nieokreślony lub nieznany.
GPS GPS lub wspomagany GPS.
NETWORK GPS wspomagany, identyfikator stacji bazowej lub punkt dostępu Wi-Fi.
PASSIVE Identyfikator stacji bazowej lub punktu dostępu Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Lokalizacja określona przez urządzenie mobilne jako najbardziej prawdopodobne położenie na drodze.
CUSTOMER_SUPPLIED_LOCATION Lokalizacja podana przez klienta z niezależnego źródła. Zwykle ta wartość jest używana w przypadku lokalizacji pochodzącej ze źródeł innych niż urządzenie mobilne, na którym działa pakiet Driver SDK. Jeśli pierwotne źródło jest opisane przez jedną z innych wartości wyliczeniowych, użyj tej wartości. Lokalizacje oznaczone jako CUSTOMER_SUPPLIED_LOCATION są zwykle podawane za pomocą parametru last_location.supplemental_location_sensor obiektu DeliveryVehicle.
FLEET_ENGINE_LOCATION Lokalizacja obliczona przez Fleet Engine na podstawie dostępnych sygnałów. Tylko dane wyjściowe. Jeśli ta wartość zostanie przesłana w żądaniu, zostanie odrzucona.
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 dla kierowców jest w trybie FREE_NAV.
ENROUTE_TO_DESTINATION Nawigacja zakręt po zakręcie jest dostępna, a nawigacja w aplikacji dla kierowców weszła 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ą o GetDeliveryVehicle.

Pola
header

DeliveryRequestHeader

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

string

Wymagany. Musi mieć format providers/{provider}/deliveryVehicles/{delivery_vehicle}. W miejsce provider należy wpisać identyfikator projektu Google Cloud. Na przykład: sample-cloud-project.

GetTaskRequest

Wiadomość z prośbą o GetTask.

Pola
header

DeliveryRequestHeader

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

string

Wymagany. Musi mieć format providers/{provider}/tasks/{task}. W miejsce provider należy wpisać identyfikator projektu Google Cloud. Na przykład: sample-cloud-project.

GetTaskTrackingInfoRequest

Wiadomość z prośbą o GetTaskTrackingInfoRequest.

Pola
header

DeliveryRequestHeader

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

string

Wymagany. Musi mieć format providers/{provider}/taskTrackingInfo/{tracking_id}. W miejscu provider musi znajdować się identyfikator projektu Google Cloud, a w miejscu tracking_id – identyfikator śledzenia powiązany z zadaniem. Przykładowa nazwa to providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id.

ListDeliveryVehiclesRequest

Wiadomość z prośbą o ListDeliveryVehicles.

Pola
header

DeliveryRequestHeader

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

string

Wymagany. Musi mieć format providers/{provider}. W miejsce provider należy wpisać identyfikator projektu Google Cloud. Na przykład: sample-cloud-project.
page_size

int32

Opcjonalnie. Maksymalna liczba pojazdów do zwrócenia. Usługa może zwrócić mniejszą liczbę wyników. Jeśli nie podasz tej liczby, serwer określi liczbę wyników do zwrócenia.
page_token

string

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

Podczas paginacji wszystkie inne parametry przekazane do funkcji ListDeliveryVehicles muszą być zgodne z wywołaniem, które dostarczyło token strony.
filter

string

Opcjonalnie. Zapytanie filtra do zastosowania podczas wyświetlania listy pojazdów dostawczych. Przykłady składni filtra znajdziesz na stronie http://aip.dev/160. Jeśli nie podasz wartości lub podasz pusty ciąg znaków jako filtr, zostaną zwrócone wszystkie pojazdy dostawcze.

Pamiętaj, że w przypadku atrybutu ListDeliveryVehicles obsługiwane są tylko zapytania dotyczące atrybutów pojazdu (np. attributes.<key> = <value> lub attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Wszystkie atrybuty są też przechowywane jako ciągi znaków, więc obsługiwane są tylko porównania ciągów znaków. Aby porównać wartości liczbowe lub logiczne, musisz umieścić je w cudzysłowie, aby były traktowane jako ciągi znaków (np. attributes.<key> = "10" lub attributes.<key> = "true").

Maksymalna liczba ograniczeń dozwolonych w zapytaniu filtra to 50. Ograniczenie to część zapytania w formie attribute.<KEY> <COMPARATOR> <VALUE>, np. attributes.foo = bar to 1 ograniczenie.
viewport

Viewport

Opcjonalnie. Filtr, który ogranicza zwracane pojazdy do tych, których ostatnia znana lokalizacja znajdowała się w prostokątnym obszarze zdefiniowanym przez widoczny obszar.

ListDeliveryVehiclesResponse

ListDeliveryVehicles wiadomość z odpowiedzią;

Pola
delivery_vehicles[]

DeliveryVehicle

Zestaw pojazdów dostawczych spełniających kryteria filtrowania. Jeśli nie określisz filtra, żądanie zwróci wszystkie pojazdy dostawcze. Odpowiedź informująca o powodzeniu może być też pusta. Pusta odpowiedź oznacza, że nie znaleziono pojazdów dostawczych spełniających kryteria filtra.
next_page_token

string

Możesz przekazać ten token w parametrze ListDeliveryVehiclesRequest, aby nadal wyświetlać wyniki. Gdy zostaną zwrócone wszystkie wyniki, to pole nie będzie znajdować się w odpowiedzi lub będzie zawierać pusty ciąg znaków.
total_size

int64

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

ListTasksRequest

Wiadomość z prośbą o ListTasks.

Pola
header

DeliveryRequestHeader

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

string

Wymagany. Musi mieć format providers/{provider}. W miejsce provider należy wpisać identyfikator 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 podasz tej wartości, serwer określi liczbę wyników do zwrócenia.
page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania ListTasks. Możesz go podać, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji ListTasks muszą być zgodne z wywołaniem, które dostarczyło token strony.
filter

string

Opcjonalnie. Zapytanie filtra do zastosowania podczas wyświetlania listy zadań. Przykłady składni filtra znajdziesz na stronie http://aip.dev/160. Jeśli nie określisz wartości lub zastosujesz filtr do pustego ciągu znaków, zostaną zwrócone wszystkie zadania. Informacje o właściwościach zadań, według których możesz filtrować, znajdziesz w artykule Wyświetlanie listy zadań.

ListTasksResponse

Odpowiedź ListTasks zawierająca zestaw zadań spełniających kryteria filtra w ListTasksRequest.

Pola
tasks[]

Task

Zbiór zadań spełniających kryteria filtrowania. Jeśli nie podasz filtra, żądanie zwróci wszystkie zadania. Odpowiedź informująca o powodzeniu może być też pusta. Pusta odpowiedź oznacza, że nie znaleziono żadnych zadań spełniających kryteria filtra.
next_page_token

string

Przekaż ten token w parametrze ListTasksRequest, aby kontynuować wyświetlanie wyników. Jeśli zwrócono wszystkie wyniki, to pole jest pustym ciągiem znaków lub nie występuje w odpowiedzi.
total_size

int64

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

LocationInfo

Lokalizacja z dodatkowymi identyfikatorami.

Pola
point

LatLng

Współrzędne lokalizacji. Jako dane wejściowe należy podać wartość point lub place. Jeśli określono oba te parametry, do routingu będzie używany parametr point, a do metadanych – parametr place. Jeśli jako dane wejściowe podano tylko place, wartość point zostanie obliczona na podstawie place i uwzględniona w danych wyjściowych.
place

string

Nazwa zasobu miejsca, które reprezentuje tę lokalizację. Format to places/{place_id}. Jako dane wejściowe należy podać wartość point lub place. Jeśli określono oba te parametry, do routingu będzie używany parametr point, a do metadanych – parametr place. place jest uwzględniany w danych wyjściowych tylko wtedy, gdy był uwzględniony w danych wejściowych, co oznacza, że nie jest wykonywane wyszukiwanie place na podstawie LatLng.

To funkcja eksperymentalna.
point_location_source

PointSource

Tylko dane wyjściowe. Źródło pola point latlng. Jest to część funkcji eksperymentalnej.

PointSource

Wskazuje źródło LatLng.

Wartości w polu enum
POINT_SOURCE_UNSPECIFIED Nieokreślone źródło punktowe.
POINT_SOURCE_DEVELOPER_PROVIDED LatLng zostało wyraźnie podane przez dewelopera.
POINT_SOURCE_CALCULATED_FROM_PLACE Wartość LatLng została obliczona na podstawie podanego miejsca.

Zadanie

Zadanie w interfejsie Delivery API reprezentuje pojedynczą czynność do śledzenia. Ogólnie rzecz biorąc, istnieje rozróżnienie między zadaniami związanymi z przesyłką a przerwami. Z jedną przesyłką może być powiązanych wiele zadań. Na przykład może być jedno zadanie odbioru i jedno zadanie dostawy lub przekazania. Różne zadania w przypadku danej przesyłki mogą być realizowane przez różne pojazdy. Na przykład jeden pojazd może odebrać przesyłkę i dowieźć ją do centrum, a inny pojazd może przewieźć tę samą przesyłkę z centrum do miejsca docelowego.

Uwaga: interfejsy gRPC i REST API 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 REST API odnoszą się do tego samego pola.

Pola
name

string

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

Type

Wymagany. Niezmienne. Określa typ zadania. Może to być na przykład przerwa lub wysyłka.
state

State

Wymagany. Bieżący stan wykonania zadania.
task_outcome

TaskOutcome

Wynik zadania.
task_outcome_time

Timestamp

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

LocationInfo

Lokalizacja, w której ustawiono wynik Task. Ta wartość jest aktualizowana w ramach UpdateTask. Jeśli ta wartość nie zostanie wyraźnie zaktualizowana przez dostawcę, Fleet Engine domyślnie wypełni ją ostatnią znaną lokalizacją pojazdu (lokalizacją surową).
task_outcome_location_source

TaskOutcomeLocationSource

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

string

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

  • Musi to być prawidłowy ciąg znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowane zgodnie z formą normalizacji Unicode C.
  • Nie może zawierać żadnego z tych znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
delivery_vehicle_id

string

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

  • Musi to być prawidłowy ciąg znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowane zgodnie z formą normalizacji Unicode C.
  • Nie może zawierać żadnego z tych znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
planned_location

LocationInfo

Niezmienne. Lokalizacja, w której zostanie wykonane zadanie. Opcjonalny w przypadku UNAVAILABLE zadań, ale wymagany w przypadku wszystkich innych zadań.
task_duration

Duration

Wymagany. Niezmienne. Czas potrzebny na wykonanie zadania w tej lokalizacji.
target_time_window

TimeWindow

Przedział czasu, w którym należy wykonać zadanie.
journey_sharing_info

JourneySharingInfo

Tylko dane wyjściowe. Pola dotyczące udostępniania podróży. Nie jest wypełniane, gdy stan to CLOSED.
task_tracking_view_config

TaskTrackingViewConfig

Konfiguracja śledzenia zadań, która określa, które elementy danych są widoczne dla użytkowników końcowych i w jakich okolicznościach.
attributes[]

TaskAttribute

Lista niestandardowych atrybutów zadania. Każdy atrybut musi mieć unikalny klucz.

JourneySharingInfo

Pola dotyczące udostępniania podróży.

Pola
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Informacje o śledzeniu przystanków, które przypisany pojazd wykona przed zakończeniem tego zadania. Pamiętaj, że ta 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 bieżącej trasie pochodzą zwykle z aplikacji kierowcy, z wyjątkiem niektórych przypadków opisanych w dokumentacji 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. Dostarczają informacje o trasie między pozostałymi VehicleStops.
last_location

DeliveryVehicleLocation

Wskazuje ostatnią zgłoszoną lokalizację przypisanego pojazdu.
last_location_snappable

bool

Wskazuje, czy ostatnia lokalizacja pojazdu może być przyciągana do current_route_segment. Wartość to „False”, jeśli nie ma last_location lub current_route_segment. Ta wartość jest obliczana przez Fleet Engine. Aktualizacje od klientów są ignorowane.

Stan

Stan zadania. Wskazuje postęp zadania.

Wartości w polu enum
STATE_UNSPECIFIED Domyślny: Używany w przypadku nieokreślonego lub nierozpoznanego stanu zadania.
OPEN Zadanie nie zostało jeszcze przypisane do pojazdu dostawczego lub pojazd dostawczy nie dotarł jeszcze do przypisanego mu punktu odbioru Task.
CLOSED Gdy pojazd minie przystanek dla tego zadania.

TaskOutcome

Wynik próby wykonania zadania. Gdy TaskState zostanie zamknięty, TaskOutcome wskazuje, czy udało się go ukończyć.

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ę wykonać zadania lub zostało ono anulowane.

TaskOutcomeLocationSource

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

Wartości w polu enum
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED Wynik zadania przed jego ustawieniem.
PROVIDER Dostawca określił task_outcome_location.
LAST_VEHICLE_LOCATION Dostawca nie określił task_outcome_location, więc Fleet Engine użył 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 polegające na odebraniu przesyłki od klienta. W przypadku odbioru w depocie lub pojazdem dowozowym należy użyć typu SCHEDULED_STOP.
DELIVERY Zadanie dostawy to działanie podejmowane w celu dostarczenia przesyłki do klienta końcowego. W przypadku dostaw z magazynu lub pojazdu dostawczego należy użyć typu SCHEDULED_STOP.
SCHEDULED_STOP Zaplanowane zadanie zatrzymania jest używane do celów planowania. Może to być na przykład odbiór lub dostawa przesyłek z pojazdów pomocniczych lub magazynów. Nie należy go używać w przypadku przesyłek odbieranych lub dostarczanych do klienta końcowego.
UNAVAILABLE Zadanie oznaczające, że pojazd jest niedostępny. Może się tak zdarzyć, gdy kierowca robi przerwę lub gdy pojazd jest tankowany.

TaskAttribute

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

Pola
key

string

Klucz atrybutu. Klucze nie mogą zawierać dwukropka (:).
Pole unii task_attribute_value. Wartość atrybutu może być ciągiem znaków, wartością logiczną lub liczbą zmiennoprzecinkową. Jeśli żadna z nich nie jest ustawiona, wartość string_value elementu TaskAttribute będzie przechowywana jako pusty ciąg znaków „”. task_attribute_value może mieć tylko jedną z tych wartości:
string_value

string

Wartość atrybutu typu ciąg znaków.
bool_value

bool

Wartość atrybutu typu logicznego.
number_value

double

Wartość atrybutu typu double.

TaskTrackingInfo

Wiadomość TaskTrackingInfo. Wiadomość zawiera informacje o śledzeniu zadań, które będą używane do wyświetlania. Jeśli identyfikator śledzenia jest powiązany z kilkoma zadaniami, Fleet Engine używa heurystyki, aby zdecydować, które informacje TaskTrackingInfo zadania wybrać.

Pola
name

string

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

string

Niezmienne. Identyfikator śledzenia zadania. * Musi to być prawidłowy ciąg znaków Unicode. * Maksymalna długość to 64 znaki. * Znormalizowane zgodnie z Unicode Normalization Form C. * Nie może zawierać żadnego z tych znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
vehicle_location

DeliveryVehicleLocation

Ostatnia lokalizacja pojazdu.
route_polyline_points[]

LatLng

Lista punktów, które po połączeniu tworzą linię łamaną przedstawiającą oczekiwaną trasę pojazdu do miejsca wykonania tego zadania.
remaining_stop_count

Int32Value

Wskazuje liczbę przystanków pozostałych do osiągnięcia przystanku zadania, w tym przystanku zadania. Jeśli na przykład następnym przystankiem pojazdu jest przystanek zadania, wartość będzie wynosić 1.
remaining_driving_distance_meters

Int32Value

Całkowita pozostała odległość w metrach do VehicleStop.
estimated_arrival_time

Timestamp

Sygnatura czasowa wskazująca szacowany czas dotarcia 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 ustawił wynik zadania.
planned_location

LocationInfo

Niezmienne. Lokalizacja, w której zostanie wykonane zadanie.
target_time_window

TimeWindow

Przedział czasu, w którym należy wykonać zadanie.
attributes[]

TaskAttribute

Atrybuty niestandardowe ustawione w przypadku zadania.

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 zostanie określone, używana będzie domyślna konfiguracja widoczności na poziomie projektu dla tych danych.
estimated_arrival_time_visibility

VisibilityOption

Pole, które określa, kiedy może być widoczny szacowany czas przyjazdu. Jeśli to pole nie zostanie określone, używana będzie domyślna konfiguracja widoczności na poziomie projektu dla tych danych.
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 zostanie określone, używana będzie domyślna konfiguracja widoczności na poziomie projektu dla tych danych.
remaining_driving_distance_visibility

VisibilityOption

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

VisibilityOption

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

VisibilityOption

Pole określające, kiedy lokalizacja pojazdu może być widoczna. Jeśli to pole nie zostanie określone, używana będzie domyślna konfiguracja widoczności na poziomie projektu dla tych danych.

VisibilityOption

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

Pola
Pole unii 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 pozostała liczba 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 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ść dojazdu w metrach <= remaining_driving_distance_meters_threshold.
always

bool

Jeśli ta opcja jest ustawiona na wartość „true”, ten element danych jest zawsze widoczny dla użytkowników bez progów. Nie można ustawić wartości tego pola na false.
never

bool

Jeśli ma wartość Prawda, ten element danych jest zawsze ukryty przed użytkownikami bez progów. Nie można ustawić wartości tego pola na false.

TimeWindow

zakres czasu,

Pola
start_time

Timestamp

Wymagany. Godzina rozpoczęcia przedziału czasu (włącznie z tym dniem).
end_time

Timestamp

Wymagany. Godzina zakończenia przedziału czasu (włącznie z tą godziną).

UpdateDeliveryVehicleRequest

Wiadomość z prośbą o UpdateDeliveryVehicle.

Pola
header

DeliveryRequestHeader

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

DeliveryVehicle

Wymagany. Aktualizacja encji DeliveryVehicle do zastosowania. Uwaga: nie możesz zmienić nazwy DeliveryVehicle.
update_mask

FieldMask

Wymagany. Maska pola, która wskazuje, które pola DeliveryVehicle mają zostać zaktualizowane. Pamiętaj, że maska aktualizacji musi zawierać co najmniej 1 pole.

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

UpdateTaskRequest

Wiadomość z prośbą o UpdateTask.

Pola
header

DeliveryRequestHeader

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

Task

Wymagany. Zadanie powiązane z aktualizacją. Te pola są obsługiwane przez Fleet Engine. Nie aktualizuj ich za pomocą ikony 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 dostawczego, nie ustawiaj stanu zadania na ZAMKNIĘTE za pomocą Task.update. Zamiast tego usuń VehicleStop zawierający zadanie z pojazdu dostawczego. Spowoduje to automatyczne ustawienie stanu zadania na ZAMKNIĘTE.
update_mask

FieldMask

Wymagany. Maska pola, która wskazuje, które pola zadania mają zostać zaktualizowane. Uwaga: element update_mask musi zawierać co najmniej 1 pole.

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

VehicleJourneySegment

Reprezentuje odcinek podróży pojazdu – od poprzedniego do bieżącego przystanku. Jeśli jest to pierwszy aktywny przystanek, trasa prowadzi od bieżącej lokalizacji pojazdu do tego przystanku.

Pola
stop

VehicleStop

Określa lokalizację przystanku wraz z powiązanymi z nim Task. Niektóre pola VehicleStop mogą być niedostępne, jeśli ten segment podróży jest częścią JourneySharingInfo.
driving_distance_meters

Int32Value

Tylko dane wyjściowe. Odległość podróży od poprzedniego do tego przystanku. Jeśli bieżący przystanek jest pierwszym przystankiem na liście odcinków podróży, punktem początkowym jest lokalizacja pojazdu zarejestrowana w momencie dodania tego przystanku do listy. To pole może nie być widoczne, jeśli ten segment ścieżki jest częścią JourneySharingInfo.
driving_duration

Duration

Tylko dane wyjściowe. Czas podróży od poprzedniego przystanku do tego przystanku. Jeśli bieżący 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 zawierać wartość z pola DeliveryVehicle.remaining_duration (gRPC) lub DeliveryVehicle.remainingDuration (REST). Dzięki temu w aplikacji kierowcy będzie wyświetlany pozostały czas dojazdu od ostatniej znanej lokalizacji, a nie czas dojazdu od poprzedniego przystanku.
path[]

LatLng

Tylko dane wyjściowe. Ścieżka od poprzedniego do tego przystanku. Jeśli bieżący przystanek jest pierwszym przystankiem na liście odcinków podróży, jest to ścieżka od bieżącej lokalizacji pojazdu do tego przystanku w momencie dodania go do listy. To pole może nie być widoczne, jeśli ten segment ścieżki jest częścią 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że być wypełnione wartościami LatLng zdekodowanymi z pola DeliveryVehicle.current_route_segment (gRPC) lub DeliveryVehicle.currentRouteSegment (REST). W ten sposób wyznaczana jest trasa dojazdu od ostatniej znanej lokalizacji w aplikacji kierowcy, a nie od poprzedniego przystanku.

VehicleStop

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

Pola
planned_location

LocationInfo

Wymagany. Lokalizacja przystanku. Pamiętaj, że lokalizacje w Task mogą nie być dokładnie takie same jak ta lokalizacja, ale będą znajdować się w niewielkiej odległości od niej. To pole nie będzie wypełnione w odpowiedzi na wywołanie GetTask.
tasks[]

TaskInfo

Lista Task, które mają być wykonane na tym przystanku. To pole nie będzie wypełnione w odpowiedzi na wywołanie GetTask.
state

State

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

Stan

Bieżący stan VehicleStop.

Wartości w polu enum
STATE_UNSPECIFIED Nieznany.
NEW Utworzono, ale nie jest aktywnie kierowany.
ENROUTE Przypisane i aktywnie kierowane.
ARRIVED Dotarliśmy na przystanek. Zakłada, że gdy pojazd jedzie do następnego przystanku, wszystkie poprzednie przystanki zostały już obsłużone.

TaskInfo

Dodatkowe informacje o zadaniu wykonanym na tym przystanku.

Pola
task_id

string

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

  • Musi to być prawidłowy ciąg znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowane zgodnie z formą normalizacji Unicode C.
  • Nie może zawierać żadnego z tych znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
task_duration

Duration

Tylko dane wyjściowe. czas potrzebny na wykonanie zadania;
target_time_window

TimeWindow

Tylko dane wyjściowe. Przedział czasu, w którym należy wykonać zadanie. Jest ona ustawiana tylko w odpowiedzi na żądanie GetDeliveryVehicle.