v2.2.0

Nouveautés API Découpage Administratif

Sur les COM (Collectivités d'Outre-Mer)

Il est possible de retourner les COM sur les endpoints /departements et regions. Nous avons abusivement fait rentrer ces dernières en assimilant une COM = une région = un département. Pour pouvoir les obtenir, vous devez ajouter ces options &zone=metro,drom,com.

Cela donne https://geo.api.gouv.fr/departements?zone=metro,drom,com pour les départements et https://geo.api.gouv.fr/regions?zone=metro,drom,com pour les régions.
On est obligé de passer cette option explicitement sinon les COM ne sont pas retournés dans ces endpoints.

Il n'est pas nécessaire de passer cette option sur le endpoint /communes. Cette différence s'explique par un besoin de rétrocompatibilité: les gens qui demandaient une commune des COM depuis commune, l'obtenait par défaut. Nous avons donc mis l'option par défaut sans que cela apparaisse dans l'URL (ainsi https://geo.api.gouv.fr/communes?zone=metro,drom,com renvoie pareil que https://geo.api.gouv.fr/communes). Vous ne voudriez par exemple que les communes des DROM, vous pourriez ainsi faire, https://geo.api.gouv.fr/communes?zone=drom ou bien que celles de la métropole, https://geo.api.gouv.fr/communes?zone=metro

Sur les communes

• Possibilité de retourner les mairies des communes plutôt que les centres géométriques des communes ou les contours https://geo.api.gouv.fr/communes/44109?nom=Versailles&fields=code,nom&geometry=mairie&format=geojson. Les exceptions à cette règle pour le moment sont les communes mortes pour la France ci-dessous où on utilise l'emplacement du mémorial et les mairies des COM (Collectivités d'Outre-Mer) où on ne dispose pas pour le moment de données mairie satisfaisantes :

  • Fleury-devant-Douaumont (55189)
  • Beaumont-en-Verdunois (55039)
  • Bezonvaux (55050)
  • Haumont-près-Samogneux (55239)
  • Louvemont-Côte-du-Poivre (55307)
  • Cumières-le-Mort-Homme (55139)

• Retour de la bbox. Utile quand on a besoin de l'étendu pour zoomer sur la commune plutôt que le contour, beaucoup plus lourd à retourner https://geo.api.gouv.fr/communes/44109?nom=Versailles&fields=code,nom&geometry=bbox&format=geojson

• retour du code SIREN pour les communes. On peut soit faire un appel classique type https://geo.api.gouv.fr/communes?nom=Nantes, soit chercher par code SIREN exact de la commune avec https://geo.api.gouv.fr/communes?siren=214401093

Des exemples concrets pour consommer les données liés aux EPCI

On a d'une part enrichi le retour des communes avec les EPCI et d'autres part, ajouté des endpoints spécifiques aux EPCI.

Forme /communes

On a rajouté un filtre sur le code EPCI. Deux scénarios principaux peuvent être adressés ainsi:

• Connaitre le code de l'EPCI d'une commune avec sa variante où l'on retourne le code de l'EPCI et son nom
• Connaitre les communes d'un EPCI https://geo.api.gouv.fr/communes?codeEpci=200004802 qui est en fait adressé par une forme plus intuitive https://geo.api.gouv.fr/epcis/200004802/communes

Forme /epcis

• Pour chercher un EPCI par nom https://geo.api.gouv.fr/epcis?nom=pornic
• Pour avoir les EPCI d'un département https://geo.api.gouv.fr/epcis?codeDepartement=44

Attention: des EPCI sont parfois entre 2 départements et même entre 2 régions: il peut y avoir des doubles-comptes sur la population si vous demandez les EPCI d'un département et d'un autre département et qu'ils "partagent" un EPCI

Il n'est pas possible de rechercher par code postal directement sur l'EPCI. Il faut passer par le endpoint /communes qui retourne maintenant le code EPCI avec par exemple https://geo.api.gouv.fr/communes?nom=Versailles ou pour avoir toutes les communes d'un code EPCI (qui est un SIREN) https://geo.api.gouv.fr/epcis/200004802/communes puis récupérer les codes postaux des communes membres.

Forme /epcis/<code>

• Avoir les infos de l'EPCI https://geo.api.gouv.fr/epcis/200004802
• Avoir les infos de l'EPCI en retournant un GeoJSON des contours https://geo.api.gouv.fr/epcis/200004802?format=geojson&geometry=contour
• Avoir les infos de l'EPCI en retournant un GeoJSON de la bbox (le rectangle englobant du contour) pour par exemple zoomer sur l'étendue de l'EPCI https://geo.api.gouv.fr/epcis/200004802?format=geojson&geometry=bbox

Forme /epcis/<code>/communes

• Avoir les communes depuis un code EPCI https://geo.api.gouv.fr/epcis/200004802/communes

Limitations actuelles:

• Les noms en CA peuvent générer du bruit https://geo.api.gouv.fr/epcis?nom=CA
• Le même problème peut se poser pour tous les noms avec agglo ou metro https://geo.api.gouv.fr/epcis?nom=Agglo et https://geo.api.gouv.fr/epcis?nom=metro

Récapitulatif changements principaux côté code

• Exposition des COM (Collectivités d'Outre-Mer) by @ThomasG77 in #158
• Ajout du support pour gérer les positions des mairies ainsi que le retour sous forme de bbox des communes by @ThomasG77 in #160
• Ajout du support des EPCI by @ThomasG77 in #163
• Ajout du support des codes SIREN pour les communes by @ThomasG77 in #165

Full Changelog: v2.0.1...v2.2.0