adresse.data.gouv.fr

API

Avec l'API d'adresse.data.gouv.fr, embarquez directement les données ouvertes dans votre application.

Pour plus de clarté, les exemples de commande utilisent le package httpie.

/reverse/

Point d'entrée pour le géocodage inverse.

Les paramètres lat et lon sont obligatoires:

http 'http://api-adresse.data.gouv.fr/reverse/?lon=2.37&lat=48.357'

Le paramètre type permet forcer le type de retour:

http 'http://api-adresse.data.gouv.fr/reverse/?lon=2.37&lat=48.357&type=street'

Même format de réponse que pour le point d'entrée /search/.

/search/csv/

Point d'entrée pour le géocodage de masse à partir d'un fichier CSV.

Le fichier csv, encodé en UTF-8 et limité actuellement à 8Mo, doit être passé via le paramètre data:

http --timeout 600 -f POST http://api-adresse.data.gouv.fr/search/csv/ data@path/to/file.csv

Par défaut, toutes les colonnes sont concaténées pour constituer l'adresse qui sera géocodée. On peut définir les colonnes à utiliser via de multiples paramètres columns:

http -f POST http://api-adresse.data.gouv.fr/search/csv/ columns='voie' columns='ville' data@path/to/file.csv

Il est possible de préciser le nom d'une colonne contenant le code INSEE ou le code Postal pour limiter les recherches, exemple :

http -f POST http://api-adresse.data.gouv.fr/search/csv/ columns='voie' columns='ville' citycode='ma_colonne_code_insee' data@path/to/file.csv
http -f POST http://api-adresse.data.gouv.fr/search/csv/ columns='voie' columns='ville' postcode='colonne_code_postal' data@path/to/file.csv

/reverse/csv/

Point d'entrée pour le géocodage inverse de masse à partir d'un fichier CSV.

Le fichier csv, encodé en UTF-8 et limité actuellement à 8Mo, doit être passé via le paramètre data. Il doit contenir les colonnes latitude (ou lat) et longitude (ou lon ou lng).

http --timeout 600 -f POST http://api-adresse.data.gouv.fr/reverse/csv/ data@path/to/file.csv