POST AI agent ready /v1/geo/distance

API de calcul de distance - Haversine entre les coordonnées

Fournissez deux paires latitude/longitude et recevez la distance entre elles calculée à l'aide de la formule Haversine. Prend en charge les kilomètres, les miles et les miles marins. Précis pour deux points quelconques sur Terre. Aucun appel de service externe ; le calcul s'exécute entièrement sur le serveur.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/geo/distance \
  -H "Content-Type: application/json" \
  -d '{"from":{"lat":40.7128,"lng":-74.006},"to":{"lat":51.5074,"lng":-0.1278},"unit":"km"}'

When to use this API

Trier les magasins ou restaurants à proximité par distance de l'utilisateur

Calculez la distance entre les coordonnées de l'utilisateur et chaque emplacement de votre base de données. Triez par résultat pour afficher en premier les options les plus proches. Fonctionne côté serveur, vous n'avez donc pas besoin d'une clé API Google Maps.

Valider le rayon de livraison pour une caisse e-commerce

Avant de confirmer une commande, calculez la distance entre votre entrepôt et l'adresse de livraison. Rejetez ou appliquez un supplément si la distance dépasse votre zone de livraison.

Créez un tracker de distance parcourue pour les applications de fitness ou de logistique

Envoyez des waypoints GPS séquentiels et additionnez les distances pour calculer la longueur totale du trajet. Fonctionne pour les itinéraires de course, le suivi de flotte ou les applications de cyclisme.

Frequently asked questions

Quelle est la précision de la formule Haversine ?

La formule Haversine suppose une sphère parfaite et est précise à environ 0,3 % pour la plupart des distances sur Terre. Pour une précision inférieure au mètre, utilisez la formule de Vincenty, qui prend en compte la forme ellipsoïdale de la Terre.

À quel système de coordonnées ce point de terminaison s’attend-il ?

Degrés décimaux WGS84. La latitude varie de -90 à 90 (du sud au nord). La longitude varie de -180 à 180 (d'ouest en est). Il s'agit du même système utilisé par les appareils GPS et Google Maps.

Puis-je calculer les distances pour plus de deux points ?

Ce point de terminaison gère une paire de points par requête. Pour les itinéraires multipoints, appelez le point final pour chaque paire consécutive et additionnez les distances.

Quelle est la différence entre km, mi et nm ?

km = kilomètres (1 km = 1000 mètres). mi = miles terrestres (1 mi = 1,609 km). nm = milles marins (1 nm = 1,852 km). Les milles marins sont la norme dans l'aviation et la navigation maritime.

Ce point de terminaison appelle-t-il un service de mappage externe ?

Non. Le calcul Haversine s'exécute entièrement sur le serveur sans appels d'API externes. Cela signifie aucune latence supplémentaire et aucune limite de débit tiers.

Get your API key

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