REST Resource: projects.trips

Recurso: Trip

Un viaje

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

string

Solo salida. Es el identificador. Es el nombre del recurso del viaje. Formato: projects/{project_number}/trips/{tripId}.
config

object (TripConfig)

Inmutable. Es la configuración del viaje.
androidAppId

string

Solo entrada. Inmutable. Es el ID de aplicación para Android de la aplicación para dispositivos móviles que usará el viaje. Se debe configurar al menos uno de los valores androidAppId o iosAppId.
iosAppId

string

Solo entrada. Inmutable. Es el ID del paquete de iOS de la aplicación para dispositivos móviles que usará el viaje. Se debe configurar al menos uno de los valores androidAppId o iosAppId.
authToken

object (AuthToken)

Solo salida. Es un token opaco que autoriza el acceso para comenzar un viaje de NavConnect en Google Maps o Waze, y otorga a estas aplicaciones acceso para actualizar el viaje. Solo lo devuelve trips.create.
state

enum (State)

Solo salida. Es el estado del viaje.
execution

object (TripExecution)

Solo salida. Son los datos más recientes sobre la ejecución del viaje. Es posible que no se establezca si el viaje está en estado de error.
createTime

string (Timestamp format)

Solo salida. Fecha y hora según el servidor en la que se creó el viaje.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Fecha y hora en que el servidor recibió la actualización de viaje más reciente.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

TripConfig

Es la configuración del viaje.

Representación JSON 
{
  "enableHighFrequencyUpdates": boolean,
  "enablePubsub": boolean,
  "pubsubFieldMask": string
}
Campos
enableHighFrequencyUpdates

boolean

Opcional. Indica si se deben habilitar las actualizaciones de viaje de alta frecuencia.

NOTA: Si habilitas esta función, el viaje se registrará como uso del nivel Enterprise y estará sujeto a las tarifas de ese nivel.
enablePubsub

boolean

Opcional. Indica si se deben habilitar las notificaciones de Pub/Sub para el viaje.
pubsubFieldMask

string (FieldMask format)

Opcional. Si se configura, solo se incluirá el subconjunto especificado de los campos de Trip en las notificaciones de Pub/Sub.

Si no se configura, todos los campos de Trip se incluirán en las notificaciones de Pub/Sub (comportamiento predeterminado).

Los siguientes campos no son compatibles:

  • androidAppId
  • iosAppId
  • authToken
  • config

NOTA: Este campo se ignora si enablePubsub es falso.

Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".

AuthToken

Es un token de autenticación.

Representación JSON 
{
  "token": string,
  "expireTime": string
}
Campos
token

string

Solo salida. Es el token de autenticación que se debe pasar a la aplicación para dispositivos móviles.
expireTime

string (Timestamp format)

Solo salida. Fecha y hora en la que vencerá el token de autenticación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Estado

Son todos los estados posibles del viaje.

Enums
STATE_UNSPECIFIED El estado del viaje no está especificado.
NEW Se creó el viaje, pero aún no comenzó.
ENROUTE El transporte está en camino al destino.
ARRIVED El transportista llegó al destino.
SUSPENDED Se suspendió el viaje.
FAILED El viaje no se completó correctamente.
CLIENT_ERROR El viaje falló debido a un error del cliente.

TripExecution

Son datos sobre la ejecución del viaje.

Representación JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "traveledDuration": string,
  "remainingDuration": string,
  "traveledDistanceMeters": integer,
  "remainingDistanceMeters": integer,
  "stopAddedInRoute": boolean
}
Campos
origin

object (Location)

Solo salida. Es el origen del viaje, que suele ser la ubicación del transportista al inicio del viaje de NavConnect.
destination

object (Stop)

Solo salida. Es el destino del viaje según lo informa la aplicación para dispositivos móviles.
location

object (Location)

Solo salida. Es el indicador de ubicación que representa la última ubicación conocida del transportista. Esta será la ubicación ajustada a la ruta si está disponible.
traveledDuration

string (Duration format)

Solo salida. Es el tiempo transcurrido hasta el momento.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
remainingDuration

string (Duration format)

Solo salida. Es el tiempo restante estimado para este viaje según Google.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
traveledDistanceMeters

integer

Solo salida. Es la distancia recorrida desde el origen en metros.
remainingDistanceMeters

integer

Solo salida. Distancia restante al destino en metros.
stopAddedInRoute

boolean

Solo salida. Indica si se agregó una parada a lo largo de la ruta.

Ubicación

Es una ubicación según la informa la aplicación para dispositivos móviles.

Representación JSON 
{
  "point": {
    object (LatLng)
  },
  "sourceTime": string,
  "serverTime": string
}
Campos
point

object (LatLng)

Solo salida. Latitud y longitud de la ubicación
sourceTime

string (Timestamp format)

Solo salida. Es la fecha y hora en la que el cliente indicó que se obtuvo la ubicación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
serverTime

string (Timestamp format)

Solo salida. Es la fecha y hora en la que el servidor recibió esta actualización de ubicación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

LatLng

Es un objeto que representa un par de valores de latitud y longitud. Esto se expresa como un par de números de punto flotante de doble precisión que representan los grados de latitud y longitud. A menos que se especifique lo contrario, este objeto debe cumplir con el estándar WGS84. Los valores deben pertenecer a rangos normalizados.

Representación JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0].
longitude

number

La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0].

Detener

Es una parada en el viaje en la que se debe realizar alguna tarea.

Representación JSON 
{
  "point": {
    object (LatLng)
  }
}
Campos
point

object (LatLng)

Obligatorio. Ubicación de la parada como latitud y longitud.

Métodos

create

 Crea un viaje.

get

 Obtiene un viaje.