Busca municipios españoles por nombre para obtener su ID.

El ID de municipio hace falta para llamar a precios_carburantes. La búsqueda es por tokens (no requiere escribir el nombre exacto ni en el orden exacto): "El Bonillo" encuentra "Bonillo (El)", "Kanpezu" encuentra el municipio bilingüe "Campezo/Kanpezu". Devuelve siempre la provincia porque hay nombres de municipio repetidos entre provincias (p. ej. tres municipios llamados "Boadilla").

Args: nombre: nombre o parte del nombre del municipio a buscar.

Returns: Lista de coincidencias, cada una con id, municipio y provincia. Lista vacía si no hay ninguna coincidencia.

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.