Pour les développeurs

API publique.

Un accès en lecture aux données publiques que nous ingérons : régions, départements, communes et parcelles cadastrales, avec les statistiques et les enrichissements affichés sur le site. REST, JSON, une clé dans un en-tête. Gratuit.

10 endpoints 39 sources publiques Licence Ouverte 2.0 openapi.json
Obtenir une clé

Écrivez-nous.

Il n'y a pas d'inscription en ligne. Envoyez un mail à contact@lagrandecarte.fr avec une ou deux lignes sur ce que vous voulez construire, et nous vous répondons avec une clé. C'est gratuit, et les quotas se relèvent sur demande pour tout usage sérieux.

Une clé identifie une intégration, pas un visiteur : ne l'embarquez pas dans un front-end public. Les limites par défaut sont de 60 requêtes/minute et 5 000 requêtes/jour. Chaque réponse renvoie X-Quota-Used et X-Quota-Remaining.

curl -H "X-API-Key: VOTRE_CLE" \
  "https://lagrandecarte.fr/api/v1/communes/18033?include=stats"
Référence rapide

Les endpoints.

MéthodeCheminDescription
GET/api/v1Index du service — le seul appel sans clé
GET/api/v1/regionsLes 18 régions
GET/api/v1/regions/{code}Une région · include=geometry,stats,departements
GET/api/v1/departementsLes 96 départements métropolitains · ?region=
GET/api/v1/departements/{code}Un département · include=geometry,stats,communes
GET/api/v1/communesLes communes d'un département (?departement=) ou celle qui contient un point (?lat=&lon=)
GET/api/v1/communes/{codeInsee}Une commune · include=geometry,stats
GET/api/v1/parcelles?lat=&lon=La parcelle cadastrale à un point
GET/api/v1/parcelles/{idu}Une parcelle · include=geometry
GET/api/v1/parcelles/{idu}/enrichmentsTout ce que nous savons de la parcelle

Les départements d'outre-mer ne sont pas encore dans la table des polygones administratifs : /departements/974 répond 404, mais leurs communes et leurs parcelles sont bien servies (/communes?departement=974).

Les données sont publié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.

Documentation interactive

Essayer les appels.