Introduction
ATerraDatA API vous permet d'accéder facilement aux données d'état des risques environnementaux
en France. Notre API agrÚge les données de Géorisques pour vous fournir une réponse unifiée et
simple Ă utiliser.
â ïž Authentification requise
Toutes les requĂȘtes doivent inclure votre clĂ© API dans le header X-API-Key.
Endpoint Principal
GET
/api/v1/risks
RécupÚre l'état des risques pour une localisation donnée.
ParamĂštres de requĂȘte
| ParamĂštre |
Type |
Requis |
Description |
lat |
float |
Oui* |
Latitude (format décimal, ex: 48.8566) |
lon |
float |
Oui* |
Longitude (format décimal, ex: 2.3522) |
address |
string |
Oui* |
Adresse complĂšte (ex: "123 rue de la Paix, 75001 Paris") |
* Vous devez fournir soit lat/lon, soit address
Headers requis
| Header |
Valeur |
Description |
X-API-Key |
Votre clé API |
Clé d'authentification obtenue lors de l'inscription |
Exemples de requĂȘtes
Exemple 1 : Recherche par coordonnées
curl -X GET \
"https://nselatedfeynmanaqvhhdp4-container-epic-jennings.functions.fnc.fr-par.scw.cloud/api/v1/risks?lat=48.8566&lon=2.3522" \
-H "X-API-Key: VOTRE_CLE_API"
Exemple 2 : Recherche par adresse
curl -X GET \
"https://nselatedfeynmanaqvhhdp4-container-epic-jennings.functions.fnc.fr-par.scw.cloud/api/v1/risks?address=123%20rue%20de%20la%20Paix,%2075001%20Paris" \
-H "X-API-Key: VOTRE_CLE_API"
Exemple 3 : JavaScript (Fetch)
const response = await fetch('https://nselatedfeynmanaqvhhdp4-container-epic-jennings.functions.fnc.fr-par.scw.cloud/api/v1/risks?lat=48.8566&lon=2.3522', {
headers: {
'X-API-Key': 'VOTRE_CLE_API'
}
});
const data = await response.json();
console.log(data);
Exemple 4 : Python
import requests
url = "https://nselatedfeynmanaqvhhdp4-container-epic-jennings.functions.fnc.fr-par.scw.cloud/api/v1/risks"
headers = {"X-API-Key": "VOTRE_CLE_API"}
params = {"lat": 48.8566, "lon": 2.3522}
response = requests.get(url, headers=headers, params=params)
data = response.json()
print(data)
RĂ©ponse API
Structure de la réponse (succÚs)
{
"location": {
"latitude": 48.8566,
"longitude": 2.3522,
"address": "Paris, France"
},
"risk_summary": {
"inondation": {
"level": "faible",
"details": "Zone non exposée"
},
"argile": {
"level": "moyen",
"details": "Risque modéré de retrait-gonflement"
},
"installations_classees": {
"count": 2,
"details": "2 installations dans un rayon de 500m"
},
"pollution_sols": {
"level": "aucun",
"details": "Aucun site pollué répertorié"
}
},
"timestamp": "2025-10-05T12:00:00Z"
}
Niveaux de risque
| Niveau |
Description |
| aucun |
Aucun risque identifié |
| faible |
Risque faible, vigilance normale |
| moyen |
Risque modéré, précautions recommandées |
| eleve |
Risque élevé, mesures spécifiques nécessaires |
Codes d'erreur
| Code HTTP |
Message |
Description |
| 400 |
Bad Request |
ParamĂštres manquants ou invalides |
| 401 |
Unauthorized |
Clé API manquante ou invalide |
| 404 |
Not Found |
Adresse introuvable |
| 429 |
Too Many Requests |
Quota dépassé |
| 500 |
Internal Server Error |
Erreur serveur |
Exemple de réponse d'erreur
{
"error": {
"code": "INVALID_API_KEY",
"message": "La clé API fournie est invalide"
}
}
Limites et Quotas
| Plan |
RequĂȘtes/mois |
Rate Limit |
| Freemium |
100 |
10 req/min |
| Professionnel |
10 000 + 0.01âŹ/req sup. |
100 req/min |
| Entreprise |
Illimité |
1000 req/min |
Support
Pour toute question ou problĂšme technique :