precios_carburantes
Retrieve fuel prices at gas stations in a Spanish municipality. Input a municipality ID and fuel type to get stations sorted by price from cheapest to most expensive, with details including location and hours.
Instructions
Precios de un carburante en las gasolineras de un municipio.
Usa el ID de municipio que devuelve buscar_municipio. El resultado
viene ordenado de más barata a más cara. Las gasolineras que no venden
el producto pedido no aparecen en el resultado (se indica cuántas se
excluyeron). Los precios se actualizan en la API del MINETUR cada
~30 minutos; la respuesta incluye la fecha de esos precios.
Args:
municipio_id: ID de municipio MINETUR (lo da buscar_municipio).
producto: nombre del carburante en lenguaje natural. Admite alias
como "diesel", "glp", "gasolina 95", "gasolina 98", o el nombre
exacto de la API (p. ej. "Gasoleo A"). Por defecto gasolina 95 E5.
limite: número máximo de gasolineras a devolver, ordenadas por
precio ascendente. Por defecto 20 (algunos municipios grandes,
como Madrid capital, tienen más de 240 gasolineras).
Returns:
Un diccionario con estado: "ok", "sin_gasolineras",
"municipio_invalido", "error_conexion" (no se pudo contactar con la
API), "error_respuesta" (la API respondió algo que no es JSON),
"limite_invalido" (limite no es un entero >= 1), o
"producto_no_reconocido" si producto no se pudo resolver. En
estado "ok" incluye fecha, producto, total_excluidas, y
gasolineras (lista con rotulo, direccion, localidad, horario,
precios de todos los productos que vende esa estación como
diccionario producto→precio, y coordenadas). En los demás estados
incluye mensaje explicando qué pasó y qué hacer.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limite | No | ||
| producto | No | gasolina 95 e5 | |
| municipio_id | Yes |