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:

1. Mostrar estaciones en un radio de 5km alrededor del usuario
2. Alertar cuando se está quedando sin combustible y buscar opciones cercanas
3. 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
    }
  ]
}