Estos endpoints permiten conocer los conductores disponibles cerca de una ubicación y la posición del conductor asignado a una expedición.
Ambos son peticiones GET con las cabeceras habituales:
secret-api-key: TU_API_KEY Authorization-Domain: TU_DOMINIO
Conductores libres
Devuelve la lista de conductores disponibles cerca de una ubicación, ordenados por cercanía, con la distancia y el tiempo estimado hasta ese punto.
GET https://api.app.vonzu.es/api/v2/drivers/?location={lat,lng}&active=true
Parámetros de consulta (query)
Parámetro | Tipo | Obligatorio | Descripción |
| string | Sí | Coordenadas de referencia en formato |
| boolean | No | Si es |
Ejemplo de petición
curl --location 'https://api.app.vonzu.es/api/v2/drivers/?location=2.031615,41.492498&active=true' \ --header 'secret-api-key: TU_API_KEY' \ --header 'Authorization-Domain: TU_DOMINIO'
Ejemplo de respuesta
[
{
"driver": "Alcolea"
},
{
"driver": "PabloDriver",
"distance": 26848,
"duration": 1597
}
]
Campo | Descripción |
| Nombre de usuario del conductor. |
| Distancia estimada hasta la ubicación, en metros. |
| Tiempo estimado de llegada, en segundos. |
Ubicación de un conductor
Devuelve la última ubicación conocida del conductor asignado a una expedición concreta.
GET https://api.app.vonzu.es/api/v2/drivers/location?expeditionId={id}
Parámetros de consulta (query)
Parámetro | Tipo | Obligatorio | Descripción |
| number | Sí | Identificador de la expedición cuyo conductor querés localizar. |
Ejemplo de petición
curl --location 'https://api.app.vonzu.es/api/v2/drivers/location?expeditionId=381' \ --header 'secret-api-key: TU_API_KEY' \ --header 'Authorization-Domain: TU_DOMINIO'
Ejemplo de respuesta
{
"username": "mireiadriver",
"location": [-122.0840252, 37.4220019],
"time": "2022-12-05T17:28:54+01:00"
}
Campo | Descripción |
| Nombre de usuario del conductor. |
| Coordenadas en formato GeoJSON |
| Marca de tiempo de la última posición registrada (ISO 8601). |