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 transportują też 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)
  },
  "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.
navigationStatus

enum (DeliveryVehicleNavigationStatus)

Stan nawigacji pojazdu dostawy.
currentRouteSegment

string (bytes format)

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.

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

  • Punkt końcowy 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 przesiadnięcia do następnego punktu przesiadnięcia, aby zapewnić użytkownikowi tego pola najlepsze dostępne informacje o bieżącej trasie pojazdu dostawczego.

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

object (LatLng)

Lokalizacja, w której kończy się currentRouteSegment. Obecnie aplikacja kierowcy nie wypełnia tego pola, ale możesz podać je podczas połączenia deliveryVehicles.patch. To LatLng ze najbliższego przystanku pojazdu lub ostatni LatLng z currentRouteSegment. Fleet Engine podejmie wówczas wszelkie możliwe działania, aby dokonać interpolacji na 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 zasadzie Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) lub Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) w przypadku wszystkich aktywnych zasobów typu Task przypisanych do pojazdu dostawczego.

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

string (Duration format)

Pozostały czas jazdy samochodem currentRouteSegment. 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.

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

Czas trwania w sekundach składający się z maksymalnie dziewięciu cyfr po przecinku i kończący się „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 tego pojazdu dostawy. 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 wpisanego z użyciem wartości logicznej.
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.

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.