Buscar estaciones cercanas por ubicación
GET/stations/near
Endpoint que devuelve estaciones de servicio dentro de un radio determinado alrededor de unas coordenadas geográficas. Ideal para aplicaciones de navegación y sistemas de localización en tiempo real.
Ejemplo de uso:
- Aplicaciones de navegación para encontrar estaciones cercanas
- Sistemas de emergencia para localizar estaciones disponibles
- Integración con mapas para mostrar opciones de repostaje
Casos de uso:
- Mostrar estaciones en un radio de 5km alrededor del usuario
- Alertar cuando se está quedando sin combustible y buscar opciones cercanas
- Planificar paradas en viajes largos basadas en ubicación actual
Request
Responses
- 200
Listado de estaciones ordenadas por distancia (de más cercana a más lejana). Incluye información detallada de cada estación:
- Nombre y ubicación exacta (coordenadas)
- Distancia desde el punto de búsqueda
- Precios y servicios disponibles
Ejemplo de respuesta:
{
"stations": [
{
"id": "est789",
"name": "Estación Central",
"location": {"type": "Point", "coordinates": [-3.70379, 40.41678]},
"address": "Gran Vía 1, Madrid",
"province": "Madrid",
"prices": {"diesel": 1.40, "gasoline": 1.50},
"rating": 4.2,
"services": ["cajero", "restaurante"],
"distance": 0.5
}
]
}