Package maps.fleetengine.delivery.v1

DeliveryRequestHeader

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

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 pasować do tego pola.

CreateTaskRequest

Wymagane. Komunikat z prośbą o utworzenie zasobów. Uwaga: możesz utworzyć maksymalnie 500 zadań w ramach jednego zbiorczego zadania.

Task

utworzone zadania.

DeliveryRequestHeader

Opcjonalnie: standardowy nagłówek żądania interfejsu Delivery API;

string

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

string

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

• Musi to być prawidłowy ciąg znaków Unicode.
• Może mieć maksymalnie 64 znaki.
• znormalizowany zgodnie z formą normalizacji C standardu Unicode.
• Nie może zawierać tych znaków ASCII: '/', ':', '?', ',' ani '#'.

DeliveryVehicle

Wymagane. Element DeliveryVehicle do utworzenia. Podczas tworzenia nowego pojazdu dostawczego możesz wypełnić te pola opcjonalne:

• typ
• last_location
• atrybuty

Uwaga: pole name w przypadku dostawy pojazdu jest ignorowane. Wszystkie pozostałe pola DeliveryVehicle nie mogą być ustawione, w przeciwnym razie zwracany jest błąd.

DeliveryRequestHeader

Opcjonalnie: standardowy nagłówek żądania interfejsu Delivery API;

string

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

string

Wymagane. 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 ta sama wartość tracking_id może występować w przypadku wielu zadań. Identyfikatory zadań podlegają tym ograniczeniom:

• Musi być prawidłowym ciągiem znaków Unicode.
• Może mieć maksymalnie 64 znaki.
• znormalizowany zgodnie z formą normalizacji C standardu Unicode.
• Nie może zawierać tych znaków ASCII: '/', ':', '?', ',' ani '#'.

Task

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

• type
• state (musi mieć wartość OPEN)
• tracking_id (nie musi być ustawiony w przypadku 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 w zadaniu jest ignorowane. Wszystkie pozostałe pola zadania nie mogą być ustawione, w przeciwnym razie zwracany jest błąd.

string

Kod języka BCP-47, np. pl-PL 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.

string

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

string

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

string

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

string

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

SdkType

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

string

Wersja MapSDK, z której korzysta wywoływany pakiet SDK (w odpowiednich przypadkach). Format wersji to „major.minor.patch”, np. 5.2.1.

string

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

Platform

Platforma pakietu SDK wywołującego.

string

Producent urządzenia z Androidem wywołującego pakiet SDK (dotyczy tylko pakietów SDK na Androida). Przykład wartości pola: Samsung.

int32

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

string

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

string

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

DeliveryVehicleLocation

Ostatnia zgłoszona lokalizacja pojazdu dostawczego.

DeliveryVehicleNavigationStatus

Stan nawigacji pojazdu dostawczego.

bytes

Zaszyfrowana linia łamana określająca trasę, którą nawigacja zaleca przejechać do następnego punktu orientacyjnego. Aplikacja kierowcy aktualizuje te informacje, gdy kierowca dotrze do przystanku lub minie go, a także 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 kilku przypadkach tego pola nie można użyć do wypełnienia pola Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) ani pola 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 kierowcy nie zaktualizowała ostatnio lokalizacji, więc ostatnia zaktualizowana wartość tego pola może być nieaktualna.

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

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.

LatLng

Lokalizacja, w której kończy się current_route_segment. Obecnie aplikacja kierowcy nie wypełnia tego pola, ale możesz podać je podczas połączenia UpdateDeliveryVehicle. Jest to LatLng z najbliższego przystanku pojazdu lub ostatni LatLng z current_route_segment. Fleet Engine zrobi wszystko, co w jego mocy, aby interpolować rzeczywistą wartość VehicleStop.

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

Int32Value

Pozostała odległość do przejechania w przypadku current_route_segment. To pole jest zwykle dostępne w aplikacji Kierowca, ale w niektórych okolicznościach silnik Fleet Engine może zastąpić wartość przesłaną przez aplikację. Więcej informacji znajdziesz w artykule DeliveryVehicle.current_route_segment. To pole jest zwracane w Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) lub Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) w przypadku wszystkich aktywnych Task przypisanych do pojazdu dostawczego.

Silnik floty ignoruje to pole w elementach UpdateDeliveryVehicleRequest, jeśli pole current_route_segment jest puste.

Duration

Pozostały czas jazdy w przypadku current_route_segment. To pole jest zwykle dostępne w aplikacji Kierowca, ale w niektórych okolicznościach silnik Fleet Engine może zastąpić wartość przesłaną przez aplikację. Więcej informacji znajdziesz w artykule DeliveryVehicle.current_route_segment. To pole jest zwracane w 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.

VehicleJourneySegment

Odcinki trasy przypisane do tego pojazdu dostawczego, zaczynając od ostatnio zgłoszonej lokalizacji pojazdu. To pole nie będzie wypełniane w odpowiedzi na ListDeliveryVehicles.

DeliveryVehicleAttribute

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

DeliveryVehicleType

Typ pojazdu dostawczego. Jeśli nie są ustawione, Google przyjmuje domyślnie AUTO.

string

Klucz atrybutu.

string

Wartość atrybutu.

string

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

Uwaga: działa tak samo jak pole value, które z czasem zostanie wycofane. W przypadku metod tworzenia lub aktualizowania możesz użyć dowolnego pola, ale zdecydowanie zalecamy użycie pola string_value. Jeśli opcje string_value i value są ustawione, muszą być identyczne, w przeciwnym razie wystąpi błąd. Oba pola są wypełniane w odpowiedziach.

bool

Wartość atrybutu typu logicznego.

double

Wartość atrybutu typu podwójnego.

LatLng

Lokalizacja pojazdu. Gdy jest wysyłany do Fleet Engine, lokalizacja pojazdu to 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.

DoubleValue

Wycofane: użyj w zastępstwie zasady latlng_accuracy.

DoubleValue

Dokładność location m w promieniach.

Int32Value

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

DoubleValue

Wycofane: użyj atrybutu heading_accuracy.

DoubleValue

Dokładność: heading w stopniach.

DoubleValue

Wysokość w metrach nad WGS84.

DoubleValue

Wycofane: użyj w zastępstwie zasady altitude_accuracy.

DoubleValue

Dokładność altitude w metrach.

Int32Value

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

DoubleValue

Prędkość pojazdu w metrach/s

DoubleValue

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

Timestamp

Czas, w którym czujnik location został zgłoszony przez czujnik zgodnie z zegarem czujnika.

Timestamp

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

DeliveryVehicleLocationSensor

Dostawca danych o lokalizacji (np. GPS).

BoolValue

Określa, czy location jest dopasowane do drogi.

BoolValue

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

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 wartość 0. Jeśli czas jest nieznany (np. po ponownym uruchomieniu aplikacji), wartość zostaje wyzerowana.

Int32Value

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

LatLng

Surowa lokalizacja pojazdu (nieprzetworzona przez road-snapper).

Timestamp

Sygnatura czasowa powiązana z nieprzetworzoną lokalizacją.

DeliveryVehicleLocationSensor

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

DoubleValue

Dokładność raw_location jako promień w metrach.

LatLng

Dodatkowa lokalizacja dostarczona przez aplikację integrującą.

Timestamp

Sygnatura czasowa powiązana z dodatkową lokalizacją.

DeliveryVehicleLocationSensor

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

DoubleValue

Dokładność supplemental_location jako promień w metrach.

bool

Wycofane: użyj w zastępstwie zasady is_road_snapped.

DeliveryRequestHeader

Opcjonalnie: standardowy nagłówek żądania interfejsu Delivery API;

string

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

DeliveryRequestHeader

Opcjonalnie: standardowy nagłówek żądania interfejsu Delivery API;

string

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

DeliveryRequestHeader

Opcjonalnie: standardowy nagłówek żądania interfejsu Delivery API;

string

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

DeliveryRequestHeader

Opcjonalnie: standardowy nagłówek żądania interfejsu Delivery API;

string

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

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 sam ją ustali.

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji ListDeliveryVehicles. Musisz podać ten token, 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.

string

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

Pamiętaj, że jedyne zapytania obsługiwane w przypadku atrybutu ListDeliveryVehicles to te dotyczące atrybutów pojazdu (na przykład attributes.<key> = <value> lub attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Ponadto wszystkie atrybuty są przechowywane jako ciągi znaków, więc jedyne obsługiwane porównania atrybutów to porównania ciągów znaków. Aby można było porównywać je z wartościami liczbowymi lub logicznymi, muszą być one wyraźnie umieszczone w cudzysłowie (np. attributes.<key> = "10" lub attributes.<key> = "true").

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

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.

DeliveryVehicle

Zestaw środków dostawy, które spełniają określone kryteria filtrowania. Jeśli nie zostanie określony żaden filtr, żądanie zwróci wszystkie środki dostawy. Odpowiedź informująca o pomyślnym zakończeniu może też być pusta. Pusty tekst oznacza, że nie znaleziono żadnych pojazdów dostawczych spełniających żądane kryteria filtra.

string

Aby wyświetlić listę wyników, możesz przekazać ten token w polu ListDeliveryVehiclesRequest. Gdy zwracane są wszystkie wyniki, to pole nie występuje w odpowiedzi lub jest puste.

int64

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

DeliveryRequestHeader

Opcjonalnie: standardowy nagłówek żądania interfejsu Delivery API;

string

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

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ę zwracanych wyników.

string

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

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

string

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

Task

Zbiór zadań, które spełniają określone kryteria filtrowania. Jeśli nie podasz żadnego filtra, żądanie zwróci wszystkie zadania. Odpowiedź informująca o pomyślnym zakończeniu może też być pusta. Pusta odpowiedź oznacza, że nie znaleziono Listy zadań spełniającej żądane kryteria filtrowania.

string

Przekaż ten token w parametrze ListTasksRequest, aby wyświetlić wyniki. Jeśli zwrócono wszystkie wyniki, to pole jest pustym ciągiem znaków lub nie pojawia się w odpowiedzi.

int64

Łączna liczba zadań, które spełniają kryteria żądania, na wszystkich stronach.

LatLng

współrzędne lokalizacji;

string

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

Type

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

State

Wymagane. Bieżący stan wykonywania zadania.

TaskOutcome

Wynik zadania.

Timestamp

Sygnatura czasowa wskazująca, kiedy wynik Task został ustawiony przez dostawcę.

LocationInfo

Lokalizacja, w której ustawiono wynik 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).

TaskOutcomeLocationSource

Wskazuje, skąd pochodzi wartość task_outcome_location.

string

Stały. To pole ułatwia przechowywanie identyfikatora, dzięki czemu można uniknąć korzystania ze skomplikowanego mapowania. Nie możesz ustawić wartości tracking_id dla zadań typu UNAVAILABLE i SCHEDULED_STOP. Te identyfikatory podlegają tym ograniczeniom:

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

string

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

• Musi to być prawidłowy ciąg znaków Unicode.
• Może mieć maksymalnie 64 znaki.
• znormalizowany zgodnie z formą normalizacji C standardu Unicode.
• Nie może zawierać tych znaków ASCII: '/', ':', '?', ',' ani '#'.

LocationInfo

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

Duration

Wymagane. Niezmienna. Czas potrzebny do wykonania zadania w danej lokalizacji.

TimeWindow

Okno czasowe, w którym należy wykonać zadanie.

JourneySharingInfo

Tylko dane wyjściowe. Pola dotyczące udostępniania podróży. Niewypełniane, gdy stan ma wartość CLOSED.

TaskTrackingViewConfig

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

TaskAttribute

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

VehicleJourneySegment

informacje śledzące przystanki, które wykona przypisany pojazd, zanim zakończy to zadanie; 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. Zawierają informacje o trasie między pozostałymi VehicleStops.

DeliveryVehicleLocation

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

bool

Wskazuje, czy ostatnia znana lokalizacja pojazdu może być dopasowana 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.

string

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

string

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

bool

Wartość atrybutu typu logicznego.

double

Wartość atrybutu została wpisana dwukrotnie.

string

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

string

Niezmienna. Identyfikator śledzenia zadania. * Musi być prawidłowym ciągiem znaków Unicode. * Maksymalna długość to 64 znaki. * Znormalizowane zgodnie z formularzem normalizacji Unicode C. * Nie może zawierać tych znaków ASCII: '/', ':', '?', ',' ani '#'.

DeliveryVehicleLocation

Ostatnia lokalizacja pojazdu.

LatLng

Lista punktów, które po połączeniu tworzą linię wielokąta oczekiwanej trasy pojazdu do lokalizacji tego zadania.

Int32Value

Wskazuje liczbę przystanków, które pojazd ma jeszcze do wykonania, zanim dotrze do przystanku zadania, w tym przystanek zadania. Jeśli na przykład następny przystanek pojazdu to przystanek związany z wykonywaniem zadania, wartość będzie wynosić 1.

Int32Value

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

Timestamp

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

Timestamp

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

State

Bieżący stan wykonania zadania.

TaskOutcome

Wynik próby wykonania zadania.

Timestamp

Sygnatura czasowa wskazująca, kiedy wynik zadania został ustawiony przez dostawcę.

LocationInfo

Niezmienna. Lokalizacja, w której zadanie zostanie wykonane.

TimeWindow

Okno czasowe, w którym należy wykonać zadanie.

TaskAttribute

Atrybuty niestandardowe ustawione w zadaniu.

VisibilityOption

Pole określające, kiedy punkty ścieżki polilinii mogą być widoczne. Jeśli to pole nie zostanie określone, zostanie użyta domyślna konfiguracja widoczności tych danych na poziomie projektu.

VisibilityOption

Pole określające, kiedy szacowany czas przyjazdu może być widoczny. Jeśli to pole nie zostanie określone, zostanie użyta domyślna konfiguracja widoczności tych danych na poziomie projektu.

VisibilityOption

Pole określające, kiedy może być widoczny szacowany czas ukończenia zadania. Jeśli to pole nie zostanie określone, zostanie użyta domyślna konfiguracja widoczności tych danych na poziomie projektu.

VisibilityOption

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

VisibilityOption

Pole określające, kiedy widoczny może być pozostały przystanek. Jeśli to pole nie zostanie określone, zostanie użyta domyślna konfiguracja widoczności tych danych na poziomie projektu.

VisibilityOption

Pole, które określa, kiedy lokalizacja pojazdu może być widoczna. Jeśli to pole nie zostanie określone, zostanie użyta domyślna konfiguracja widoczności tych danych na poziomie projektu.

int32

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

Duration

Ten element danych jest widoczny dla użytkowników, jeśli szacowany czas przybycia na przystanek <= wartość_progi_czasu_do_planowanego_przybycia.

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.

bool

Jeśli ma wartość Prawda, ten element danych jest zawsze widoczny dla użytkowników bez żadnych progów. To pole nie może być ustawione na „false”.

bool

Jeśli ma wartość prawda, ten element danych jest zawsze ukryty przed użytkownikami i nie ma dla niego żadnych progów. To pole nie może być ustawione na „false”.

Timestamp

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

Timestamp

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

DeliveryRequestHeader

Opcjonalnie: standardowy nagłówek żądania interfejsu Delivery API;

DeliveryVehicle

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

FieldMask

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

Jest to lista pełnych nazw pól rozdzielona przecinkami. Przykład: "remaining_vehicle_journey_segments".

DeliveryRequestHeader

Opcjonalnie: standardowy nagłówek żądania interfejsu Delivery API;

Task

Wymagane. Zadanie powiązane z aktualizacją. Te pola są obsługiwane przez silnik floty. Nie aktualizuj ich za pomocą funkcji 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 zmieniaj jego stanu na ZAMKNIĘTE za pomocą opcji Task.update. Zamiast tego usuń VehicleStop zawierający zadanie z pojazdu dostawczego, co spowoduje automatyczne ustawienie stanu zadania na „Zamknięte”.

FieldMask

Wymagane. Maska pól określająca, które pola zadania mają zostać zaktualizowane. Uwaga: pole update_mask musi zawierać co najmniej 1 pole.

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

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.

Int32Value

Tylko dane wyjściowe. Odległość przebyta od poprzedniego przystanku do tego przystanku. Jeśli bieżący przystanek jest pierwszym 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 nie być widoczne, jeśli ten segment podróży jest częścią JourneySharingInfo.

Duration

Tylko dane wyjściowe. Czas podróży z poprzedniego przystanku do tego przystanku. Jeśli bieżący przystanek jest pierwszym 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 na ś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.

LatLng

Tylko dane wyjściowe. Ścieżka z poprzedniego przystanku do tego przystanku. Jeśli bieżący przystanek jest pierwszym na liście odcinków podróży, to jest to droga 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 podróży jest częścią JourneySharingInfo.

Jeśli to pole jest zdefiniowane na ś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). Dzięki temu ścieżka przejazdu będzie prowadzić z ostatniej znanej lokalizacji aplikacji kierowcy, a nie z poprzedniego przystanku.

LocationInfo

Wymagane. Lokalizacja przystanku. Pamiętaj, że lokalizacje w plikach Task mogą nie odpowiadać dokładnie tej lokalizacji, ale będą znajdować się w jej pobliżu. To pole nie będzie wypełniane w odpowiedzi na wywołanie GetTask.

TaskInfo

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

State

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

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.
• Maksymalna długość to 64 znaki.
• Znormalizowane zgodnie z formularzem normalizacji Unicode C.
• Nie może zawierać tych znaków ASCII: '/', ':', '?', ',' ani '#'.

Duration

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

TimeWindow

Tylko dane wyjściowe. Okno czasowe, w którym należy wykonać zadanie. Jest on ustawiany tylko w odpowiedzi na GetDeliveryVehicle.