REST Resource: projects.trips

Risorsa: Trip

Un viaggio.

Rappresentazione JSON 
{
  "name": string,
  "config": {
    object (TripConfig)
  },
  "androidAppId": string,
  "iosAppId": string,
  "authToken": {
    object (AuthToken)
  },
  "state": enum (State),
  "execution": {
    object (TripExecution)
  },
  "createTime": string,
  "updateTime": string
}
Campi
name

string

Solo output. Identificatore. Il nome della risorsa del viaggio. Formato: projects/{project_number}/trips/{tripId}.
config

object (TripConfig)

Immutabile. La configurazione del viaggio.
androidAppId

string

Solo input. Immutabile. L'ID applicazione dell'app per Android che utilizzerà il viaggio. È necessario impostare almeno uno dei valori androidAppId o iosAppId.
iosAppId

string

Solo input. Immutabile. L'ID pacchetto iOS dell'applicazione mobile che utilizzerà il viaggio. È necessario impostare almeno uno dei valori androidAppId o iosAppId.
authToken

object (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 trips.create.
state

enum (State)

Solo output. Lo stato del viaggio.
execution

object (TripExecution)

Solo output. Gli ultimi dati sull'esecuzione del viaggio. Questo valore potrebbe non essere impostato se il viaggio è in stato di errore.
createTime

string (Timestamp format)

Solo output. Ora in base al server in cui è stato creato il viaggio.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Ora in cui il server ha ricevuto l'ultimo aggiornamento del viaggio.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

TripConfig

Configurazione del viaggio.

Rappresentazione JSON 
{
  "enableHighFrequencyUpdates": boolean,
  "enablePubsub": boolean,
  "pubsubFieldMask": string
}
Campi
enableHighFrequencyUpdates

boolean

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

boolean

Facoltativo. Indica se attivare le notifiche Pub/Sub per il viaggio.
pubsubFieldMask

string (FieldMask format)

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:

  • androidAppId
  • iosAppId
  • authToken
  • config

NOTA: questo campo viene ignorato se enablePubsub è false.

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

AuthToken

Un token di autenticazione.

Rappresentazione JSON 
{
  "token": string,
  "expireTime": string
}
Campi
token

string

Solo output. Il token di autenticazione da passare all'applicazione mobile.
expireTime

string (Timestamp format)

Solo output. Ora in cui il token di autenticazione scadrà.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

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.

TripExecution

Dati sull'esecuzione del viaggio.

Rappresentazione JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "traveledDuration": string,
  "remainingDuration": string,
  "traveledDistanceMeters": integer,
  "remainingDistanceMeters": integer,
  "stopAddedInRoute": boolean
}
Campi
origin

object (Location)

Solo output. Origine del viaggio, che in genere è la posizione del trasportatore all'inizio del viaggio NavConnect.
destination

object (Stop)

Solo output. La destinazione del viaggio segnalata dall'applicazione mobile.
location

object (Location)

Solo output. Il segnale di localizzazione che rappresenta l'ultima posizione nota del trasportatore. Se disponibile, questa sarà la posizione agganciata alla strada.
traveledDuration

string (Duration format)

Solo output. Tempo di viaggio finora.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
remainingDuration

string (Duration format)

Solo output. Tempo rimanente del viaggio stimato da Google.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
traveledDistanceMeters

integer

Solo output. Distanza percorsa dall'origine in metri.
remainingDistanceMeters

integer

Solo output. Distanza rimanente dalla destinazione in metri.
stopAddedInRoute

boolean

Solo output. Indica se è stata aggiunta una fermata lungo il percorso.

Località

Una posizione segnalata dall'applicazione mobile.

Rappresentazione JSON 
{
  "point": {
    object (LatLng)
  },
  "sourceTime": string,
  "serverTime": string
}
Campi
point

object (LatLng)

Solo output. Latitudine/longitudine della località.
sourceTime

string (Timestamp format)

Solo output. L'ora in cui è stata recuperata la posizione, come indicato dal cliente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
serverTime

string (Timestamp format)

Solo output. L'ora in cui il server ha ricevuto questo aggiornamento della posizione.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

LatLng

Un oggetto che rappresenta una coppia latitudine/longitudine. Questi valori sono espressi come una coppia di numeri double per rappresentare i gradi di latitudine e longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono rientrare negli intervalli normalizzati.

Rappresentazione JSON 
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

La latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0].
longitude

number

La longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0].

Interrompi

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

Rappresentazione JSON 
{
  "point": {
    object (LatLng)
  }
}
Campi
point

object (LatLng)

Obbligatorio. La posizione della fermata come latitudine/longitudine.

Metodi

create

 Crea un viaggio.

get

 Riceve un viaggio.