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é

Inscription en ligne sur https://lagrandecarte.fr/compte/inscription (email et
mot de passe, ou Google), confirmation de l'adresse, puis création de la clé
depuis le compte. Elle se présente dans l'en-tête X-API-Key.

Trois plans, limites par compte toutes clés confondues :

• Gratuit — 100 requêtes/jour, 10/minute, usage non commercial.
• Standard — 19 € HT/mois, 2 000 requêtes/jour, 60/minute, usage commercial.
• Pro — 79 € HT/mois, 25 000 requêtes/jour, 300/minute, usage intensif.

Chaque réponse renvoie X-Plan, X-Quota-Used et X-Quota-Remaining.
Collectivités, recherche, besoins hors cadre : contact@lagrandecarte.fr.

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.