REST Resource: providers.deliveryVehicles

{
  "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)
}

string

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

object (DeliveryVehicleLocation)

Ostatnia zgłoszona lokalizacja pojazdu dostawczego.

enum (DeliveryVehicleNavigationStatus)

Stan nawigacji pojazdu dostawy.

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.

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.

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.

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".

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.

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.

enum (DeliveryVehicleType)

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

{
  "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.
}

string

Klucz atrybutu.

string

Wartość atrybutu.

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.

boolean

Wartość atrybutu wpisanego z użyciem wartości logicznej.

number

Wartość atrybutu typu podwójnego.