Géocoder un fichier CSV d'adresses

Vous avez un tableur d'adresses et il vous faut la latitude et la longitude de chacune. Le point d'accès par lot d'Addrova prend le fichier, géocode chaque ligne et renvoie le même fichier avec les coordonnées, un score de confiance et les sources utilisées. Un outil de dépôt dans le navigateur est prévu ; aujourd'hui, le lot est un appel d'API. [À VÉRIFIER : disponibilité de l'outil web de géocodage CSV, limites sans compte, gratuité.]

Ce qu'il vous faut

• Une clé d'API. [À VÉRIFIER : ouverture du service et délivrance des clés.]
• Un CSV en UTF-8 avec ligne d'en-tête, séparé par , ; tabulation ou |, ou un fichier JSON Lines. Par défaut : jusqu'à 50 Mo et 100 000 lignes (configurable).
• Une colonne avec l'adresse complète, ou des colonnes séparées pour la voie, le code postal et la ville.

Pas à pas

# 1. envoyer le fichier
curl -s https://api.addrova.eu/v1/batch \
  -H "X-API-Key: $ADDROVA_API_KEY" \
  -F file=@adresses.csv -F address_column=adresse -F country=FR

# 2. interroger jusqu'à ce que status vaille « succeeded » (avec l'id du job renvoyé à l'étape 1)
curl -s https://api.addrova.eu/v1/batch/ID_DU_JOB -H "X-API-Key: $ADDROVA_API_KEY"

# 3. télécharger le résultat
curl -s https://api.addrova.eu/v1/batch/ID_DU_JOB/result \
  -H "X-API-Key: $ADDROVA_API_KEY" -o geocode.csv

Si votre fichier a des colonnes séparées, envoyez columns=street=adresse,postcode=cp,city=ville à la place de address_column. Une colonne country par ligne l'emporte sur le country par défaut.

Lire le résultat

Toutes les colonnes d'entrée sont conservées, avec en plus : addrova_label, addrova_lat, addrova_lon, addrova_precision, addrova_confidence, addrova_confidence_level, addrova_sources et addrova_status.

L'attribution de toutes les sources utilisées figure en ligne de commentaire finale du CSV. Conservez-la avec vos données : les licences des données ouvertes l'exigent.

Facturation et limites

Une unité par ligne d'adresse non vide, réservée à l'envoi : votre quota mensuel doit couvrir tout le fichier. Les adresses identiques d'un même fichier ne sont géocodées qu'une fois. [À VÉRIFIER : le prix unitaire du lot n'est pas encore décidé, voir /fr/pricing.]

Ce que devient votre fichier

• Le fichier d'entrée est supprimé dès la fin du traitement (affirmation ZL-22).
• Le résultat et les métadonnées du job sont supprimés au bout d'une heure par défaut, ou immédiatement avec DELETE /v1/batch/ID_DU_JOB (ZL-22).
• Les métadonnées du job ne contiennent aucune ligne de votre fichier (ZL-23), et un autre client ne peut pas voir votre job (ZL-24).
• Aucune adresse n'est écrite dans les journaux (ZL-10).

Chaque identifiant renvoie à un test automatique, listé sur la page conformité. Le lieu physique du traitement (hébergement UE) n'est pas prouvé par ces tests et reste à confirmer avant le lancement. [À VÉRIFIER : hébergeur et région.]

Conseils pour de meilleurs résultats

• Géocodez d'abord un échantillon de 500 lignes et regardez les lignes uncertain.
• Gardez les colonnes code postal et ville séparées quand vous les avez : elles améliorent la correspondance.
• Pour les fautes et abréviations, passez les lignes problématiques dans POST /v1/repair, facturé au succès uniquement.

FAQ

Existe-t-il un moyen gratuit de géocoder un CSV ? Le palier gratuit est de 30 000 requêtes par mois. [À VÉRIFIER : le lot consomme-t-il le quota gratuit, ligne par ligne ?]

Puis-je garder les résultats ? Oui, sans limite de durée, avec l'attribution.

Et Excel ? Enregistrez d'abord en CSV (UTF-8).