Package maps.fleetengine.delivery.v1

Indeks

DeliveryService

Usługa dostawy ostatniej mili.

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

Tworzy i zwraca grupę 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.
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 obiekty DeliveryVehicle, które spełniają określone kryteria filtrowania.
ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

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

rpc SearchTasks(SearchTasksRequest) returns (SearchTasksResponse)

Wycofane: użyj zasady GetTaskTrackingInfo.
UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Zapisuje zaktualizowane dane DeliveryVehicle we Fleet Engine i przypisuje Tasks do funkcji DeliveryVehicle. Nie możesz zmienić nazwy DeliveryVehicle. Możesz jednak zaktualizować remaining_vehicle_journey_segments, ale musi ona zawierać wszystkie VehicleJourneySegment moduły DeliveryVehicle. Elementy task_id są pobierane z: 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ą o BatchCreateTask.

Pola
header

DeliveryRequestHeader

Opcjonalnie. Standardowy nagłówek żądania do interfejsu Delivery API. Uwaga: jeśli skonfigurujesz to pole, pole nagłówka w wiadomościach CreateTaskRequest musi być puste lub musi być zgodne z tym polem.
parent

string

Wymagane. Zasób nadrzędny udostępniany przez wszystkie zadania. Ta wartość musi mieć format providers/{provider}. Wartość provider musi być identyfikatorem projektu Google Cloud. Na przykład: sample-cloud-project. Pole nadrzędne w wiadomościach CreateTaskRequest musi być puste lub musi być zgodne z tym polem.
requests[]

CreateTaskRequest

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

BatchCreateTasksResponse

Wiadomość z odpowiedzią BatchCreateTask.

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

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

string

Wymagane. Identyfikator pojazdu dostarczającego musi być unikalny i podlegać tym ograniczeniom:

  • Musi być prawidłowym ciągiem Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowany zgodnie z postaci normalizacji Unicode C.
  • Nazwa nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
delivery_vehicle

DeliveryVehicle

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

  • last_location
  • atrybuty

Uwaga: pole name w polu DeliveryVehicle jest ignorowane. Nie wolno ustawiać żadnych innych pól obiektu DeliveryVehicle. W przeciwnym razie zostanie zwrócony błąd.

CreateTaskRequest

Wiadomość z prośbą o CreateTask.

Pola
header

DeliveryRequestHeader

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

string

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

string

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

  • Musi być prawidłowym ciągiem Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowany zgodnie z postaci normalizacji Unicode C.
  • Nazwa nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
task

Task

Wymagane. Encja zadania do utworzenia. Podczas tworzenia zadania musisz wypełnić te pola:

  • type
  • state (musi być ustawiona na OPEN)
  • tracking_id (nie można ustawić dla zadań UNAVAILABLE ani SCHEDULED_STOP, ale wymagane w przypadku wszystkich innych typów zadań)
  • planned_location (opcjonalnie dla UNAVAILABLE zadań)
  • task_duration

Uwaga: pole name zadania jest ignorowane. Nie wolno ustawiać wartości innych pól z listą zadań. W przeciwnym razie zostanie zwrócony błąd.

DeliveryRequestHeader

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

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. W przypadku takiej nazwy preferowana jest angielski. 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 (w stosownych przypadkach). Format wersji to „główna.podrzędna.poprawka”, na przykład: 1.1.2.
os_version

string

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

string

Model urządzenia, na którym działa wywołujący pakiet SDK. Przykładowe 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 MapSDK, od którego zależy pakiet SDK wywołujący (w stosownych przypadkach). Format wersji to „główna.podrzędna.poprawka”, na przykład: 5.2.1.
nav_sdk_version

string

Wersja pakietu NavSDK, od której zależy wywołujący SDK (w stosownych przypadkach). Format wersji to „główna.podrzędna.poprawka”, na przykład: 2.1.0.
platform

Platform

Platforma wywołującego pakietu SDK.
manufacturer

string

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

int32

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

string

Opcjonalny identyfikator, który można podać na potrzeby logowania w celu identyfikacji żądania.

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 została pominięta.
ANDROID Żądanie pochodzi z Androida.
IOS Żądanie pochodzi z iOS.
WEB Żądanie pochodzi z internetu.

SdkType

Możliwe typy pakietów SDK.

Wartości w polu enum
SDK_TYPE_UNSPECIFIED Wartość domyślna. Ta wartość jest używana, jeśli pominięto sdk_type.
CONSUMER Wywołujący pakiet SDK to konsument.
DRIVER Wywołujący pakiet SDK to Sterownik.
JAVASCRIPT Wywołujący pakiet SDK to JavaScript.

DeliveryVehicle

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

Uwaga: w interfejsach API gRPC i REST stosowane są różne konwencje nazewnictwa pól. Na przykład pole DeliveryVehicle.current_route_segment w interfejsie gRPC API i pole DeliveryVehicle.currentRouteSegment w interfejsie API REST odwołują się do tego samego pola.

Pola
name

string

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

DeliveryVehicleLocation

Ostatnio zgłoszona lokalizacja pojazdu dostawczego.
navigation_status

DeliveryVehicleNavigationStatus

Stan nawigacji pojazdu dostawczego.
current_route_segment

bytes

Zakodowana linia łamana określająca trasę, którą rekomenduje nawigacja do następnego punktu na trasie. Aplikacja kierowcy aktualizuje te dane, gdy dotrzesz do przystanku lub mijasz dany przystanek 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) dla wszystkich aktywnych zadań przypisanych do pojazdu.

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

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

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

  • Aplikacja kierowcy zaktualizowała niedawno swoją lokalizację, ale urządzenie current_route_segment jest nieaktualne i wskazuje poprzedni postój na pojeździe.

W takich przypadkach Fleet Engine wypełnia to pole trasą z ostatniego pola VehicleStop do zbliżającego się VehicleStop, aby zapewnić konsumentowi informacje na temat aktualnej ścieżki pojazdu dostawczego.
current_route_segment_end_point

LatLng

Lokalizacja, w której kończy się tekst current_route_segment. Ten obszar nie jest obecnie wypełniany przez aplikację kierowcy, ale możesz go podawać podczas połączeń w sieci UpdateDeliveryVehicle. To LatLng z nadchodzącego przystanku pojazdu lub ostatni LatLng z current_route_segment. Następnie Fleet Engine dołoży wszelkich starań, aby interpolować do rzeczywistego 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ść dojazdu samochodem z: current_route_segment. To pole jest zwykle dostępne w aplikacji Driver, ale w pewnych okolicznościach Fleet Engine zastąpi wartość przesłaną przez aplikację. Więcej informacji znajdziesz na stronie DeliveryVehicle.current_route_segment. To pole jest zwracane w funkcji Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) lub Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) w przypadku wszystkich aktywnych elementów Task przypisanych do pojazdu dostawy.

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. To pole jest zwykle dostępne w aplikacji Driver, ale w pewnych okolicznościach Fleet Engine zastąpi wartość przesłaną przez aplikację. Więcej informacji znajdziesz na stronie DeliveryVehicle.current_route_segment. To pole jest zwracane w funkcji 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łaszanej lokalizacji pojazdu. To pole nie zostanie wypełnione w odpowiedzi ListDeliveryVehicles.
attributes[]

DeliveryVehicleAttribute

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

DeliveryVehicleType

Typ pojazdu dostawczego. Jeśli zasada nie jest skonfigurowana, domyślna wartość to AUTO.

DeliveryVehicleType

Typ pojazdu dostawczego.

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 Osoba transportowa, zazwyczaj idąca lub biegająca, podróżująca po chodnikach.

DeliveryVehicleAttribute

Opisuje atrybut pojazdu w postaci pary 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 sumy delivery_vehicle_attribute_value. Wartość atrybutu może być ciągiem znaków, wartością logiczną lub typem typu double. delivery_vehicle_attribute_value może być tylko jedną z tych wartości:
string_value

string

Wartość atrybutu wpisanego przez ciąg znaków.

Uwaga: to pole jest takie samo jak pole value, które zostanie ostatecznie wycofane. W przypadku metod tworzenia lub aktualizacji możesz używać dowolnego z tych pól, ale zdecydowanie zalecamy używanie właściwości string_value. Jeśli ustawisz zarówno wartość string_value, jak i value, muszą być one identyczne. W przeciwnym razie wystąpi błąd. Oba pola są wypełniane w odpowiedziach.
bool_value

bool

Wartość atrybutu o typie logicznym.
number_value

double

Podwójna wartość atrybutu.

DeliveryVehicleLocation

Lokalizacja, prędkość i kierunek pojazdu w określonym czasie.

Pola
location

LatLng

Lokalizacja pojazdu. Gdy dane są wysyłane do Fleet Engine, lokalizacja pojazdu jest lokalizacją GPS. Gdy otrzymasz informację o lokalizacji pojazdu, możesz podać lokalizację pojazdu według GPS, lokalizację dodatkową lub inną orientacyjną lokalizację. Źródło jest określone w polu location_sensor.
horizontal_accuracy
(deprecated)

DoubleValue

Wycofane: użyj zasady latlng_accuracy.
latlng_accuracy

DoubleValue

Dokładność location w metrach jako promienia.
heading

Int32Value

Kierunek ruchu pojazdu w stopniach. 0 oznacza północ. Prawidłowy zakres to [0,360).
bearing_accuracy
(deprecated)

DoubleValue

Wycofane: użyj zasady heading_accuracy.
heading_accuracy

DoubleValue

Dokładność heading w stopniach.
altitude

DoubleValue

Wysokość w metrach powyżej WGS84.
vertical_accuracy
(deprecated)

DoubleValue

Wycofane: użyj zasady altitude_accuracy.
altitude_accuracy

DoubleValue

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

Int32Value

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

DoubleValue

Prędkość pojazdu w metrach/s
speed_accuracy

DoubleValue

Dokładność speed w metrach/s.
update_time

Timestamp

Czas zgłoszenia wartości location przez czujnik, zgodny z jego zegarem.
server_time

Timestamp

Tylko dane wyjściowe. Godzina, o której serwer otrzymał informacje 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 wejście. Wskazuje, czy czujnik GPS jest włączony na urządzeniu mobilnym.
time_since_update

Int32Value

Tylko wejście. Czas (w sekundach) od wysłania tej lokalizacji do serwera po raz pierwszy. Przy pierwszej aktualizacji będzie to zero. Jeśli czas jest nieznany (np. podczas ponownego uruchamiania aplikacji), ta wartość jest resetowana.
num_stale_updates
(deprecated)

Int32Value

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

LatLng

Przybliżona lokalizacja pojazdu (nieprzetworzona przez snappera).
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 promienia w metrach.
supplemental_location

LatLng

Dodatkowa lokalizacja podana przez aplikację integracyjną.
supplemental_location_time

Timestamp

Sygnatura czasowa zwią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 promienia w metrach.
road_snapped
(deprecated)

bool

Wycofane: użyj zasady is_road_snapped.

DeliveryVehicleLocationSensor

Czujnik lub metodologia użyta 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 lub punkt dostępu Wi-Fi.
PASSIVE Identyfikator stacji bazowej lub punkt dostępu Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Lokalizacja określona przez urządzenie mobilne jako najbardziej prawdopodobne miejsce na drodze.
CUSTOMER_SUPPLIED_LOCATION Lokalizacja podana przez klienta z niezależnego źródła. Zwykle ta wartość jest używana w przypadku lokalizacji podawanej ze źródeł innych niż urządzenie mobilne, na którym działa pakiet SDK sterownika. Jeśli pierwotne źródło jest opisane przez jedną 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 pojazdu dostawczego.
FLEET_ENGINE_LOCATION Lokalizacja obliczona przez Fleet Engine na podstawie dostępnych sygnałów. Tylko dane wyjściowe. Ta wartość zostanie odrzucona, jeśli zostanie przesłana 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 w aplikacji kierowcy jest włączony 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

Wymagane. Musi mieć format providers/{provider}/deliveryVehicles/{delivery_vehicle}. Wartość provider musi być identyfikatorem 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

Wymagane. Musi mieć format providers/{provider}/tasks/{task}. Wartość provider musi być identyfikatorem 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

Wymagane. Musi mieć format providers/{provider}/taskTrackingInfo/{tracking_id}. Elementem provider musi być identyfikator projektu Google Cloud, a tracking_id musi być identyfikatorem śledzenia powiązanym z zadaniem. Przykładowa nazwa: 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

Wymagane. Musi mieć format providers/{provider}. Wartość provider musi być identyfikatorem 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ć mniej niż ta liczba. Jeśli nie określisz tej liczby, serwer określa liczbę wyników do zwrócenia.
page_token

string

Opcjonalnie. Token strony odebrany z poprzedniego wywołania ListDeliveryVehicles. Należy je podać w celu pobrania kolejnej strony.

W przypadku podziału na strony wszystkie pozostałe parametry podane w interfejsie ListDeliveryVehicles muszą odpowiadać wywołaniu, które podało token strony.
filter

string

Opcjonalnie. Zapytanie filtra, które ma być stosowane przy wyświetlaniu informacji o pojazdach dostawczych. Przykłady składni filtra znajdziesz na http://aip.dev/160. Jeśli nie określisz wartości lub określisz pusty ciąg w filtrze, zwrócone zostaną 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ą przechowywane w postaci ciągów znaków, więc jedynymi obsługiwanymi porównaniami z atrybutami są porównania w postaci ciągów znaków. Aby można było porównać wartości z liczbami lub wartościami logicznymi, muszą one być 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 formacie attribute.<KEY> <COMPARATOR> <VALUE>, na przykład attributes.foo = bar to 1 ograniczenie.
viewport

Viewport

Opcjonalnie. Filtr ograniczający zwracane pojazdy do tych, których ostatnią znaną lokalizację znajdowała się w prostokątnym obszarze zdefiniowanym w widocznym obszarze.

ListDeliveryVehiclesResponse

Wiadomość z odpowiedzią ListDeliveryVehicles.

Pola
delivery_vehicles[]

DeliveryVehicle

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

string

Możesz przekazać ten token w ListDeliveryVehiclesRequest, aby kontynuować wyświetlanie wyników. Po zwróceniu wszystkich wyników to pole nie pojawi się w odpowiedzi lub będzie pustym ciągiem znaków.
total_size

int64

Łączna liczba pojazdów dostawczych, które spełniają 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

Wymagane. Musi mieć format providers/{provider}. Wartość 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ć mniejszą wartość od tej wartości. Jeśli nie określisz tej wartości, serwer określa liczbę wyników do zwrócenia.
page_token

string

Opcjonalnie. Token strony odebrany z poprzedniego wywołania ListTasks. Możesz je podać, by pobrać kolejną stronę.

W przypadku podziału na strony wszystkie pozostałe parametry podane w interfejsie ListTasks muszą odpowiadać wywołaniu, które podało token strony.
filter

string

Opcjonalnie. Zapytanie filtra do zastosowania przy wyświetlaniu listy zadań. Przykłady składni filtra znajdziesz na http://aip.dev/160. Jeśli nie określisz wartości lub filtrujesz pusty ciąg znaków, zwracane są wszystkie zadania. Więcej informacji o właściwościach listy 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 filtrowania w 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ź też może być pusta. Pusta odpowiedź oznacza, że nie znaleziono żadnych zadań spełniających żądane kryteria filtra.
next_page_token

string

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

int64

Łączna liczba zadań na wszystkich stronach, które pasują do kryteriów żądania.

LocationInfo

lokalizację z dodatkowymi identyfikatorami;

Pola
point

LatLng

Współrzędne lokalizacji.

SearchTasksRequest

Wycofano: zamiast tego wyślij problemy GetTaskTrackingInfoRequest do interfejsu GetTaskTrackingInfo.

Pola
header

DeliveryRequestHeader

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

string

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

string

Wymagane. Identyfikator zestawu powiązanych zadań, których dotyczy żądanie. Identyfikatory śledzenia podlegają następującym ograniczeniom:

  • Musi być prawidłowym ciągiem Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowany zgodnie z postaci normalizacji Unicode C.
  • Nazwa nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
page_size

int32

Opcjonalnie. Maksymalna liczba zadań do zwrócenia. Usługa może zwrócić mniejszą wartość od tej wartości. Jeśli nie określisz tej wartości, serwer określa liczbę wyników do zwrócenia.
page_token

string

Opcjonalnie. Token strony odebrany z poprzedniego wywołania SearchTasks. Musisz podać tę wartość, aby pobrać kolejną stronę.

W przypadku podziału na strony wszystkie pozostałe parametry podane w interfejsie SearchTasks muszą odpowiadać wywołaniu, które podało token strony.

SearchTasksResponse

Odpowiedź SearchTasks. Zawiera zestaw Listy zadań, które spełniają kryteria wyszukiwania w SearchTasksRequest.

Pola
tasks[]

Task

Zestaw zadań dla żądanego tracking_id. Pomyślna odpowiedź też może być pusta. Pusta odpowiedź oznacza, że z podanym atrybutem tracking_id nie są powiązane żadne zadania.
next_page_token

string

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

Działanie

Task API w interfejsie Delivery API reprezentuje jedno działanie do śledzenia. Ogólnie istnieje rozróżnienie między zadaniami związanymi z dostawą i zadaniami dotyczącymi awarii. Z przesyłką może być powiązanych wiele zadań. Może to być na przykład jedno zadanie dotyczące odbioru i jednego zadania polegającego na odesłaniu lub przesiadce. Różne pojazdy mogą być też obsługiwane przez różne zadania dla danej przesyłki. Jeden pojazd może na przykład obsługiwać odbiór i przewieźć przesyłkę do centrum, a inny – z centrum do odbioru.

Uwaga: w interfejsach API gRPC i REST stosowane są różne konwencje nazewnictwa pól. Na przykład pole Task.journey_sharing_info w interfejsie gRPC API i pole Task.journeySharingInfo w interfejsie API REST odwołują się do tego samego pola.

Pola
name

string

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

Type

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

State

Wymagane. Bieżący stan wykonania zadania.
task_outcome

TaskOutcome

Rezultat wykonania zadania.
task_outcome_time

Timestamp

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

LocationInfo

Lokalizacja, w której ustawiono wynik działania funkcji Task. Ta wartość jest aktualizowana w ramach: UpdateTask. Jeśli dostawca nie zaktualizuje tej wartości, Fleet Engine domyślnie uzupełni ją ostatnią znaną lokalizacją pojazdu (nieprzetworzoną).
task_outcome_location_source

TaskOutcomeLocationSource

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

string

Stałe. To pole ułatwia przechowywanie dokumentu tożsamości, dzięki czemu można uniknąć używania skomplikowanego mapowania. Nie można ustawić tracking_id dla Listy zadań typu UNAVAILABLE i SCHEDULED_STOP. Identyfikatory te podlegają następującym ograniczeniom:

  • Musi być prawidłowym ciągiem Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowany zgodnie z postaci normalizacji Unicode C.
  • Nazwa 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 dostawczych podlegają następującym ograniczeniom:

  • Musi być prawidłowym ciągiem Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowany zgodnie z postaci normalizacji Unicode C.
  • Nazwa nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
planned_location

LocationInfo

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

Duration

Wymagane. Stałe. 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 serii czynności. Brak wypełnienia, 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 w jakich okolicznościach.
attributes[]

TaskAttribute

Lista niestandardowych atrybutów zadania. 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 przystankach, które zatrzyma przydzielony pojazd 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 z ostatniej znanej lokalizacji kierowcy do najbliższego VehicleStop. Aktualne informacje o trasie pochodzą zwykle z aplikacji kierowcy, z wyjątkiem niektórych przypadków wymienionych w dokumentacji dotyczącej urządzenia 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 pozostałymi (VehicleStops).
last_location

DeliveryVehicleLocation

Wskazuje ostatnią zarejestrowaną lokalizację przypisanego pojazdu.
last_location_snappable

bool

Wskazuje, czy parametr lastLocation pojazdu może być przyciągnięty do obiektu current_route_segment. Ta wartość to False, jeśli last_location lub current_route_segment nie istnieje. Ta wartość jest obliczana przez Fleet Engine. Aktualizacje klientów są ignorowane.

Stan

Stan zadania. Pokazuje postęp wykonywania 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 pojazd ten nie minął jeszcze przystanku przypisanego użytkownikowi Task.
CLOSED Gdy pojazd mija zatrzymujący się w ramach tego zadania.

TaskOutcome

Wynik próby wykonania zadania. Jeśli projekt TaskState jest zamknięty, TaskOutcome wskazuje, czy zostało ono zakończone.

Wartości w polu enum
TASK_OUTCOME_UNSPECIFIED Wynik funkcji Task, zanim zostanie ustawiona jego wartość.
SUCCEEDED Zadanie zostało wykonane.
FAILED Zadanie nie mogło zostać ukończone lub zostało 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ł wartość task_outcome_location.
LAST_VEHICLE_LOCATION Dostawca nie podał task_outcome_location, więc Fleet Engine użyło 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 podjęte w celu odebrania przesyłki od klienta. W przypadku odbioru pojazdów z łazienki lub podajnika należy używać typu SCHEDULED_STOP.
DELIVERY Zadanie dostawy to działanie podjęte w celu dostarczenia przesyłki do klienta końcowego. W przypadku pojazdów do obsługi pojazdów lub dostawczych należy używać typu SCHEDULED_STOP.
SCHEDULED_STOP Zadanie zaplanowanego zatrzymania jest używane do planowania. Może to być na przykład odbieranie lub odbieranie przesyłek z pojazdów dostarczających lub magazynów. Nie należy go używać w przypadku przesyłek, które zostały odebrane lub dostarczone 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 gdy pojazd jest tankowany.

TaskAttribute

Opisuje atrybut zadania w postaci pary 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ć znaku dwukropka (:).
Pole sumy task_attribute_value. Wartość atrybutu może być ciągiem znaków, wartością logiczną lub typem typu double. Jeśli nie ustawiono żadnej wartości, atrybut TaskAttribute ciąg_value będzie przechowywany jako pusty ciąg znaków „”. task_attribute_value może być tylko jedną z tych wartości:
string_value

string

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

bool

Wartość atrybutu o typie logicznym.
number_value

double

Podwójna wartość atrybutu.

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 na podstawie heurystyki określa, którą właściwość TaskTrackingInfo wybierze.

Pola
name

string

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

string

Stałe. Identyfikator śledzenia zadania. * Musi być prawidłowym ciągiem Unicode. * Maksymalna długość to 64 znaki. * Znormalizowany zgodnie z formularzem normalizacji Unicode C. * Nazwa nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
vehicle_location

DeliveryVehicleLocation

Ostatnie miejsce pobytu pojazdu.
route_polyline_points[]

LatLng

Lista punktów, które po połączeniu tworzą linię łamaną oczekiwanej trasy pojazdu do miejsca, w którym zostanie wykonane to zadanie.
remaining_stop_count

Int32Value

Wskazuje liczbę postojów pozostałych pojazdu do momentu zatrzymania zadania (w tym postoje). Jeśli na przykład następny przystanek pojazdu to postój na zadania, wartość będzie wynosić 1.
remaining_driving_distance_meters

Int32Value

Całkowity pozostały dystans (w metrach) do VehicleStop interesujących.
estimated_arrival_time

Timestamp

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

LocationInfo

Stałe. 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 dla zadania.

TaskTrackingViewConfig

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

Pola
route_polyline_points_visibility

VisibilityOption

Pole, które określa, kiedy punkty linii łamanej na trasie mogą być widoczne. Jeśli to pole nie zostanie określone, dla tych danych będzie używana domyślna konfiguracja widoczności na poziomie projektu.
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, dla tych danych będzie używana 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 zostanie określone, dla tych danych będzie używana domyślna konfiguracja widoczności na poziomie projektu.
remaining_driving_distance_visibility

VisibilityOption

Pole, które określa pozostały dystans jazdy, może być widoczne. Jeśli to pole nie zostanie określone, dla tych danych będzie używana domyślna konfiguracja widoczności na poziomie projektu.
remaining_stop_count_visibility

VisibilityOption

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

VisibilityOption

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

Pola
Pole sumy visibility_option. Wybrana opcja widoczności. visibility_option może być 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 jest <= pozostało <=}
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ść przejazdu w metrach jest równa <= pozostała_długość_drugowy_długości_miary_threshold.
always

bool

Jeśli ma wartość Prawda, ten element danych jest zawsze widoczny dla użytkowników bez żadnych progów. Tego pola nie można ustawić na wartość Fałsz.
never

bool

Jeśli zasada ma wartość Prawda, ten element danych jest zawsze ukryty przed użytkownikami bez progów. Tego pola nie można ustawić na wartość 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ą o 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 DeliveryVehicle.
update_mask

FieldMask

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

Jest to rozdzielona przecinkami lista pełnych i jednoznacznych nazw pól. 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

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 dostawczego, nie ustawiaj stanu zadania na ZAMKNIĘTE, używając funkcji Task.update. Zamiast tego usuń z pojazdu dostawczego zadanie VehicleStop, które zawiera zadanie – spowoduje to automatyczne ustawienie stanu zadania na ZAMKNIĘTE.
update_mask

FieldMask

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

Jest to rozdzielona przecinkami lista pełnych i jednoznacznych nazw pól. Przykład: "task_outcome,task_outcome_time,task_outcome_location".

VehicleJourneySegment

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

Pola
stop

VehicleStop

Określa lokalizację przystanku i informacje o nim (Task) powiązane z przystankiem. Jeśli ten fragment podróży należy do: JourneySharingInfo, niektóre pola mogą być niedostępne.
driving_distance_meters

Int32Value

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

Duration

Tylko dane wyjściowe. Czas podróży z poprzedniego przystanku do tego przystanku. Jeśli bieżący przystanek jest pierwszym przystankiem na liście segmentów przejazdu, 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 zostać 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 z poprzedniego przystanku.
path[]

LatLng

Tylko dane wyjściowe. Ścieżka od poprzedniego przystanku do tego przystanku. Jeśli bieżący przystanek jest pierwszym przystankiem na liście segmentów przejazdu, jest to ścieżka od bieżącej lokalizacji pojazdu do tego przystanku w momencie dodania przystanku do listy. To pole może nie być obecne, 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 DeliveryVehicle.current_route_segment (gRPC) lub DeliveryVehicle.currentRouteSegment (REST). Wyświetla ścieżkę dojazdu z ostatniej znanej lokalizacji aplikacji kierowcy, a nie z poprzedniego przystanku.

VehicleStop

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

Pola
planned_location

LocationInfo

Wymagane. Lokalizacja przystanku. Lokalizacje w tym regionie (Task) mogą nie odpowiadać dokładnie tej lokalizacji, ale znajdują się w niewielkiej odległości od niej. To pole nie będzie wypełniane w odpowiedzi na wywołanie GetTask ani SearchTasks.
tasks[]

TaskInfo

Lista zadań Task do wykonania na tym przystanku. To pole nie będzie wypełniane w odpowiedzi na wywołanie GetTask ani SearchTasks.
state

State

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

Stan

Obecny stan obiektu VehicleStop.

Wartości w polu enum
STATE_UNSPECIFIED Nieznany.
NEW Utworzono, ale kierowanie jest nieaktywne.
ENROUTE Przypisany i aktywny routing.
ARRIVED Dotarłeś do przystanku. Zakładamy, że gdy pojazd jest w kierunku do następnego przystanku, wszystkie poprzednie postoje zostały zakończone.

TaskInfo

Dodatkowe informacje o zadaniu wykonanym na tym przystanku.

Pola
task_id

string

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

  • Musi być prawidłowym ciągiem Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowany zgodnie z postaci normalizacji Unicode C.
  • Nazwa nie może zawierać następujących 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. Ten parametr jest ustawiony tylko w odpowiedzi na GetDeliveryVehicle.