API Lufop

Sélectionnez un pays

Données ouvertes sous licence ODbL 1.0

Les données diffusées par l’API Lufop sont mises à disposition sous licence Open Database License (ODbL) 1.0. Cette licence autorise notamment l’utilisation, y compris commerciale, la modification et la redistribution des données, sous réserve du respect de ses conditions d’attribution et de partage à l’identique.

Les plans Free, Pro et Business concernent le service API : quotas de requêtes, volumes de résultats, fonctionnalités avancées, ressources serveur et support. Ils ne modifient pas les droits accordés sur les données par la licence ODbL.

Les données Lufop sont partagées dans un esprit communautaire, avec attribution obligatoire. En revanche, l’accès à l’API est soumis à des quotas selon le plan associé à la clé API. Les exports massifs, synchronisations automatisées, usages multi-pays ou usages commerciaux réguliers nécessitent un accès Pro ou Business.

Utilisez notre API radar

Exemple d'appel API pour récupérer les radars :

Format XML :

https://api.lufop.net/api?key=<key>&format=xml&nbr=2

<markers>
  <marker ID="201239" name="Radar de Chantier FR" lat="48.769664" lng="-0.706603" type="154" commune="Tinchebray-Bocage" voie="D924" flash="D" emplacement="R" azimut="150" update="2023-02-11 09:22:01"/>
  <marker ID="227341" name="Radar Fixe FR 80" lat="49.0860177" lng="7.3727462" type="13" commune="Hottviller" voie="D620" flash="D" emplacement="L" azimut="110" update="2023-02-11 09:21:07"/>
</markers>

Format JSON :

https://api.lufop.net/api?key=<key>&format=json&nbr=2

[
  {
    "ID":"172755",
    "name":"FR Radar Fixe FR 70",
    "lat":47.7235,
    "lng":-0.00997,
    "type":"18",
    "commune":"Clermont-Créans",
    "voie":"D323",
    "flash":"B",
    "emplacement":"R",
    "azimut":"210",
    "update":"2023-02-11 10:24:54",
    "vitesse":"80"	
  },
  {
    "ID":"163273",
    "name":"FR Radar Fixe FR 90",
    "lat":47.8134,
    "lng":0.06263,
    "type":"33",
    "commune":"Cérans-Foulletourte",
    "voie":"D323",
    "flash":"B",
    "emplacement":"R",
    "azimut":"12",
    "update":"2023-02-11 09:53:43",
    "vitesse":"30"
  }
]

Format compact JSONC — réservé Pro / Business

Ce format est optimisé pour les IA et modèles LLM : il réduit drastiquement la taille du JSON en supprimant la répétition des noms de champs. Les LLM traitent plus efficacement des tableaux structurés que des objets verbeux, ce qui améliore la compréhension contextuelle, réduit le coût en jetons et accélère l’analyse.

Ce format est réservé aux usages avancés, aux synchronisations et aux traitements automatisés. Disponible dans les plans Pro et Business uniquement.


      https://api.lufop.net/api?key=<key>&format=jsonc&nbr=2

{
	"s":["ID","name","lat","lng","type","commune","voie","flash","emplacement","azimut","pays","nom_pays","update","typeradar","dept","vitesse"],
	"d":[
		["204120","Radar de Chantier FR",43.211265,3.029909,"154","Narbonne","Route de Perpignan","D","R",220,"FR","FRANCE","2025-10-20 15:14:54","","11 - Aude","80"],
		["169714","Radar Fixe FR 80",43.1273,3.06027,"13","Narbonne","D32","D","R",308,"FR","FRANCE","2025-01-02 16:05:30","tourelle","11 - Aude","80"],["169713","Radar Fixe FR 80",43.1425,3.05099,"13","Narbonne","D32","D","R",165,"FR","FRANCE","2024-06-25 12:51:38","tourelle","11 - Aude","80"]
	]
}

Intérêt pour les LLM : - réduction de 60 à 80% du nombre de jetons consommés - structure tabulaire idéale pour l’analyse automatique - parsing plus rapide - meilleure précision des réponses des modèles (moins de bruit lexical)

Format meta — documentation de l'API en JSON

Ce format ne retourne pas de radars : il retourne la structure de l'API elle-même — liste des pays disponibles, formats et versions supportés, paramètres acceptés, limites par plan, et votre usage courant (appels restants aujourd'hui). Pratique pour construire dynamiquement un formulaire ou un sélecteur de pays sans coder les valeurs en dur.

Clé API obligatoire (comme pour tout appel). Cet appel ne consomme pas de quota.


      https://api.lufop.net/api?key=<votre_cle>&format=meta

{
  "api": "Lufop API",
  "version": "1.3",
  "plan_actuel": "free",
  "usage": {
    "calls_today": 12,
    "calls_per_day_limit": 200,
    "calls_remaining_today": 188
  },
  "pays": [
    { "code": "FR", "nom": "France", "accessible": true },
    { "code": "JP", "nom": "Japon", "accessible": false }
  ],
  "formats": [ "..." ],
  "parametres": [ "..." ]
}

Paramètres de l'API

format : xml, json. Le format jsonc est réservé aux plans Pro et Business.
pays : fr | it | ch | br | es... Le paramètre pays=ALL est réservé aux plans Pro et Business.
nbr : nombre maximum de résultats retournés. Free : 200 résultats par appel. Pro : jusqu’à 10 000 résultats par appel. Business : jusqu’à 30 000 résultats par appel.
since : récupération des mises à jour depuis une date. Réservé aux plans Pro et Business.
q : coordonnées GPS (ex : q=44.866488,2.268774)
m : Approximate geographic search margin around a GPS point (≈ 1/10 km)
c : Commune ( ex : c=narbonne)
format=meta : retourne la documentation structurée de l'API (pays, formats, paramètres, quotas, usage) — voir section dédiée ci-dessus.

Important : les limites dépendent du plan associé à votre clé API. Une clé Free permet de tester l’API, mais ne permet pas les exports massifs, le format JSONC, les synchronisations avancées ou les appels multi-pays globaux.

Calcul de distance :
Le paramètre m (marge) correspond à une zone de recherche géographique approximative autour du point GPS. Il ne s’agit pas d’une distance exacte exprimée en kilomètres. La recherche est effectuée via une boîte englobante latitude / longitude (bounding box) et non par un calcul de distance sphérique. En pratique, m est une unité interne correspondant à environ 1/10 de kilomètre réel (par exemple m=10 ≈ 1 km).

Azimut : Orientation du radar en degrés (0–360), correspondant à la direction vers laquelle le radar est orienté (direction du flash), et non au sens de circulation de la route. Cette valeur est fournie à titre indicatif et peut être approximative selon les sources.

Options disponibles (à partir de l'API v1.2 - 2023-02-10) :

Flash :
- F : Front
- B : Back
- D : Double direction (Back and Front)
Emplacement : Position de la caméra
- L : Caméra à gauche de la route
- R : Caméra à droite de la route
- C : Caméra au centre/milieu de la route ou entre 2 routes

Exemples d'utilisation de l'API

1. Récupérer 100 radars en France (format JSON)


        https://api.lufop.net/api?key=<votre_cle>&format=json&nbr=100&pays=fr

2. Obtenir les radars mis à jour depuis une date — Pro / Business


        https://api.lufop.net/api?key=<votre_cle>&since=2024-01-01

3. Radars dans un rayon de ~10 km autour de Lyon (coordonnées GPS)


        https://api.lufop.net/api?key=<votre_cle>&q=45.75,4.85&m=100

4. Récupérer 50 dernières mise à jour de radars en Italie au format XML


        https://api.lufop.net/api?key=<votre_cle>&format=xml&nbr=50&pays=it

5. Radars de la ville de Narbonne au forma xml :


        https://api.lufop.net/api?key=<votre_cle>&format=xml&c=narbonne

Remplacez <votre_cle> par votre clé API personnelle.

Ajouter un radar via l'API

Cette API permet d’ajouter un radar fixe, mobile, chantier ou feu rouge directement dans la base Lufop. Chaque soumission est automatiquement enrichie via OpenStreetMap (commune, voie, pays) et placée dans une file de validation avant publication.

📡 Endpoint


    POST https://api.lufop.net/api_in.php?key=<votre_clé_api>

🔐 La clé API est obligatoire pour chaque soumission. L’appel échoue si la clé est absente, invalide ou désactivée.

📝 Corps de la requête (JSON)

Champ	Type	Obligatoire	Description
lat	float	Oui	Latitude du radar
lng	float	Oui	Longitude du radar
type	string	Oui	Type du radar : `fixe` \| `mobile` \| `chantier` \| `feu` Une correspondance automatique est faite avec la base interne Lufop.
vitesse	int\|null	Optionnel	Limite de vitesse (radars fixes uniquement)
user	string	Oui	UUID unique et anonyme généré côté client
comment	string	Optionnel	Commentaire de l’utilisateur

📤 Exemple de requête

POST https://api.lufop.net/api_in.php?key=123456ABCDEF

{
  "lat": 45.123456,
  "lng": 5.987654,
  "type": "fixe",
  "vitesse": 80,
  "user": "8f2c8a25-3b77-4924-a23b-1b2be742ee34",
  "comment": "Radar visible en direction de Grenoble"
}

📥 Réponse (succès)

{
  "status": "success",
  "message": "POI ajouté en attente de validation."
}

❌ Exemple de réponse (erreur)

{
  "status": "error",
  "message": "Invalid API key"
}

{
  "status": "error",
  "message": "Missing required fields: lat, lng"
}

{
  "status": "error",
  "message": "No radar type found for pays=France vitesse=90 type=mobile"
}

ℹ️ Notes importantes

La clé API est obligatoire et doit être active.
Chaque radar ajouté est vérifié manuellement avant publication.
L’UUID permet de regrouper les signalements d’un même utilisateur.
La donnée est automatiquement enrichie via OSM (pays, commune, voie).
Le quota de soumissions dépend de votre abonnement API.
Les erreurs fréquentes : type inconnu, coordonnées invalides, clé API invalide.

Pour comprendre comment les données sont collectées, enrichies, contrôlées et corrigées, consultez notre méthodologie de gestion des données .

Demande d'accès à l'API English version

Pays d'utilisation principale

Nom complet

Adresse e-mail

Société/Organisation/Site Internet

Description du projet

Usage prévu de l'API

J'ai lu et j'accepte les conditions d'utilisation et la politique de confidentialité y compris les exigences d’attribution de la licence ODbL 1.0

Je comprends que l'accès Free à l’API est destiné aux tests et petits volumes. Les usages nécessitant davantage de requêtes, des synchronisations avancées, des appels multi-pays ou des ressources serveur supplémentaires nécessitent un accès Pro ou Business.

API Radars Lufop