Aller au contenu
POST AI agent ready /v1/geo/batch

API de géocodage par lots - Adresse en masse gratuite aux coordonnées

Envoyez un tableau comprenant jusqu'à 10 adresses de forme libre et recevez les coordonnées pour chacune. Les adresses sont géocodées en parallèle. Les échecs individuels renvoient un message d'erreur pour cette adresse sans échouer pour l'ensemble du lot. La réponse inclut les décomptes totaux, résolus et échoués.

Parameters

arrayrequired

Array of address strings to geocode (max 10).

Code examples

curl -X POST https://api.botoi.com/v1/geo/batch \
  -H "Content-Type: application/json" \
  -d '{"addresses":["London, UK","Paris, France","xyzzy nowhere"]}'

When to use this API

Tracer les emplacements des clients sur une carte

Géocodez une liste d’adresses clients à partir de votre export CRM. Utilisez les coordonnées pour placer des épingles sur une carte pour la planification du territoire, l'itinéraire de livraison ou l'analyse de la couverture des ventes.

Enrichir les importations CSV avec des coordonnées

Traitez les fichiers CSV téléchargés contenant des adresses. Géocodez par lots la colonne d'adresse et ajoutez la latitude et la longitude à chaque ligne avant de les stocker dans votre base de données.

Valider plusieurs adresses dans une soumission de formulaire

Lorsqu'un utilisateur soumet un formulaire multi-adresses (par exemple, facturation + expédition + alternative), géocodez toutes les adresses en un seul appel API. Signalez ceux qui ne parviennent pas à être résolus avant d’accepter la soumission.

Frequently asked questions

Quel est le nombre maximum d'adresses par demande ?
Vous pouvez envoyer jusqu'à 10 adresses par demande. Pour les lots plus importants, divisez votre liste en morceaux de 10 et envoyez plusieurs demandes.
Que se passe-t-il si une adresse échoue ?
Les adresses en échec renvoient lat : null, lng : null et un message d'erreur. Le reste du lot est traité normalement. Vérifiez le nombre d'échecs dans la réponse pour identifier les adresses problématiques.
Les appels de géocodage sont-ils effectués en parallèle ?
Oui. Toutes les adresses du lot sont géocodées simultanément pour des temps de réponse plus rapides. Un lot de 10 adresses prend à peu près le même temps qu’une seule demande de géocodage.
Puis-je géocoder plus de 10 adresses ?
Pas dans une seule demande. Divisez votre liste en lots de 10 et envoyez plusieurs demandes. Avec un forfait payant, vous pouvez envoyer plusieurs requêtes par lots par seconde.
Est-ce le même géocodeur que /v1/geo/geocode ?
Oui. Le point de terminaison du lot utilise le même géocodeur OpenStreetMap Nominatim que le point de terminaison à adresse unique. Les résultats sont identiques pour la même entrée.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs