Package google.maps.navconnect.v1

Indice

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
Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa parent:

  • navigationconnect.trips.create

Per saperne di più, consulta la documentazione di IAM.
GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Riceve un viaggio.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Richiede la seguente autorizzazione IAM per la risorsa name:

  • navigationconnect.trips.get

Per saperne di più, consulta la documentazione di IAM.

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}
route_polyline_format

RoutePolylineFormat

Facoltativo. Il formato della polilinea dell'itinerario da restituire. Se non viene impostato, viene restituita la polilinea dell'itinerario SIMPLE.

RoutePolylineFormat

Specifica il formato della polilinea dell'itinerario.

Enum
ROUTE_POLYLINE_FORMAT_UNSPECIFIED Il formato della polilinea dell'itinerario non è specificato.
SIMPLE La polilinea dell'itinerario viene restituita come un semplice array di punti rappresentati come google.type.LatLng.
ENCODED La polilinea dell'itinerario viene restituita come stringa codificata. Consulta https://developers.google.com/maps/documentation/utilities/polylinealgorithm.
S2ENCODED La polilinea dell'itinerario è codificata come S2Polyline. Vedi https://s2geometry.io/devguide/basic_types.html.
GEO_JSON La polilinea dell'itinerario viene restituita come LineString GeoJSON. Vedi https://tools.ietf.org/html/rfc7946#section-3.1.4.

Località

Una posizione segnalata dall'applicazione mobile.

Campi
point

LatLng

Solo output. Latitudine/longitudine della posizione.
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.

Route

Una polilinea dell'itinerario.

Campi
traffic_information[]

SpeedReadingInterval

Solo output. Informazioni sul traffico sulla polilinea descritta come intervalli di lettura della velocità.

NOTE:

  • Gli intervalli non si sovrappongono.
  • Gli intervalli sono contigui.
  • Gli intervalli coprono l'intera polilinea.
  • Gli intervalli sono ordinati in base all'indice crescente.
  • La velocità è specificata per ogni intervallo.

Campo unione format. Il formato della route.

Il formato compilato è controllato dal parametro route_polyline_format. Se non viene impostato, il valore predefinito è una polilinea semplice. format può essere solo uno dei seguenti tipi:
simple_polyline

SimplePolyline

Solo output. Il percorso come semplice elenco di latlng.
encoded_polyline

string

Solo output. Il percorso come polilinea codificata. Consulta https://developers.google.com/maps/documentation/utilities/polylinealgorithm.
s2_polyline

bytes

Solo output. Il percorso come S2Polyline codificata. Vedi https://s2geometry.io/devguide/basic_types.html.
geo_json

Struct

Solo output. Il percorso come LineString GeoJSON. Vedi https://tools.ietf.org/html/rfc7946#section-3.1.4.

SimplePolyline

Rappresenta una polilinea utilizzando un semplice elenco di punti.

Campi
points[]

LatLng

Solo output. Elenco ordinato di punti che rappresentano la polilinea.

SpeedReadingInterval

Indicatore della densità del traffico su un segmento contiguo di un percorso. Dato un percorso con punti P_0, P_1, ... , P_N (indice basato su zero), SpeedReadingInterval definisce un intervallo e descrive il relativo traffico utilizzando le categorie Speed.

Campi
speed

Speed

Solo output. Velocità del traffico in questo intervallo.
start_polyline_point_index

int32

Solo output. L'indice iniziale di questo intervallo nel percorso.
end_polyline_point_index

int32

Solo output. L'indice finale di questo intervallo nel percorso.

Velocità

La classificazione della velocità della polilinea in base ai dati sul traffico.

Enum
SPEED_UNSPECIFIED La velocità non è specificata.
NORMAL Velocità normale, nessun ritardo dovuto al traffico.
SLOW Rallentamento rilevato, volume di traffico da basso a medio.
TRAFFIC_JAM Rallentamenti dovuti al traffico, inclusi i casi di coda.

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 tra android_app_id e 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 tra android_app_id e 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 della corsa.

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.
CANCELED Il viaggio è stato annullato esplicitamente dallo sviluppatore.

TripConfig

Configurazione del viaggio.

Campi
enable_high_frequency_updates

bool

Facoltativo. Se abilitare gli aggiornamenti del viaggio ad alta frequenza.

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.
enable_remaining_route_reporting

bool

Facoltativo. Indica se attivare i report sul percorso rimanente per il viaggio.

NOTA: l'attivazione di questa funzionalità registra il viaggio nell'utilizzo del livello Enterprise ed è soggetta alle tariffe del livello Enterprise.

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.
remaining_route

Route

Solo output. Fornisce la polilinea per la parte rimanente del percorso.
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.