datagouv / geo.api.gouv.fr

Site Web de l'API Géo
https://geo.api.gouv.fr
32 stars 10 forks source link

Update regions/dpts doc #121

Closed maximepvrt closed 5 months ago

maximepvrt commented 5 months ago

ll est impossible de récupérer les fields codeDepartement ou departementd'une région donc j'ai supprimé + quelques mentions à une commune qui n'ont pas de sens dan la région.

J'ai documenté la possibilité de changer la valeur de zone par defaut pour les départements/régions qui est implémentée mais pas documentée

maximepvrt commented 5 months ago

@ThomasG77 ;-)

ThomasG77 commented 5 months ago

Merci pour les corrections. Pour information, vous pouvez aussi regarder du côté de la doc OpenAPI https://github.com/datagouv/api-geo/blob/master/definition.yml visible aussi via https://api.gouv.fr/documentation/api-geo La présente doc est plus facile à comprendre avec les exemples interactifs mais il nous arrive parfois de passer à côté, d'où l'intérêt de votre PR. Les 2 docs sont complémentaires ne s'adressant pas exactement aux mêmes cibles de réutilisateurs. Nous avons encore une autre doc sur https://guides.data.gouv.fr/reutiliser-des-donnees/utiliser-les-api-geographiques/utiliser-lapi-decoupage-administratif même si je suppose que vous la connaissez (la partie sur les EPCI doit être mise à jour en particulier)

maximepvrt commented 5 months ago

Merci pour toutes ces infos ! Il serait bien d'avoir un lien vers https://api.gouv.fr/documentation/api-geo sur le site car je n'avais pas connaissance de cette doc de mon côté.