REST Resource: providers.deliveryVehicles
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: DeliveryVehicle
Il messaggio DeliveryVehicle. Un veicolo di consegna trasporta le spedizioni da un deposito a un luogo di consegna e da un luogo di ritiro al deposito. In alcuni casi, i veicoli di consegna trasportano anche le spedizioni direttamente dal luogo di ritiro al luogo di consegna.
Nota: le API gRPC e REST utilizzano convenzioni di denominazione dei campi diverse. Ad esempio, il campo DeliveryVehicle.current_route_segment nell'API gRPC e il campo DeliveryVehicle.currentRouteSegment nell'API REST fanno riferimento allo stesso campo.
| Rappresentazione 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)
} |
| Campi |
name |
string
Il nome univoco di questo veicolo di consegna. Il formato è providers/{provider}/deliveryVehicles/{vehicle}.
|
lastLocation |
object (DeliveryVehicleLocation)
L'ultima posizione segnalata del veicolo di consegna.
|
pastLocations[] |
object (DeliveryVehicleLocation)
Solo input. Località in cui questo veicolo di consegna si è trovato in passato e che non sono ancora state segnalate a Fleet Engine. Viene utilizzato in UpdateDeliveryVehicleRequest per registrare le posizioni che in precedenza non era possibile inviare al server. In genere, questo accade quando il veicolo di consegna non dispone di connettività a internet.
|
navigationStatus |
enum (DeliveryVehicleNavigationStatus)
Lo stato di navigazione del veicolo di consegna.
|
currentRouteSegment |
string (bytes format)
La polilinea codificata che specifica il percorso consigliato dalla navigazione fino al waypoint successivo. L'app del conducente aggiorna questa informazione quando viene raggiunta o superata una fermata e quando la navigazione reindirizza. Questi LatLng vengono restituiti in Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) o Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) per tutte le attività attive assegnate al veicolo. In alcuni casi questo campo potrebbe non essere utilizzato per compilare Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) o Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):
L'endpoint di currentRouteSegment non corrisponde a DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) o DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST). L'app del conducente non ha aggiornato la sua posizione di recente, pertanto il valore dell'ultimo aggiornamento di questo campo potrebbe non essere aggiornato. L'app del conducente ha aggiornato di recente la sua posizione, ma currentRouteSegment è obsoleto e rimanda a una fermata del veicolo precedente. In questi casi, Fleet Engine compila questo campo con un percorso dal capolinea del veicolo più recente a quello successivo per garantire che il consumatore di questo campo disponga delle migliori informazioni disponibili sul percorso attuale del veicolo di consegna. Una stringa con codifica Base64.
|
currentRouteSegmentEndPoint |
object (LatLng)
La posizione in cui termina currentRouteSegment. Al momento questo campo non viene compilato dall'app per i conducenti, ma puoi fornirlo durante le chiamate deliveryVehicles.patch. Si tratta della LatLng della fermata successiva del veicolo o dell'ultima LatLng del currentRouteSegment. Fleet Engine farà del suo meglio per eseguire l'interpolazione in base a un valore VehicleStop effettivo. Questo campo viene ignorato nelle chiamate a deliveryVehicles.patch se il campo currentRouteSegment è vuoto.
|
remainingDistanceMeters |
integer
La distanza in auto rimanente per currentRouteSegment. In genere, questo campo è fornito dall'app Driver, ma in alcune circostanze Fleet Engine sostituisce il valore inviato dall'app. Per ulteriori informazioni, consulta DeliveryVehicle.current_route_segment. Questo campo viene restituito in Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) o Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) per tutti i Task attivi assegnati al veicolo di consegna. Fleet Engine ignora questo campo in UpdateDeliveryVehicleRequest se il campo currentRouteSegment è vuoto.
|
remainingDuration |
string (Duration format)
Il tempo di percorrenza rimanente per currentRouteSegment. In genere, questo campo è fornito dall'app Driver, ma in alcune circostanze Fleet Engine sostituisce il valore inviato dall'app. Per ulteriori informazioni, consulta DeliveryVehicle.current_route_segment. Questo campo viene restituito in Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) o Task.remainingVehicleJourneySegments[0].drivingDuration (REST) per tutte le attività attive assegnate al veicolo di consegna. Fleet Engine ignora questo campo in UpdateDeliveryVehicleRequest se il campo currentRouteSegment è vuoto. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
|
remainingVehicleJourneySegments[] |
object (VehicleJourneySegment)
I segmenti di viaggio assegnati a questo veicolo di consegna, a partire dalla posizione segnalata più di recente del veicolo. Questo campo non verrà compilato nella risposta di deliveryVehicles.list.
|
attributes[] |
object (DeliveryVehicleAttribute)
Un elenco di attributi personalizzati del veicolo di consegna. Un veicolo di consegna può avere al massimo 100 attributi e ogni attributo deve avere una chiave univoca.
|
type |
enum (DeliveryVehicleType)
Il tipo di veicolo di consegna. Se non viene impostato, il valore predefinito è AUTO.
|
DeliveryVehicleNavigationStatus
Lo stato di navigazione del veicolo.
| Enum |
UNKNOWN_NAVIGATION_STATUS |
Stato di navigazione non specificato. |
NO_GUIDANCE |
La navigazione dell'app Driver è in modalità FREE_NAV. |
ENROUTE_TO_DESTINATION |
La navigazione passo passo è disponibile e la navigazione dell'app Driver è passata alla modalità GUIDED_NAV. |
OFF_ROUTE |
Il veicolo è uscito dal percorso suggerito. |
ARRIVED_AT_DESTINATION |
Il veicolo si trova a circa 50 m dalla destinazione. |
DeliveryVehicleAttribute
Descrive un attributo del veicolo come coppia chiave-valore. La lunghezza della stringa "chiave:valore" non può superare i 256 caratteri.
| Rappresentazione 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.
} |
| Campi |
key |
string
La chiave dell'attributo.
|
value |
string
Il valore dell'attributo.
|
Campo unione delivery_vehicle_attribute_value. Il valore dell'attributo può essere di tipo stringa, booleano o doppio. delivery_vehicle_attribute_value può essere solo uno dei seguenti: |
stringValue |
string
Valore dell'attributo di tipo stringa. Nota: questo campo è identico al campo value, che verrà ritirato in futuro. Per i metodi di creazione o aggiornamento, puoi utilizzare uno dei due campi, ma ti consigliamo vivamente di utilizzare stringValue. Se sono impostati sia stringValue sia value, questi devono essere identici, altrimenti verrà generato un errore. Entrambi i campi vengono compilati nelle risposte.
|
boolValue |
boolean
Valore dell'attributo di tipo booleano.
|
numberValue |
number
Valore dell'attributo con tipo doppio.
|
DeliveryVehicleType
Il tipo di veicolo di consegna.
| Enum |
DELIVERY_VEHICLE_TYPE_UNSPECIFIED |
Il valore non è utilizzato. |
AUTO |
Un'automobile. |
TWO_WHEELER |
Una motocicletta, un motorino o un altro veicolo a due ruote |
BICYCLE |
Trasporto a propulsione umana. |
PEDESTRIAN |
Un mezzo di trasporto umano, in genere a piedi o in corsa, che si sposta lungo percorsi pedonali. |
Metodi |
|
|
Crea e restituisce un nuovo DeliveryVehicle. |
|
|
Consente di eliminare un DeliveryVehicle da Fleet Engine. |
|
|
Restituisce l'istanza DeliveryVehicle specificata. |
|
|
Recupera tutti i DeliveryVehicle che soddisfano i criteri di filtro specificati. |
|
|
Scrive i dati aggiornati di DeliveryVehicle in Fleet Engine e assegna Tasks a DeliveryVehicle. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-02-26 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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"]]
