Metodologia del geocercador de gasolineres
Com transformam preus oficials i distància en una estimació comparable, i on són els límits del càlcul.
Obre el geocercador, tria el combustible i calcula automàticament totes les estacions del radi.
Obrir geocercador1. Font de preus
L’eina consulta el servei REST públic de preus de carburants del Ministeri competent. ComparaFactura normalitza únicament els camps necessaris per mostrar estació, adreça, horari, coordenades, preu i data de comunicació quan està disponible. El backend manté una memòria cau curta per reduir dependència i càrrega sobre la font pública.
2. Geolocalització i càlcul de distància
La posició exacta se sol·licita mitjançant l’API de geolocalització del navegador. Es conserva en memòria de JavaScript durant la sessió de la pàgina i s’usa per calcular la distància geogràfica a les estacions. Les coordenades de l’usuari no s’inclouen en la petició a l’endpoint /api/fuel-stations.php.
3. Cost total estimat
distància de càlcul ≈ distància geogràfica × 1,20 × 2
combustible del desplaçament = distància de càlcul × consum/100
cost total estimat = repostatge + combustible del desplaçament × preu €/l
El factor 1,20 és una aproximació per no tractar la línia recta com si fos una ruta real. Continua essent una simplificació i pot fallar en zones amb carreteres indirectes, barreres naturals o accessos complexos.
4. Actualització i preus no garantits
Es mostra la darrera dada oficial disponible i, quan la font ho facilita, la data de comunicació de l’estació. Un preu comunicat pot haver canviat després. El preu indicat físicament a l’estació i les seves condicions prevalen.
5. Què no inclou
- Temps de viatge o valor del temps.
- Trànsit, peatges, aparcament o desviaments reals per carretera.
- Desgast, manteniment o depreciació del vehicle.
- Descomptes privats, targetes, cupons o fidelització.
- Disponibilitat efectiva del combustible o incidències de l’estació.
6. Privacitat i recursos externs
La ubicació exacta no s’emmagatzema a la base de dades de l’eina ni s’envia a l’endpoint de preus. Com qualsevol visita web, el servidor i proveïdors tècnics poden tractar dades tècniques de connexió segons la política general de privacitat. El mapa només es carrega si l’usuari l’obre; en aquest moment se sol·liciten recursos de jsDelivr i tessel·les d’OpenStreetMap, els proveïdors dels quals reben les peticions tècniques necessàries per servir aquests recursos.
7. PWA independent
L’aplicació instal·lable usa un manifest, identificador i service worker propis sota /ca/gasolineres-barates/. La seva memòria cau desa recursos estàtics de l’aplicació per facilitar l’accés, però el cercador necessita connexió per consultar preus oficials. La PWA de Gasolineres Barates no substitueix ni modifica la PWA principal del comparador de tarifes de llum.