API Régions de France

Cette documentation décrit l'API des régions de France, clone de l'API Geo Gouv.

🗺️ Endpoints

GET /regions

Récupère la liste de toutes les régions françaises.

Paramètres :

Paramètre	Type	Description	Défaut
`fields`	string	Champs à retourner (séparés par des virgules)	Tous
`boost`	string	Tri par population (`population`)	Par code
`limit`	number	Nombre maximum de résultats	100
`format`	string	Format de sortie (`json` ou `geojson`)	`json`

Champs disponibles :

code : Code région (2 chiffres)
nom : Nom de la région
population : Population totale
superficieKm2 : Superficie en km²
chefLieu : Code INSEE du chef-lieu
centroide : Coordonnées du centroïde (GeoJSON Point)
contour : Contour de la région (GeoJSON Polygon)

Exemples :

bash

# Liste toutes les régions
curl "https://2mnservices.alwaysdata.net/regions"

# Régions triées par population
curl "https://2mnservices.alwaysdata.net/regions?boost=population&limit=5"

# Champs spécifiques
curl "https://2mnservices.alwaysdata.net/regions?fields=code,nom,population"

# Format GeoJSON
curl "https://2mnservices.alwaysdata.net/regions?format=geojson"

Réponse :

json

[
  {
    "code": "01",
    "nom": "Guadeloupe",
    "population": 390704,
    "superficieKm2": 1628.46
  },
  {
    "code": "02",
    "nom": "Martinique",
    "population": 385103,
    "superficieKm2": 1127.23
  },
  ...
]

GET /regions/{code}

Récupère les détails d'une région par son code.

Paramètres :

code (path) : Code de la région (2 chiffres)
fields : Champs à retourner
format : Format de sortie (json ou geojson)

Exemples :

bash

# Détails de l'Île-de-France
curl "https://2mnservices.alwaysdata.net/regions/11"

# Avec champs spécifiques
curl "https://2mnservices.alwaysdata.net/regions/11?fields=code,nom,population,superficieKm2,chefLieu"

# Format GeoJSON
curl "https://2mnservices.alwaysdata.net/regions/11?format=geojson"

Réponse :

json

{
  "code": "11",
  "nom": "Île-de-France",
  "codeRegion": "11",
  "nomRegion": "Île-de-France",
  "population": 12400000,
  "superficieKm2": 12011,
  "chefLieu": "75101",
  "centroide": {
    "type": "Point",
    "coordinates": [2.454, 48.849]
  },
  "contour": {
    "type": "Polygon",
    "coordinates": [...]
  }
}

📋 Liste des régions

Code	Nom
01	Guadeloupe
02	Martinique
03	Guyane
04	La Réunion
05	Mayotte
11	Île-de-France
24	Centre-Val de Loire
27	Bourgogne-Franche-Comté
28	Normandie
32	Hauts-de-France
44	Grand Est
52	Pays de la Loire
53	Bretagne
75	Nouvelle-Aquitaine
76	Occitanie
84	Auvergne-Rhône-Alpes
93	Provence-Alpes-Côte d'Azur
94	Corse

⚠️ Note sur l'installation

Pour importer les régions, exécutez :

bash

npm run import:regions

🔗 Sources

Données : API Geo Gouv
Documentation officielle : geo.api.gouv.fr