- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Ventana gráfica
Muestra una lista paginada de vehículos asociados con un proveedor que coinciden con las opciones de solicitud.
Solicitud HTTP
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
parent |
Obligatorio. Debe tener el formato |
Parámetros de consulta
Parámetros | |
---|---|
header |
El encabezado de solicitud estándar de Fleet Engine. |
pageSize |
Es la cantidad máxima de vehículos que se mostrarán. Valor predeterminado: 100. |
pageToken |
El valor de |
minimumCapacity |
Especifica la capacidad mínima requerida del vehículo. Todos los vehículos que se muestran tendrán un |
tripTypes[] |
Restringe la respuesta a los vehículos que admiten, al menos, uno de los tipos de viajes especificados. |
maximumStaleness |
Restringe la respuesta a los vehículos que enviaron actualizaciones de ubicación a Fleet Engine dentro de la duración especificada. Los vehículos estáticos que aún transmiten sus ubicaciones no se consideran inactivos. Si está presente, debe ser una duración positiva válida. Es una duración en segundos con hasta nueve dígitos decimales que termina en " |
vehicleTypeCategories[] |
Obligatorio. Restringe la respuesta a los vehículos con una de las categorías de tipo especificadas. No se permite |
requiredAttributes[] |
Los emisores pueden formar operaciones lógicas complejas con cualquier combinación de los campos
Restringe la respuesta a los vehículos con los atributos especificados. Este campo es una operación de conjunción/Y. Se permite un máximo de 50 requiredAttributes. Coincide con la cantidad máxima de atributos permitidos en un vehículo. Cada cadena repetida debe tener el formato "clave:valor". |
requiredOneOfAttributes[] |
Restringe la respuesta a los vehículos con al menos uno de los atributos especificados en cada |
requiredOneOfAttributeSets[] |
Al igual que
Restringe la respuesta a los vehículos que coinciden con todos los atributos de un |
vehicleState |
Restringe la respuesta a los vehículos que tienen ese estado. |
onTripOnly |
Devuelve solo los vehículos con los viajes actuales. |
filter |
Opcional. Una consulta de filtro que se aplicará cuando se muestre una lista de vehículos. Consulta http://aip.dev/160 para ver ejemplos de la sintaxis del filtro. Este campo está diseñado para reemplazar los campos Este filtro funciona como una cláusula AND con otras restricciones, como Ten en cuenta que las únicas búsquedas admitidas son sobre atributos de vehículos (por ejemplo, Además, todos los atributos se almacenan como cadenas, de manera que las únicas comparaciones admitidas con los atributos son las comparaciones de cadenas. Para compararlos con valores numéricos o booleanos, los valores deben estar entre comillas explícitamente para tratarse como strings (por ejemplo, |
viewport |
Opcional. Es un filtro que limita los vehículos que se muestran a aquellos cuya última ubicación conocida se encontraba en el área rectangular definida por el viewport. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
vehicles.list
mensaje de respuesta.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"vehicles": [
{
object ( |
Campos | |
---|---|
vehicles[] |
Vehículos que coinciden con los criterios de la solicitud. La cantidad máxima de vehículos que se muestran se determina mediante el campo |
nextPageToken |
Es el token para recuperar la página siguiente de vehículos o vaciarla si no hay más vehículos que cumplan con los criterios de la solicitud. |
totalSize |
Obligatorio. Cantidad total de vehículos que coinciden con los criterios de la solicitud en todas las páginas. |
Viewport
Un viewport de latitud y longitud, representado por dos puntos low
y high
opuestos en diagonal. Una viewport se considera una región cerrada, es decir, incluye su límite. Los límites de latitud deben variar entre -90 y 90 grados inclusive, y los límites de longitud deben estar entre -180 y 180 grados inclusive. Se incluyen varios casos:
Si
low
=high
, el viewport consta de ese único punto.Si
low.longitude
>high.longitude
, el intervalo de longitud se invierte (el viewport cruza la línea de longitud de 180 grados).Si
low.longitude
= -180 grados yhigh.longitude
= 180 grados, el viewport incluye todas las longitudes.Si
low.longitude
= 180 grados yhigh.longitude
= -180 grados, el rango de longitud está vacío.Si
low.latitude
>high.latitude
, el rango de latitud está vacío.
Tanto low
como high
deben completarse, y el cuadro representado no puede estar vacío (como se especifica en las definiciones anteriores). Un viewport vacío generará un error.
Por ejemplo, este viewport abarca por completo la ciudad de Nueva York:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Representación JSON |
---|
{ "low": { object ( |
Campos | |
---|---|
low |
Obligatorio. Es el punto inferior del viewport. |
high |
Obligatorio. Es el punto más alto del viewport. |