POST AI agent ready /v1/geo/geocode

API de géocodage - Convertir l'adresse en coordonnées Lat/Lng

Envoyez une chaîne d'adresse (adresse, nom de ville, point de repère ou code postal) et recevez la latitude, la longitude, le nom d'affichage et le type d'emplacement correspondants. Propulsé par le service OpenStreetMap Nominatim. Prend en charge les adresses mondiales dans n’importe quelle langue.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/geo/geocode \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

Convertissez les adresses saisies par l'utilisateur en épingles de carte dans votre application

Lorsqu'un utilisateur saisit une adresse dans un formulaire, géocodez-la et placez un marqueur sur la carte. Cela remplace le besoin d’une API de géocodage Google Maps payante dans de nombreux cas d’utilisation.

Enrichissez vos enregistrements CRM ou base de données avec des coordonnées

Géocodez par lots les adresses des clients pour ajouter des champs lat/lng. Utilisez les coordonnées pour les recherches de proximité, les calculs de zones de livraison ou les rapports géographiques.

Frequently asked questions

Quel fournisseur de géocodage alimente ce point de terminaison ?

Nominatif OpenStreetMap. Les résultats reflètent la qualité des données OpenStreetMap, qui est bonne dans la plupart des pays mais peut être moins détaillée dans les zones rurales ou en développement.

Ce point de terminaison prend-il en charge les adresses non anglaises ?

Oui. Nominatim prend en charge les adresses dans la plupart des langues et scripts. Vous pouvez envoyer des adresses en japonais, arabe, cyrillique ou dans toute autre langue prise en charge par OpenStreetMap.

Que se passe-t-il si l'adresse est ambiguë ou introuvable ?

Si aucun résultat ne correspond, l'API renvoie une erreur 404 NOT_FOUND. Pour les adresses ambiguës, l'API renvoie la première correspondance. Soyez aussi précis que possible (incluez la ville, l'état, le pays) pour une meilleure précision.

Y a-t-il une limite de débit sur les requêtes de géocodage ?

L'accès anonyme permet 5 requêtes par minute. Avec une clé API, la limite de débit est déterminée par votre forfait. Nominatim lui-même a une politique de 1 requête/seconde, que ce point de terminaison respecte.

Puis-je géocoder des adresses IP avec ce point de terminaison ?

Non. Ce point de terminaison convertit les adresses postales en coordonnées. Pour la géolocalisation IP, utilisez le point de terminaison /v1/ip/lookup.

Get your API key

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