REST Resource: providers.deliveryVehicles
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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
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
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 |
|
Tworzy i zwraca nowy obiekt DeliveryVehicle . |
|
Usuwa DeliveryVehicle z Fleet Engine. |
|
Zwraca określoną instancję DeliveryVehicle . |
|
Pobiera wszystkie DeliveryVehicle , które spełniają określone kryteria filtrowania. |
|
Zapisuje zaktualizowane dane DeliveryVehicle w Fleet Engine i przypisuje Tasks do DeliveryVehicle . |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-02-26 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-02-26 UTC."],[[["`DeliveryVehicle` resources represent vehicles transporting shipments between depots, delivery, and pickup locations, with attributes like location, navigation status, and route information."],["The `DeliveryVehicle` message supports various fields such as name, last location, navigation status, route details, remaining distance and duration, journey segments, attributes, and vehicle type."],["`DeliveryVehicleNavigationStatus` indicates the vehicle's navigation state, including options like `NO_GUIDANCE`, `ENROUTE_TO_DESTINATION`, `OFF_ROUTE`, and `ARRIVED_AT_DESTINATION`."],["`DeliveryVehicleAttribute` allows for custom key-value pairs describing the vehicle, supporting string, boolean, and number values for attributes."],["You can manage `DeliveryVehicle` resources through methods like `create`, `get`, `list`, and `patch` to interact with and update their data within Fleet Engine."]]],["DeliveryVehicles transport shipments between locations. Key data includes: vehicle `name`, `lastLocation`, `navigationStatus` (e.g., `ENROUTE_TO_DESTINATION`), `currentRouteSegment`, and `remainingDistanceMeters`. Attributes are customizable key-value pairs. `DeliveryVehicleType` specifies the vehicle (e.g., `AUTO`, `BICYCLE`). `DeliveryVehicle` data can be created, retrieved, listed, and updated through Fleet Engine. `DeliveryVehicleNavigationStatus` provides information about the navigation status of the vehicle.\n"]]