- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Area visibile
Restituisce tutti i valori DeliveryVehicle
che soddisfano i criteri di filtro specificati.
Richiesta HTTP
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/deliveryVehicles
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
parent |
Obbligatorio. Deve essere nel formato |
Parametri di query
Parametri | |
---|---|
header |
(Facoltativo) L'intestazione della richiesta API Delivery standard. |
pageSize |
(Facoltativo) Il numero massimo di veicoli da restituire. Il servizio potrebbe restituire un numero inferiore a questo. Se non specifichi questo numero, il server determina il numero di risultati da restituire. |
pageToken |
(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata a Durante l'impaginazione, tutti gli altri parametri forniti a |
filter |
(Facoltativo) Una query di filtro da applicare quando vengono elencati i veicoli per la consegna. Vedi http://aip.dev/160 per esempi di sintassi dei filtri. Se non specifichi un valore o specifichi una stringa vuota per il filtro, verranno restituiti tutti i veicoli per la consegna. Tieni presente che le uniche query supportate per Il numero massimo di restrizioni consentite in una query di filtro è 50. Una restrizione fa parte della query nel formato |
viewport |
(Facoltativo) Un filtro che limita i veicoli restituiti a quelli la cui ultima posizione nota era nell'area rettangolare definita dall'area visibile. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Il messaggio di risposta di deliveryVehicles.list
.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"deliveryVehicles": [
{
object ( |
Campi | |
---|---|
deliveryVehicles[] |
L'insieme di veicoli per la consegna che soddisfano i criteri di filtro richiesti. Se non viene specificato alcun filtro, la richiesta restituisce tutti i veicoli per la consegna. Una risposta corretta può anche essere vuota. Una risposta vuota indica che non sono stati trovati veicoli per la consegna che soddisfano i criteri di filtro richiesti. |
nextPageToken |
Puoi passare questo token in |
totalSize |
Il numero totale di veicoli per la consegna che corrispondono ai criteri della richiesta, in tutte le pagine. |
Area visibile
Un'area visibile di latitudine e longitudine, rappresentata da due punti diagonalmente opposti a low
e high
. Un'area visibile è considerata un'area chiusa, ovvero include il proprio confine. I limiti di latitudine devono essere compresi tra -90 e 90 gradi inclusi, mentre quelli di longitudine devono essere compresi tra -180 e 180 gradi inclusi. I vari casi includono:
Se
low
=high
, l'area visibile è composta da quel singolo punto.Se
low.longitude
>high.longitude
, l'intervallo di longitudine è invertito (l'area visibile supera la linea di longitudine di 180 gradi).Se
low.longitude
= -180 gradi ehigh.longitude
= 180 gradi, l'area visibile include tutte le longitudini.Se
low.longitude
= 180 gradi ehigh.longitude
= -180 gradi, l'intervallo di longitudine è vuoto.Se
low.latitude
>high.latitude
, l'intervallo di latitudine è vuoto.
È necessario compilare entrambi i campi low
e high
e la casella rappresentata non può essere vuota (come specificato dalle definizioni precedenti). Un'area visibile vuota genererà un errore.
Ad esempio, questa area visibile racchiude completamente New York City:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Rappresentazione JSON |
---|
{ "low": { object ( |
Campi | |
---|---|
low |
Obbligatorio. Il punto inferiore dell'area visibile. |
high |
Obbligatorio. Il punto più alto dell'area visibile. |