Gasolinera más barata cerca

Para encontrar dónde repostar más barato cerca de un punto, usa GET /v1/stations/cheapest con lat, lng y radius_km: devuelve las gasolineras del radio ordenadas por precio. Si prefieres ordenarlas por distancia, usa GET /v1/stations/nearby con sort=distance.

Qué endpoint usar

Necesitas	Endpoint	Orden	Límite
Las más baratas a menos de X km	GET /v1/stations/cheapest?lat=…&lng=…&radius_km=…	precio	normal (120/min)
Las más cercanas (o por precio) con su distancia	GET /v1/stations/nearby?lat=…&lng=…&sort=distance	price o distance	consulta pesada (30/min)

Los dos aceptan fuel (por defecto gasoline_95), limit (1–50, por defecto 10), open_24h=true y brand=<slug>. El radio va de más de 0 a 50 km y, si no lo indicas, es de 5 km. Las gasolineras de nearby (y las de cheapest por coordenadas) traen distance_km.

Paso a paso

1. Consigue las coordenadas. Del navegador (navigator.geolocation), de tu propia base de datos o de la API: GET /v1/territories?level=municipality&parent=<provincia> devuelve lat y lng de cada municipio.

2. Pide las más baratas del radio.

   curl

   curl "https://api.preciosgasolina.es/v1/stations/cheapest?fuel=diesel&lat=40.4168&lng=-3.7038&radius_km=10&limit=5"

   JavaScript

   async function masBaratasCerca({ lat, lng, fuel = "gasoline_95", radiusKm = 5, limit = 5, open24h = false }) {
     const url = new URL("https://api.preciosgasolina.es/v1/stations/cheapest");
     url.search = new URLSearchParams({ fuel, lat, lng, radius_km: radiusKm, limit, ...(open24h && { open_24h: "true" }) });
     const res = await fetch(url);
     if (!res.ok) {
       const err = await res.json(); // application/problem+json
       throw new Error(`${err.code}: ${err.detail}`);
     }
     return res.json(); // { data, meta }
   }
   
   const { data, meta } = await masBaratasCerca({ lat: 40.4168, lng: -3.7038, fuel: "diesel", radiusKm: 10 });
   for (const s of data.stations) console.log(s.price, s.name, s.distance_km + " km", s.web_url);

   Python

   import requests
   
   def mas_baratas_cerca(lat, lng, fuel="gasoline_95", radius_km=5, limit=5, open_24h=False):
       params = {"fuel": fuel, "lat": lat, "lng": lng, "radius_km": radius_km, "limit": limit}
       if open_24h:
           params["open_24h"] = "true"
       r = requests.get("https://api.preciosgasolina.es/v1/stations/cheapest", params=params, timeout=10)
       if not r.ok:
           err = r.json()  # application/problem+json
           raise RuntimeError(f'{err["code"]}: {err["detail"]}')
       return r.json()
   
   body = mas_baratas_cerca(40.4168, -3.7038, fuel="diesel", radius_km=10)
   for s in body["data"]["stations"]:
       print(s["price"], s["name"], s.get("distance_km"), "km", s["web_url"])

3. Muestra el resultado con su fecha y la fuente. Cada gasolinera trae price, price_updated_at, is_24h, hours, su dirección y su web_url. Muestra meta.attribution y la fecha de meta.last_updated (ver Atribución).

Ejemplo ilustrativo: los valores no son precios reales

{
  "data": {
    "fuel": "diesel",
    "unit": "L",
    "currency": "EUR",
    "center": { "lat": 40.417, "lng": -3.704 },
    "radius_km": 10,
    "note": null,
    "stations": [
      {
        "id": 12345,
        "name": "Estación de ejemplo",
        "brand": { "slug": "marca-ejemplo", "name": "Marca Ejemplo" },
        "address": "Calle de Ejemplo, 1",
        "postal_code": "28001",
        "municipality": { "id": 4354, "name": "Madrid" },
        "province": { "code": "28", "name": "Madrid" },
        "community": { "code": "13", "name": "Comunidad de Madrid" },
        "lat": 40.39,
        "lng": -3.65,
        "is_24h": true,
        "hours": "L-D: 24H",
        "low_tax_area": false,
        "web_url": "https://preciosgasolina.es/gasolineras/estacion-de-ejemplo-12345/",
        "price": 1.459,
        "price_updated_at": "2026-10-07T06:12:00.000+00:00",
        "distance_km": 5.47
      }
    ]
  },
  "meta": { "last_updated": "2026-10-07T06:12:00.000Z", "attribution": "Fuente: Gasolina hoy (preciosgasolina.es), con datos del…", "web_url": "https://preciosgasolina.es/mapa-gasolineras/", "…": "…" }
}

Fíjate en que center sale redondeado a 3 decimales: la API redondea siempre las coordenadas (unos 100 m) para no identificar a nadie y compartir caché.

Ordenar por distancia

curl "https://api.preciosgasolina.es/v1/stations/nearby?lat=40.4168&lng=-3.7038&radius_km=3&fuel=gasoline_95&sort=distance&limit=10"

nearby cuenta como consulta pesada (30 por minuto por IP): úsalo cuando el usuario lo pida, no en cada movimiento del mapa.

Filtros útiles

• Abiertas 24 horas: open_24h=true.
• Una marca: brand=repsol (slug de la marca; lista en GET /v1/brands).
• Más resultados: limit=50 como máximo. Para listados completos de una zona, descarga los datos abiertos.

En una ciudad o provincia

Si en lugar de un punto tienes un municipio o una provincia, usa level + code: Las más baratas de una provincia.

Con el servidor MCP

Las herramientas equivalentes son find_cheapest_fuel (con lat, lng y radius_km) y find_fuel_near (con sort). Ejemplo de pregunta: «Gasolineras cerca de la estación de Atocha». Ver Herramientas del MCP.