SaveGas · lector de precios
SaveGas es una app para iPhone que muestra los precios oficiales de los carburantes en España y ayuda a elegir dónde repostar en un viaje. Esta página explica a los responsables de los servicios del Ministerio cómo lee nuestro lector los datos públicos.
Nuestras peticiones se identifican como GasFinder-poller: GasFinder es el nombre interno del proyecto SaveGas.
Qué datos lee
- El servicio REST de precios de carburantes en estaciones terrestres del Ministerio para la Transición Ecológica y el Reto Demográfico (
ServiciosRESTCarburantes/PreciosCarburantes/EstacionesTerrestres/, enenergia.serviciosmin.gob.es). - El listado CSV de estaciones de servicio del Geoportal de Gasolineras (
downloadCSVEstacionesDeServicio), para la hora de cada precio y el tipo de venta. - Cuando la recuperación del histórico está activada: como máximo un día del archivo diario (
EstacionesTerrestresHist/{dd-mm-yyyy}) en cada lectura programada, hasta completar los precios de los dos últimos años (730 días); después, solo el día nuevo, una vez al día.
No usamos ningún servicio interno o no documentado del Geoportal, ni sus logotipos.
Con qué frecuencia
- Dos veces por hora, en los minutos 1 y 31, justo después de que el Ministerio publique cada actualización: una petición a cada fuente, desde un único equipo. Las apps nunca llaman al Ministerio: descargan una copia compacta desde nuestro servidor.
- Solo ante un error de red, un tiempo de espera agotado, una respuesta vacía o un error del servidor (5xx), lo intenta hasta 3 veces en total, con esperas de 5 y 20 segundos. En el servicio REST prueba después la dirección antigua del mismo servicio (
sedeaplicaciones.minetur.gob.es), también hasta 3 veces: como máximo 6 peticiones REST por lectura, y solo ante esos errores. El listado CSV no tiene dirección alternativa: como máximo 3 peticiones. - Ante una respuesta 403 o 429 se detiene en el acto: no reintenta, no prueba otro servidor y nos avisa. La recuperación del histórico queda en pausa hasta que la revisamos a mano.
- El archivo diario se pide con una sola petición por lectura, sin reintentos y solo al servidor principal.
Cómo se identifica
Todas las peticiones llevan un User-Agent que enlaza a esta página o a su versión provisional en quantumfield.app, del mismo responsable:
GasFinder-poller/0.1 (+https://savegas.app/poller/)GasFinder-poller/0.1 (+https://quantumfield.app/gasfinder/poller/)
Cómo se usan los datos
Los precios se muestran sin alterarlos, y la app cita como fuente al Ministerio e indica la fecha de la última actualización en «Origen de los datos», a un toque desde el mapa («Datos: Ministerio») y desde el perfil, como piden las condiciones de reutilización. Si un conductor introduce su propio descuento, la app muestra siempre primero el precio oficial sin cambios y, a su lado, el precio con descuento como cálculo del propio conductor. El lector no recibe ni guarda ningún dato de los usuarios de la app.
Contacto
Si el lector causa algún problema o necesitan que cambie su comportamiento (frecuencia, horario o identificación), escríbannos a soporte@savegas.app y lo ajustaremos.