Package google.maps.roads.selection.v1

Indice

RoadsSelection

Definizione del servizio per l'API Roads Selection.

BatchCreateSelectedRoutes

rpc BatchCreateSelectedRoutes(BatchCreateSelectedRoutesRequest) returns (BatchCreateSelectedRoutesResponse)

Crea più SelectedRoutes e avvia una pianificazione per recuperare periodicamente le informazioni della cache per ciascun percorso.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
CreateSelectedRoute

rpc CreateSelectedRoute(CreateSelectedRouteRequest) returns (SelectedRoute)

Crea un oggetto SelectedRoute e avvia una pianificazione per recuperare periodicamente le informazioni della cache per l'itinerario.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
DeleteSelectedRoute

rpc DeleteSelectedRoute(DeleteSelectedRouteRequest) returns (Empty)

Elimina SelectedRoute specificato per il progetto specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
GetSelectedRoute

rpc GetSelectedRoute(GetSelectedRouteRequest) returns (SelectedRoute)

Recupera un oggetto SelectedRoute specificato dal nome.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
ListSelectedRoutes

rpc ListSelectedRoutes(ListSelectedRoutesRequest) returns (ListSelectedRoutesResponse)

Elenca tutte le SelectedRoutes per il progetto specificato con paginazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

BatchCreateSelectedRoutesRequest

Richiesta di creazione di più SelectedRoute.

Campi
parent

string

Facoltativo. La risorsa del progetto condivisa da tutte le route selezionate. Formato: projects/{project}. Se questo campo è impostato, il campo padre nei messaggi CreateSelectedRouteRequest deve essere vuoto o corrispondere a questo campo.
requests[]

CreateSelectedRouteRequest

Obbligatorio. Il messaggio di richiesta che specifica l'itinerario selezionato da creare. È possibile creare un massimo di 1000 itinerari selezionati in un batch.

BatchCreateSelectedRoutesResponse

Risposta alla creazione di più SelectedRoute.

Campi
selected_routes[]

SelectedRoute

SelectedRoutes creato.

CreateSelectedRouteRequest

Richiesta di creazione di un SelectedRoute.

Campi
parent

string

Obbligatorio. Il progetto in cui verrà creato il SelectedRoute. Formato: projects/{project}
selected_route

SelectedRoute

Obbligatorio. SelectedRoute da creare.
selected_route_id

string

Facoltativo. L'ID da utilizzare per SelectedRoute, che diventerà il componente finale del nome della risorsa di SelectedRoute.

Questo valore deve contenere da 4 a 63 caratteri e i caratteri validi sono: "a-z", "A-Z", "0-9" o "-". Se non viene fornito o è vuoto, verrà generato un UUID dopo la creazione della risorsa.

DeleteSelectedRouteRequest

Richiedi l'eliminazione di un SelectedRoute.

Campi
name

string

Obbligatorio. Il nome di SelectedRoute da eliminare. Formato: projects/{project}/selectedRoutes/{selected_route}

GetSelectedRouteRequest

Richiesta di ottenere un SelectedRoute.

Campi
name

string

Obbligatorio. Il nome di SelectedRoute da recuperare. Formato: projects/{project}/selectedRoutes/{selected_route}

ListSelectedRoutesRequest

Richiesta di elencare SelectedRoute s.

Campi
parent

string

Obbligatorio. Il progetto padre, da cui verranno eseguite query su tutti i SelectedRoute. Formato: projects/{project}/selectedRoutes
page_size

int32

Facoltativo. Il numero di risultati da restituire per una determinata pagina. Se non viene impostato, usa il valore predefinito 100. Se viene specificato un valore pari a 0, verrà impostato il valore predefinito. Il valore massimo è 5000, qualsiasi valore superiore a 5000 verrà impostato su 5000.
page_token

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata ListSelectedRoutes.

ListSelectedRoutesResponse

Risposta che elenca i SelectedRoute.

Campi
selected_routes[]

SelectedRoute

Una pagina di SelectedRoutes archiviata nel progetto specificato nella richiesta.
next_page_token

string

Token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo è vuoto, non verranno visualizzate altre pagine.

SelectedRoute

Un oggetto SelectedRoute rappresenta un percorso specifico per il quale un cliente vuole recuperare periodicamente informazioni (ad es. durata) per i casi d'uso contrattuali.

Campi
name

string

Identificatore. Nome risorsa di SelectedRoute.

Formato: projects/{project}/selectedRoutes/{selected_route}
display_name

string

Facoltativo. Nome visualizzato dell'itinerario. Questo è un campo facoltativo che può essere utilizzato dal cliente. Non deve essere univoco.
create_time

Timestamp

Solo output. Data e ora in cui è stato creato l'itinerario selezionato.
state

State

Solo output. Lo stato dell'itinerario selezionato.
route_attributes

map<string, string>

Facoltativo. Gli attributi personalizzati per l'itinerario selezionato. L'aggiunta consente di filtrare / raggruppare i percorsi durante il recupero delle informazioni storiche e in tempo reale. Sono supportati fino a 10 attributi per percorso. Ogni chiave e valore deve essere una stringa non vuota e può contenere fino a 100 caratteri. Le chiavi non devono iniziare con "goog".
Campo unione route_type. Al momento è supportato solo DynamicRoute. route_type può essere solo uno dei seguenti:
dynamic_route

DynamicRoute

SelectedRoute è una route dinamica.
validation_error

ValidationError

Solo output. L'errore di convalida per l'itinerario selezionato quando lo stato è STATE_INVALID.

DynamicRoute

Rappresenta un percorso con tappe intermedie (punto di partenza, destinazione e tappe intermedie). Il percorso effettivo passa sicuramente per tutte le tappe, ma potrebbe cambiare di tanto in tanto a causa delle diverse condizioni del traffico.

Campi
origin

LatLng

Obbligatorio. La posizione di partenza del percorso.
destination

LatLng

Obbligatorio. Posizione di arrivo del percorso.
intermediates[]

LatLng

Facoltativo. Un insieme di tappe intermedie lungo il percorso (esclusi i punti terminali). Sono sempre punti di passaggio. Sono supportate fino a 25 tappe intermedie. Se li aggiungi correttamente, puoi ridurre la variazione del percorso effettivo di volta in volta.

Stato

Lo stato dell'itinerario selezionato.

Enum
STATE_UNSPECIFIED Lo stato di questa route non è impostato.
STATE_SCHEDULING La route è stata creata ed è in fase di pianificazione.
STATE_RUNNING La route è stata creata e ha una pianificazione attiva.
STATE_DELETING L'itinerario è stato contrassegnato per l'eliminazione.
STATE_VALIDATING Il percorso è in fase di convalida.
STATE_INVALID La route non è valida in base a uno dei criteri di convalida.

ValidationError

L'errore di convalida per l'itinerario selezionato.

Enum
VALIDATION_ERROR_UNSPECIFIED L'errore di convalida di questa route non è impostato.
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION Il percorso non rientra nella giurisdizione del progetto.
VALIDATION_ERROR_LOW_ROAD_USAGE Il percorso ha un basso utilizzo della strada (pochissime persone lo percorrono).