La Grande Carte

La Grande Carte est une carte de France en données ouvertes : parcelles
cadastrales, communes, départements et régions, enrichis d'une quarantaine de
sources publiques. Cette API donne accès en lecture aux mêmes données que le
site, sous une forme requêtable.

Ce qu'elle expose

Quatre niveaux, du plus large au plus fin :

• Régions (18) et départements (96 métropolitains) — démographie,
  revenus, logement, emploi, équipements, sécurité, finances locales, PIB,
  espérance de vie, accessibilité aux soins.
• Communes (~35 000) — les mêmes indicateurs à l'échelle communale, plus
  les résultats électoraux, le maire en exercice, la qualité de l'air et de
  l'eau, les normales climatiques et la vacance du parc privé.
• Parcelles cadastrales (94,6 millions) — référence, contenance, géométrie,
  et surtout l'intégralité des enrichissements calculés sur l'emprise :
  adresses BAN, ventes DVF, diagnostics DPE, zonage du PLU et prescriptions,
  arrêtés de catastrophe naturelle et plans de prévention, potentiel radon,
  zone sismique, retrait-gonflement des argiles, sites BASIAS, installations
  classées, quartiers prioritaires, espaces protégés et Natura 2000, cultures
  déclarées au RPG et certification bio, appellations viticoles, monuments
  historiques, établissements SIRENE à moins de 50 m, trafic routier,
  déploiement de la fibre, bornes de recharge, antennes relais, établissements
  de santé, écoles, gares et commerces les plus proches.

Points d'entrée

GET /api/v1                                    index du service (sans clé)
GET /api/v1/regions            /regions/{code}
GET /api/v1/departements       /departements/{code}
GET /api/v1/communes           /communes/{codeInsee}
GET /api/v1/parcelles          /parcelles/{idu}
GET /api/v1/parcelles/{idu}/enrichments

Les géométries et les blocs statistiques sont optionnels (?include=geometry,
?include=stats) pour que les réponses restent légères. Les communes se
retrouvent par code INSEE, par département ou par point (?lat=&lon=), les
parcelles par référence cadastrale ou par point.

Documentation interactive : https://lagrandecarte.fr/api-doc
Spécification OpenAPI 3.1 : https://lagrandecarte.fr/api-doc/openapi.json

Obtenir une clé

Il n'y a pas d'inscription en ligne et pas d'offre payante. Écrivez à
contact@lagrandecarte.fr avec une ou deux lignes sur ce que vous voulez
construire, et vous recevez une clé en retour. Elle se présente dans l'en-tête
X-API-Key.

Limites par défaut : 60 requêtes/minute et 5 000 requêtes/jour par clé. Chaque
réponse renvoie X-Quota-Used et X-Quota-Remaining. Les quotas se relèvent
sur demande pour tout usage sérieux.

Licence, sources et limites

Les données sont republiées sous Licence Ouverte 2.0 : réutilisation libre,
y compris commerciale, à condition de citer la source. Mentionner « La Grande
Carte » avec un lien suffit ; citer directement les producteurs amont convient
aussi.

Chaque source est ingérée dans notre propre PostGIS puis servie depuis nos
serveurs — il n'y a aucune dépendance à une API amont au moment de la réponse.
Les sources, leurs millésimes et leur cadence de rafraîchissement sont publiés
sur https://lagrandecarte.fr/about.

Une valeur absente signifie que la source n'a pas la donnée pour cet objet :
elle n'est jamais remplacée par un zéro. Les départements d'outre-mer ne sont
pas encore dans la table des polygones administratifs, mais leurs communes et
leurs parcelles sont servies normalement.

Stabilité

/api/v1 ne renommera pas de champ existant. De nouveaux champs apparaissent
au fil des sources ingérées : analysez les réponses de façon défensive et
ignorez les clés que vous ne connaissez pas.