Package google.maps.navconnect.v1

Indice

• NavConnectService (interfaccia)
• AuthToken (messaggio)
• CreateTripRequest (messaggio)
• GetTripRequest (messaggio)
• Location (messaggio)
• Stop (messaggio)
• Trip (messaggio)
• Trip.State (enum)
• TripConfig (messaggio)
• TripExecution (messaggio)

NavConnectService

Servizio per i clienti NavConnect per creare e ottenere viaggi.

CreateTrip
rpc CreateTrip(CreateTripRequest) returns (Trip) Crea un viaggio. Questo deve essere chiamato prima che l'applicazione mobile possa iniziare il viaggio. Il viaggio restituito avrà il campo auth_token impostato. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform

GetTrip
rpc GetTrip(GetTripRequest) returns (Trip) Riceve un viaggio. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform

AuthToken

Un token di autenticazione.

Campi
token	string Solo output. Il token di autenticazione da passare all'applicazione mobile.
expire_time	Timestamp Solo output. Ora in cui il token di autenticazione scadrà.

CreateTripRequest

Messaggio di richiesta per NavConnectService.CreateTrip.

Campi
parent	string Obbligatorio. La risorsa padre in cui verrà creato questo viaggio. Formato: projects/{project_number}
trip_id	string Obbligatorio. L'ID da utilizzare per il viaggio, che diventerà il componente finale del nome della risorsa del viaggio. Questo valore deve essere un UUID RFC-4122 valido.
trip	Trip Obbligatorio. Il viaggio da creare.

GetTripRequest

Messaggio di richiesta per NavConnectService.GetTrip.

Campi
name	string Obbligatorio. Il nome della risorsa del viaggio da ottenere. Formato: projects/{project}/trips/{trip_id}

Località

Una posizione segnalata dall'applicazione mobile.

Campi
point	LatLng Solo output. Latitudine/longitudine della località.
source_time	Timestamp Solo output. L'ora in cui è stata recuperata la posizione, come indicato dal cliente.
server_time	Timestamp Solo output. L'ora in cui il server ha ricevuto questo aggiornamento della posizione.

Interrompi

Una fermata del viaggio in cui deve essere eseguita un'attività.

Campi
point	LatLng Obbligatorio. La posizione della fermata come latitudine/longitudine.

Corsa

Un viaggio.

Campi
name	string Solo output. Identificatore. Il nome della risorsa del viaggio. Formato: projects/{project_number}/trips/{trip_id}.
config	TripConfig Immutabile. La configurazione del viaggio.
android_app_id	string Solo input. Immutabile. L'ID applicazione dell'app per Android che utilizzerà il viaggio. È necessario impostare almeno uno dei valori android_app_id o ios_app_id.
ios_app_id	string Solo input. Immutabile. L'ID pacchetto iOS dell'applicazione mobile che utilizzerà il viaggio. È necessario impostare almeno uno dei valori android_app_id o ios_app_id.
auth_token	AuthToken Solo output. Un token opaco che autorizza l'accesso per iniziare un viaggio NavConnect in Google Maps o Waze e concede a queste applicazioni l'accesso per aggiornare il viaggio. Restituiti solo da CreateTrip.
state	State Solo output. Lo stato del viaggio.
execution	TripExecution Solo output. Gli ultimi dati sull'esecuzione del viaggio. Questo valore potrebbe non essere impostato se il viaggio è in stato di errore.
create_time	Timestamp Solo output. Ora in base al server in cui è stato creato il viaggio.
update_time	Timestamp Solo output. Ora in cui il server ha ricevuto l'ultimo aggiornamento del viaggio.

Stato

Tutti i possibili stati del viaggio.

Enum
STATE_UNSPECIFIED	Lo stato del viaggio non è specificato.
NEW	Il viaggio è stato creato, ma non è ancora iniziato.
ENROUTE	Il trasportatore è in viaggio verso la destinazione.
ARRIVED	Il trasportatore è arrivato a destinazione.
SUSPENDED	Il viaggio è stato sospeso.
FAILED	Il viaggio non è stato completato correttamente.
CLIENT_ERROR	Il viaggio non è andato a buon fine a causa di un errore del client.

TripConfig

Configurazione del viaggio.

Campi
enable_high_frequency_updates	bool Facoltativo. Se abilitare gli aggiornamenti ad alta frequenza del viaggio. NOTA: l'attivazione di questa funzionalità registra il viaggio nell'utilizzo del livello Enterprise ed è soggetta alle tariffe del livello Enterprise.
enable_pubsub	bool Facoltativo. Indica se attivare le notifiche Pub/Sub per il viaggio.
pubsub_field_mask	FieldMask Facoltativo. Se impostato, nelle notifiche pub/sub verrà incluso solo il sottoinsieme specificato dei campi del viaggio. Se non è impostato, tutti i campi del viaggio verranno inclusi nelle notifiche pub/sub (comportamento predefinito). I seguenti campi non sono supportati: android_app_id ios_app_id auth_token config NOTA: questo campo viene ignorato se enable_pubsub è false.

TripExecution

Dati sull'esecuzione del viaggio.

Campi
origin	Location Solo output. Origine del viaggio, che in genere è la posizione del trasportatore all'inizio del viaggio NavConnect.
destination	Stop Solo output. La destinazione del viaggio segnalata dall'applicazione mobile.
location	Location Solo output. Il segnale di localizzazione che rappresenta l'ultima posizione nota del trasportatore. Se disponibile, questa sarà la posizione agganciata alla strada.
traveled_duration	Duration Solo output. Tempo di viaggio finora.
remaining_duration	Duration Solo output. Tempo rimanente del viaggio stimato da Google.
traveled_distance_meters	int32 Solo output. Distanza percorsa dall'origine in metri.
remaining_distance_meters	int32 Solo output. Distanza rimanente dalla destinazione in metri.
stop_added_in_route	bool Solo output. Indica se è stata aggiunta una fermata lungo il percorso.