REST Resource: providers.vehicles

{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}

string

Solo salida. El nombre único de este vehículo. El formato es providers/{provider}/vehicles/{vehicle}.

enum (VehicleState)

El estado del vehículo.

enum (TripType)

Tipos de viaje admitidos en este vehículo.

string

Solo salida. Lista de tripId para los viajes asignados actualmente a este vehículo.

object (VehicleLocation)

Última ubicación informada del vehículo.

integer

La cantidad total de pasajeros que puede transportar este vehículo. No se considera el controlador en este valor. Este valor debe ser mayor o igual que uno.

object (VehicleAttribute)

Lista de atributos del vehículo. Un vehículo puede tener como máximo 100 atributos, y cada uno de ellos debe tener una clave única.

object (VehicleType)

Obligatorio. El tipo de vehículo. Se puede usar para filtrar vehículos en los resultados de vehicles.search. También influye en los cálculos de la hora de llegada y la ruta.

object (LicensePlate)

Información de la matrícula del vehículo.

object (TerminalLocation)

Obsoleto: usa Vehicle.waypoints en su lugar.

string

La polilínea que especifica la ruta que la app de conductor intenta tomar hasta el siguiente punto de referencia Esta lista también se muestra en Trip.current_route_segment para todos los viajes activos asignados al vehículo.

Nota: Este campo está diseñado únicamente para que lo use el SDK del controlador. Aún no se admite la decodificación.

object (TrafficPolylineData)

Solo entrada. Fleet Engine usa esta información para mejorar los recorridos compartidos. Nota: Este campo está diseñado únicamente para que lo use el SDK del controlador.

string (Timestamp format)

Solo salida. Hora a la que se configuró el currentRouteSegment. El cliente puede almacenarla y pasarla en solicitudes vehicles.get futuras para evitar que se devuelvan rutas que no hayan cambiado.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

El punto de referencia donde termina currentRouteSegment. Los conductores pueden proporcionarlo en llamadas a vehicles.update como un punto de referencia de viaje completo, un punto de referencia LatLng o como el último LatLng de la currentRouteSegment. Fleet Engine luego hará todo lo posible para interpolar un punto de referencia real si no está especificado por completo. Este campo se ignora en las llamadas vehicles.update, a menos que también se especifique currentRouteSegment.

integer

La distancia en automóvil restante para el currentRouteSegment. Este valor también se muestra en Trip.remaining_distance_meters para todos los viajes activos asignados al vehículo. El valor no se especifica si el campo currentRouteSegment está vacío.

string (Timestamp format)

Es la hora de llegada estimada a la primera entrada del campo waypoints. El valor no se especifica si el campo waypoints está vacío o si el campo Vehicle.current_route_segment está vacío.

Cuando actualizas un vehículo, remainingTimeSeconds tiene prioridad sobre etaToFirstWaypoint en la misma solicitud.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

integer

Solo entrada. Tiempo de conducción restante: currentRouteSegment. El valor no se especifica si el campo waypoints o Vehicle.current_route_segment está vacío. Este valor debe coincidir con etaToFirstWaypoint y current_time si todos los grupos usan el mismo reloj.

Cuando actualizas un vehículo, remainingTimeSeconds tiene prioridad sobre etaToFirstWaypoint en la misma solicitud.

object (TripWaypoint)

Los puntos de referencia restantes asignados a este vehículo.

string (Timestamp format)

Solo salida. Última vez que se actualizó el campo waypoints. Los clientes deben almacenar en caché este valor y pasarlo en GetVehicleRequest para garantizar que el campo waypoints solo se muestre si se actualiza.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

boolean

Indica si el conductor acepta viajes consecutivos. Si es true, vehicles.search puede incluir el vehículo incluso si está asignado a un viaje. El valor predeterminado es false.

enum (NavigationStatus)

El estado de navegación del vehículo.

object (DeviceSettings)

Solo entrada. Información sobre la configuración del dispositivo móvil que utiliza el conductor.

{
  "key": string,
  "value": string,

  // Union field vehicle_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field vehicle_attribute_value.
}

string

La clave del atributo. Las claves no pueden contener el carácter de dos puntos (:).

string

Es el valor del atributo.

string

Valor del atributo de tipo de cadena.

Nota: Es idéntico al campo value, que eventualmente dejará de estar disponible. Para los métodos de creación o actualización, se puede usar cualquier campo, pero es muy recomendable usar stringValue. Si se configuran stringValue y value, deben ser idénticos; de lo contrario, se mostrará un error. Ambos campos se propagan en las respuestas.

boolean

Valor de atributo de tipo booleano.

number

Valor de atributo de doble tipo.

{
  "category": enum (Category)
}

enum (Category)

Categoría del tipo de vehículo

{
  "countryCode": string,
  "lastCharacter": string
}

string

Obligatorio. Es el código de país o región de CLDR. Por ejemplo, US para Estados Unidos o IN para India.

string

El último dígito de la matrícula o "-1" para indicar que la matrícula no contiene ningún valor numérico.

• “ABC 1234” -> “4”
• "AB 123 CD" -> “3”
• “ABCDEF” -> “-1”

{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}

object (VisualTrafficReportPolylineRendering)

Una renderización de polilíneas que indica qué tan rápido es el tráfico para todas las regiones a lo largo de un tramo de viaje de un cliente.

{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}

object (RoadStretch)

Opcional. Tramos de ruta que deben representarse a lo largo de la polilínea Se garantiza que los estiramientos no se superpongan y no abarquen necesariamente toda la ruta.

Ante la ausencia de un tramo de ruta para aplicar diseño, el cliente debe aplicar el valor predeterminado para la ruta.

{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}

enum (Style)

Obligatorio. Es el estilo que se aplicará.

integer

Obligatorio. El estilo debe aplicarse entre [offsetMeters, offsetMeters + lengthMeters).

integer

Obligatorio. Es la longitud de la ruta en la que se aplicará el diseño.

{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}

enum (LocationPowerSaveMode)

La manera en que se configuran las funciones de ubicación para que se comporten en el dispositivo cuando está activado el ahorro de batería.

boolean

Indica si el dispositivo está en modo de ahorro de energía.

boolean

Indica si el dispositivo se encuentra en estado interactivo.

object (BatteryInfo)

Información sobre el estado de la batería.

{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}

enum (BatteryStatus)

Estado de la batería, ya sea completa o cargándose, etcétera

enum (PowerSource)

Estado de la fuente de alimentación de la batería

number

Porcentaje actual de batería [0-100].