Interroger les référentiels géographiques plus facilement
Home Page: https://api.gouv.fr/api/api-geo.html
License: MIT License
Consulter la fiche sur api.gouv.fr
yarn # (--prod)
yarn buildyarn startyarn testdocker-compose upL'API géo est notamment utilisée par Etalab et beta.gouv.fr. Les usages cités ici ne sont pas exhaustifs. Si vous utiliser l'API Géo, n'hésitez pas à le mentionner ici.
Utilisée dans les produits Etalab
Utilisée dans les produits betagouv
MIT
En utilisant l'API, je parviens bien à récupérer les contours des communes mais pas pour les départements. Cela implique donc une agrégation côté client.
De façon plus générale, dans un souci de cohérence d'usage, je suggère que les objets renvoyés aient une structure pseudo-générique :
Bonjour,
Je voudrais vous proposer d'implémenter une pagination des résultats qui permettrait en autre pour ceux qui n'ont pas besoin de tout charger de récupérer uniquement ce dont ils ont besoin (ex: uniquement les 10 premiers). En général, les API implémentent cela à l'aide de 2 paramètres offset/limit.
Comme ça, en cas de besoin, il est toujours possible de parcourir les autres résultats.
Merci de votre aide!
/departements? => Rechercher des départements #29/departements/{code} => Obtenir les informations d'un département #30/departements/{code}/communes => Lister les communes d'une région #31Le COG 2017 est disponible. Nous pouvons retirer notre mise à jour manuelle pour utiliser la version officielle.
/regions? => Rechercher des régions #38/regions/{code} => Obtenir les informations d'une région #39/regions/{code}/departements => Lister les départements d'une région #40Actuellement l'intégration est une série de 3 promesses, intervenant sur des variables qu'elles partagent via une fermeture.
Pour faciliter l'ajout ultérieur de nouvelles données, il faut rendre cela plus modulaire.
Après réflexion je pars sur un modèle de pipeline, qui reproduit les étages actuels + une étape d'initialisation :
Chaque étage du pipeline partage cette interface :
function step(ctx, next) {
// Mon code ici
next(); // Avec une erreur, éventuellement
}Le contexte ctx sert à passer des variables communes ou des helpers, tels que ctx.debug().
https://geo.api.gouv.fr/departements/971/communes
Retourne un tableau vide.
Bonjour,
Je voudrais proposer une fonctionnalité qui permet de rechercher des communes à proximité d'un point et pour un rayon de recherche donné. Les résultats seraient triés par rapport à la distance au centre des communes.
/departements? => Rechercher des départements/departements/{code} => Obtenir les informations d'un département/departements/{code}/communes => Lister les communes d'une régionUne demande d'un utilisateur : pourrait-on gérer ces codes postaux pour les trois métropoles à arrondissements ?
Il s'agit vraisemblablement de codes postaux factices fréquemment utilisés.
Peut-être pourrions-nous attendre quelques semaines et examiner les logs d'utilisation de l'API pour avoir une idée ?
Bonjour,
J'ai une proposition d'amélioration pour votre web service.
L'auto-complétion du code postal comme celui utilisé par la commune.
Exemple : saisir 38 fourni toutes les communes avec le code postal 38.
Saisir 3808 fourni toutes les communes avec comme code postal 3808
Cordialement,
Jordan
Proposer le centre administratif des communes, en plus du centroïde.
En cas de saisie du nom exact d'une commune, devrait-on remonter cette commune en haut de la liste ?
https://geo.api.gouv.fr/communes?nom=lille
Et aussi pourquoi n'est-ce pas déjà le cas ?
Investiguer avec lunr.
Je vois le ticket #74, mais il serait pratique d'ajouter la notion des communes fusionnees dans l'API et ainsi amener une notion de millesime. https://api.gouv.fr/api/api-geo.html ne precise pas le millesime actuel, et un appel a la racine de l'API pourrait fournir l'info (ou fournir carrément une api versionnée par millésime ?)
Ex 63255 et 63266 ont fusionné en 2014 pour devenir 63255, https://geo.api.gouv.fr/communes/63266 me renvoie un 404.
Idealement, l'API devrait ou rediriger vers 63255 (avec un code 302 ?), et les infos renvoyees pour 63255 devrait faire apparaitre la notion de filiation avec 63266, ou renvoyer les anciennes infos pour 63266 avec un champ specifiant qu'elle a ete fusionnee avec 63255.
@jdesboeufs on en parle ?
Actuellement on peut recherche des communes :
Pour les deux derniers critères il semble intéressant de pouvoir les cumuler, par exemple rechercher par nom et code postal, pour normaliser une base de donnée.
L'intérêt sera beaucoup plus fort lorsque davantage de critères seront disponibles (département, région, zone géographique arbitraire).
Une demande utilisateur pour supporter les mots contractés usuels dans l'auto-complétion.
Dans le cas des communes, nous avons par exemple :
Avoir au moins deux instances et une tolérance des pannes.
CamelCase, snake_case
Français/Anglais
etc.
Function is not registered with pipeline. This may cause problems when serialising the index.
Message intempestif, lors de l'exécution, lors des tests.
Bonjour,
Depuis maintenant plus d'une semaine, certaines API de la GéoAPI ne fonctionnent plus.
Sont concernés toutes les requêtes associées aux communes et aux départements.
J'ai peut-être des erreurs de mon côté, mais lorsque je fais l'appel à l'API des départements par exemple, j'obtiens l'erreur suivante:
TypeError: req.db.regions.queryByCode is not a function<br>
at formatOne (/var/www/communes/lib/helpers.js:44:35)<br>
at res.send.dbDepartements.search.map.departement (/var/www/communes/server.js:81:27)<br>
at Array.map (native)<br> at /var/www/communes/server.js:81:8<br>
at Layer.handle [as handle_request] (/var/www/communes/node_modules/express/lib/router/layer.js:95:5)<br>
at next (/var/www/communes/node_modules/express/lib/router/route.js:131:13)<br> at /var/www/communes/lib/helpers.js:13:5<br>
at Layer.handle [as handle_request] (/var/www/communes/node_modules/express/lib/router/layer.js:95:5)<br>
at next (/var/www/communes/node_modules/express/lib/router/route.js:131:13)<br>
at Route.dispatch (/var/www/communes/node_modules/express/lib/router/route.js:112:3)
Y-a-t-il quelque chose à faire de mon côté pour régler ce souci ?
Il manque au jeu de données tous les déterminants dans les noms villes.
Exemple, https://geo.api.gouv.fr/communes?codePostal=17000&nom=Rochelle&fields=nom retourne
[{"nom":"Rochelle","code":"17300"}]et devrait retourner
[{"nom":"La Rochelle","code":"17300"}]Population des communes
Bonjour,
afin de pouvoir exploiter un outil de visualisation plus simplement (sur le périmètre du territoire), j'éprouve quelques difficultés à sourcer les bonnes informations à propos des bordures pour procéder à l'intégration dans Gephi d'un fond de carte permettant une visualisation sur un périmètre "France" / "Région" / "Commune"
Le plugin est ici,
https://marketplace.gephi.org/plugin/maps-of-countries/
Les possibilités d'intégrations sont expliquées ici
https://exploreyourdata.wordpress.com/2013/09/24/new-gephi-plugin-add-background-maps-to-your-networks/
Quelques personnes de transformap ont déjà aidées pour mettre à jour et maintenir le script https://github.com/seinecle/Plugins-for-Gephi/issues
La dernière étape pour sourcer les bonnes informations pour les bordures reste bloquante.
L'API serait elle en mesure de fournir ces informations ?
Merci
/regions? => Rechercher des régions/regions/{code} => Obtenir les informations d'une région/regions/{code}/departements => Lister les départements d'une régionParis, Marseille, Lyon.
Est-ce délibéré? C'est inattendu que le choix d'un format modifie le contenu renvoyé par une API. (Si c'est délibéré, la doc devrait le mentionner.)
Les noms des régions ne prennent pas en compte le décret de renommage lié à la réforme territoriale.
Ping @MattiSG
La recherche de communes par nom est trop lourde lorsqu'il y a moins de 3 caractères.
Hélas 205 communes ont 1, 2 ou 3 caractères, et elles doivent pouvoir être trouvées.
Proposition :
3 caractères : recherche ngram actuelle
S'inspirer de l'API CSV de la BAN pour proposer une fonction similaire, appliquée aux communes.
Fonctionnalités intéressantes :
PointPoint, retourner true si le Point est bien situé dans la communeL'utilisation de variable globales et l'inter-dépendances des functions rend l'intégration difficilement testable.
Bonjour,
pourrait-on interroger l'API avec un geojson et que celle-ci nous retourne la liste des communes, + EPCI, + départements, + régions ?
Merci
Dockerfile
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
Django
The Web framework for perfectionists with deadlines.
Laravel
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft
Open source projects and samples from Microsoft.
Google
Google ❤️ Open Source for everyone.
Alibaba
Alibaba Open Source for everyone
D3
Data-Driven Documents codes.
Tencent
China tencent open source team.