Skip to main content
Géocodage inversé en masse d’un fichier CSV
curl --request POST \
  --url https://geo.fluximmo.io/reverse/csv \
  --header 'Content-Type: multipart/form-data' \
  --form data='@example-file' \
  --form 'indexes=<string>' \
  --form 'type=<string>' \
  --form 'citycode=<string>' \
  --form 'postcode=<string>' \
  --form 'category=<string>' \
  --form 'lon=<string>' \
  --form 'lat=<string>' \
  --form 'departmentcode=<string>' \
  --form 'municipalitycode=<string>' \
  --form 'oldmunicipalitycode=<string>' \
  --form 'districtcode=<string>' \
  --form 'section=<string>' \
  --form 'sheet=<string>' \
  --form 'number=<string>' \
  --form 'result_columns=<string>'
"<string>"

​
À quoi ça sert

POST /reverse/csv prend un fichier CSV de coordonnées GPS et retourne le CSV enrichi des adresses correspondantes (result_label, result_postcode, result_citycode, result_city). Mode synchrone ; pour les volumes importants, basculer sur le pipeline batch async. Transparence : repose sur la Base Adresse Nationale (BAN/BANO) publique opérée par Fluximmo (api-adresse.data.gouv.fr). Limites pratiques :
  • Quelques milliers de lignes max en synchrone, encodage UTF-8.
  • Le CSV doit contenir des colonnes latitude et longitude (noms configurables via les paramètres lat et lon).

​
Exemple

​
Reverse-geocoder un mini-CSV de points GPS

# points.csv contient :
# id;latitude;longitude
# 1;48.8606;2.3376
# 2;45.7640;4.8357

curl -X POST https://geo.fluximmo.io/reverse/csv \
  -F "[email protected]"

​
Liens utiles

Clé test gratuite — 1 semaine

Créez un compte sur my.fluximmo.io pour récupérer une clé API test gratuite (1 semaine, accès limité). Aucun paiement requis.

Body

multipart/form-data
​
data
file
required

Fichier CSV contenant les données à géocoder

​
indexes
string[]

Liste des index à utiliser pour le géocodage (parmi address, poi, parcel)

​
type
string

Colonne contenant le type d’objet accepté pour le géocodage de la ligne (address)

​
citycode
string

Colonne contenant le code INSEE de la commune à utiliser comme filtre (address, poi)

​
postcode
string

Colonne contenant le code postal à utiliser comme filtre (address, poi)

​
category
string

Colonne contenant la catégorie de POI à utiliser comme filtre (poi)

​
lon
string

Colonne contenant la longitude du point de recherche

​
lat
string

Colonne contenant la latitude du point de recherche

​
departmentcode
string

Colonne contenant le code département à utiliser comme filtre (parcel)

​
municipalitycode
string

Colonne contenant le code commune à utiliser comme filtre (parcel)

​
oldmunicipalitycode
string

Colonne contenant l'ancien code commune à utiliser comme filtre (parcel)

​
districtcode
string

Colonne contenant le code d'arrondissement à utiliser comme filtre (parcel)

​
section
string

Colonne contenant le numéro de section à utiliser comme filtre (parcel)

​
sheet
string

Colonne contenant le numéro de feuille à utiliser comme filtre (parcel)

​
number
string

Colonne contenant le numéro de parcelle à utiliser comme filtre (parcel)

​
result_columns
string[]

Liste des colonnes de type résultat à conserver dans le fichier CSV de sortie.

Par défaut toutes les colonnes disponibles sont retournées.

Response

Géocodage réussi

Fichier CSV géocodé. Les lignes d'origine sont préservées.

Les colonnes issues de l'objet associé lors du géocodage et pouvant être ajoutées sont :

  • result_label
  • result_score
  • result_type (address)
  • result_id
  • result_housenumber (address)
  • result_name (address)
  • result_street (address)
  • result_postcode (address, poi)
  • result_city (address, poi)
  • result_context
  • result_citycode (address, poi)
  • result_oldcitycode (address, poi)
  • result_oldcity (address, poi)
  • result_district (address, poi)
  • result_category (poi)
  • result_departmentcode (parcel)
  • result_municipalitycode (parcel)
  • result_section (parcel)
  • result_sheet (parcel)
  • result_number (parcel)
  • result_oldmunicipalitycode (parcel)
  • result_districtcode (parcel)

Les colonnes suivantes sont spécifiques au géocodage direct :

  • latitude
  • longitude

Les colonnes suivantes sont spécifiques au géocodage inversé :

  • result_latitude
  • result_longitude
  • result_distance

Les colonnes suivantes sont liées au géocodage en masse :

  • result_score_next : score du résultat suivant le cas échéant
  • result_index : index dans lequel l'objet a été trouvé
  • result_status (ok = trouvé, not-found = non trouvé, skipped = ligne ignorée en raison de paramètres manquants ou invalides, error = erreur du serveur lors de la recherche)

NB : En cas de colonnes d'origine nommées latitude ou longitude et de géocodage direct, elles seront écrasées par les valeurs calculées.