REST Resource: providers.deliveryVehicles

Zasób: DeliveryVehicle

Wiadomość DeliveryVehicle. Pojazd dostawczy transportuje przesyłki z depotu do miejsca dostawy i z miejsca odbioru do depozytu. W niektórych przypadkach pojazdy dostawcze przewożą przesyłki bezpośrednio z miejsca odbioru do miejsca dostawy.

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

Zapis JSON 
{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "pastLocations": [
    {
      object (DeliveryVehicleLocation)
    }
  ],
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}
Pola
name

string

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

object (DeliveryVehicleLocation)

Ostatnia zgłoszona lokalizacja pojazdu dostawczego.
pastLocations[]

object (DeliveryVehicleLocation)

Tylko dane wejściowe. Miejsca, w których pojazd dostawczy był w przeszłości, które nie zostały jeszcze zgłoszone do mechanizmu Fleet Engine. Służy on w UpdateDeliveryVehicleRequest do rejestrowania lokalizacji, których nie udało się wcześniej wysłać na serwer. Zwykle dzieje się tak, gdy pojazd dostawczy nie ma połączenia z internetem.
navigationStatus

enum (DeliveryVehicleNavigationStatus)

Stan nawigacji pojazdu dostawczego.
currentRouteSegment

string (bytes format)

Zaszyfrowana linia łamana określająca trasę, którą nawigacja zaleca poprowadzenie użytkownika 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 currentRouteSegment 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 currentRouteSegment jest nieaktualna i wskazuje na poprzedni przystanek pojazdu.

W takich przypadkach mechanizm floty wypełnia to pole trasą od ostatniego punktu przesiadkowego do następnego punktu przesiadkowego, aby zapewnić użytkownikowi tego pola jak najlepsze informacje o bieżącej trasie pojazdu dostawczego.

Ciąg znaków zakodowany w formacie Base64.
currentRouteSegmentEndPoint

object (LatLng)

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

To pole jest ignorowane w wywołaniach deliveryVehicles.patch, jeśli pole currentRouteSegment jest puste.
remainingDistanceMeters

integer

Pozostała odległość do przejechania w przypadku currentRouteSegment. To pole jest zwykle dostępne w aplikacji Kierowca, ale w niektórych okolicznościach 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 currentRouteSegment jest puste.
remainingDuration

string (Duration format)

Pozostały czas jazdy w przypadku currentRouteSegment. To pole jest zwykle dostępne w aplikacji Kierowca, ale w niektórych okolicznościach 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 elementach UpdateDeliveryVehicleRequest, jeśli pole currentRouteSegment jest puste.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".
remainingVehicleJourneySegments[]

object (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 deliveryVehicles.list.
attributes[]

object (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.
type

enum (DeliveryVehicleType)

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

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 nawigacja zakręt po zakrętem, a nawigacja w aplikacji Kierowca przeszła w tryb GUIDED_NAV.
OFF_ROUTE Pojazd zjechał z zalecanej trasy.
ARRIVED_AT_DESTINATION Pojazd znajduje się w odległości około 50 m od miejsca docelowego.

DeliveryVehicleAttribute

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

Zapis JSON 
{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}
Pola
key

string

Klucz atrybutu.
value

string

Wartość atrybutu.
Pole unii delivery_vehicle_attribute_value. Wartość atrybutu może być typu string, bool lub double. delivery_vehicle_attribute_value może być tylko jednym z tych elementów:
stringValue

string

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

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

boolean

Wartość atrybutu typu logicznego.
numberValue

number

Wartość atrybutu typu podwójnego.

DeliveryVehicleType

Typ pojazdu dostawczego.

Wartości w polu enum
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Wartość nie jest używana.
AUTO Samochód.
TWO_WHEELER motocykl, skuter lub inny pojazd dwukołowy;
BICYCLE Transport napędzany siłą ludzkich mięśni.
PEDESTRIAN Osoba poruszająca się pieszo lub biegnąca po chodniku.

Metody

create

 Tworzy i zwraca nowy obiekt DeliveryVehicle.

delete

 Usuwa DeliveryVehicle z Fleet Engine.

get

 Zwraca określoną instancję DeliveryVehicle.

list

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

patch

 Zapisuje zaktualizowane dane DeliveryVehicle w Fleet Engine i przypisuje Tasks do DeliveryVehicle.