Accueil › Méthodologie
Depuis 2007, toute station-service en France dont les ventes annuelles dépassent un certain seuil est tenue de déclarer ses prix carburants. Le ministère de l'Économie publie ces déclarations en open data, sous forme d'un flux instantané mis à jour en continu : prix-des-carburants-en-france-flux-instantane-v2.
PleinMalin interroge cette API directement depuis votre navigateur, à chaque recherche. Nous ne recopions pas les données sur un serveur intermédiaire : ce que vous voyez est ce que le ministère publie à l'instant de votre requête.
Quand vous tapez un nom de ville, PleinMalin le convertit en coordonnées GPS via la Base Adresse Nationale (API Adresse, data.gouv.fr), un autre service public gratuit. Cette conversion se fait aussi directement dans votre navigateur.
Les suggestions de ville qui apparaissent pendant la frappe, elles, ne passent pas par cette API (qui refuse toute recherche de moins de 3 caractères) : elles viennent d'une liste des communes françaises (nom, coordonnées, code postal) publiée par l'API Découpage administratif de l'État, téléchargée une fois par votre navigateur et filtrée localement, sans appel réseau à chaque lettre tapée.
Le flux officiel du ministère ne contient aucun champ marque/enseigne. PleinMalin affiche cette information quand elle est disponible en la croisant, uniquement dans votre navigateur, avec le jeu « Stations service » (organisation OpenStreetMap sur data.gouv.fr, licence ODbL), rapproché quotidiennement du flux officiel par le projet Osmose-QA sur le même identifiant de station. C'est une source différente de celle du reste du site, avec sa propre licence : voir « Limites connues » ci-dessous et la mention en pied de page.
Cet export (un fichier compressé, mis à jour environ une fois par jour par le projet Osmose-QA) n'est pas téléchargé en direct par votre navigateur : sa source ne rend pas cette information accessible aux sites tiers pour ce type de requête. PleinMalin le récupère donc en amont, à intervalle régulier, et sert le résultat (les identifiants de station associés à leur marque) comme un simple fichier statique du site, mis à jour périodiquement — pas en temps réel comme les prix. Si ce fichier est absent ou périmé, la recherche de prix continue de fonctionner normalement : l'affichage de la marque est un simple ajout, jamais une condition pour voir les prix.
Chaque station affiche l'horodatage de sa dernière déclaration de prix, pas l'heure de notre requête. Une station qui n'a pas changé ses prix depuis 3 jours affichera "MAJ il y a 3 jours" — ce n'est pas une donnée périmée, c'est simplement que le prix n'a pas bougé depuis.
Nous cherchons les stations dans un rayon de 15 km autour du point recherché (ville ou position GPS), triées par prix croissant pour le carburant sélectionné. Si aucune station n'apparaît, c'est qu'aucune ne déclare ce carburant dans ce rayon — pas une erreur du site.