Skip to main content
Géocodage direct en masse d’un fichier CSV
curl --request POST \
  --url https://geo.fluximmo.io/search/csv \
  --header 'Content-Type: multipart/form-data' \
  --form data='@example-file' \
  --form 'columns=<string>' \
  --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 /search/csv traite un fichier CSV d’adresses en une seule requête multipart et retourne le CSV enrichi avec les colonnes géocodées (latitude, longitude, result_label, result_score, result_citycode, etc.). Mode synchrone : la réponse contient le CSV résultat ; à utiliser pour des batchs courts. Transparence : appuyé sur la Base Adresse Nationale (BAN/BANO) publique (api-adresse.data.gouv.fr) opérée par Fluximmo. Pour les fichiers volumineux ou les traitements asynchrones, voir la section Batch async. Limites pratiques :
  • Taille recommandée : quelques milliers de lignes en mode synchrone. Au-delà, basculez vers le pipeline batch async.
  • Format CSV attendu : encodage UTF-8, séparateur configurable (; par défaut), une ou plusieurs colonnes adresse à concaténer via le paramètre columns.
  • Latence : proportionnelle au nombre de lignes ; prévoir un timeout HTTP généreux côté client.

​
Exemple

​
Géocoder un mini-CSV

# adresses.csv contient :
# id;adresse;ville
# 1;1 rue de Rivoli;Paris
# 2;Place Bellecour;Lyon

curl -X POST https://geo.fluximmo.io/search/csv \
  -F "[email protected]" \
  -F "columns=adresse" \
  -F "columns=ville"

​
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 lignes à géocoder

​
columns
string[]

Liste des colonnes du fichier CSV à utiliser pour le géocodage. Celles-ci seront concaténées pour former le critère de recherche texte.

Si le paramètre n'est pas fourni toutes les colonnes seront concaténées, ce qui est rarement souhaitable.

​
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.