Vérifier un géofence circulaire

Il calcule la distance orthodromique avec la formule de Haversine, la compare au rayon en mètres et renvoie une marge signée indiquant l'espace restant. Une marge positive signifie que le point est dedans, zéro désigne la limite et une marge négative indique de combien il est dehors. Le calcul est déterministe et ne nécessite aucun service cartographique, aucune recherche d'appareil ni aucune requête réseau.

Définissez précisément le point, le centre et le rayon

Un géofence circulaire comprend trois éléments essentiels : une latitude centrale, une longitude centrale et un rayon non négatif mesuré en mètres. La latitude et la longitude distinctes du point désignent l'emplacement que vous souhaitez tester. Fournissez toutes les coordonnées en degrés décimaux dans les plages géographiques WGS84 habituelles : latitude de moins quatre-vingt-dix à quatre-vingt-dix et longitude de moins cent quatre-vingts à cent quatre-vingts. N'envoyez ni coordonnées cartographiques projetées, ni texte en degrés, minutes et secondes, ni rayon en kilomètres sans conversion préalable. Par exemple, une zone de livraison de cinq kilomètres exige une valeur radius_m de 5000. Le vérificateur accepte zéro comme rayon utile ; seul un point ayant exactement les coordonnées du centre se trouve alors à l'intérieur. Il rejette les valeurs absentes, les nombres non finis, les coordonnées hors limites et les rayons négatifs au lieu de corriger silencieusement une probable erreur d'intégration. Les longitudes situées de part et d'autre de l'antiméridien fonctionnent sans traitement spécial côté client, car la formule trigonométrique prend naturellement la plus courte séparation sphérique.

Interprétez l'appartenance, la distance et la marge signée

La réponse comporte quatre champs concis. Le booléen inside vaut vrai lorsque la distance calculée est inférieure ou égale au rayon ; un point exactement sur la limite appartient donc au géofence. Le champ distance_m représente la distance orthodromique entre le centre et le point sur une sphère terrestre moyenne de rayon 6,371,000 mètres. radius_m rappelle le rayon validé, tandis que margin_m soustrait la distance au rayon. Cette marge signée est souvent plus informative qu'un simple booléen : 240 signifie que le point est à l'intérieur avec environ 240 mètres de réserve, zéro correspond au bord et moins 85 signifie qu'il se trouve environ 85 mètres à l'extérieur. Les distances renvoyées sont arrondies à six décimales pour garantir une sérialisation stable, mais la décision inside repose sur le calcul complet non arrondi. La valeur affichée après arrondi ne peut donc pas modifier la comparaison réelle. Pour des règles d'itinéraire ou de facturation, choisissez une zone tampon opérationnelle avant l'appel ou comparez la marge renvoyée à votre propre seuil de sécurité.

Exploitez le résultat prudemment dans un flux réel

Les contrôles circulaires conviennent à la détection d'arrivée, à l'éligibilité de livraison, aux alertes d'équipement proche et aux zones d'accès approximatives. Ils ne constituent pas des limites foncières légales et ne tiennent compte ni des routes, ni des murs, ni de l'altitude, ni des étages, ni de l'incertitude GPS. La position d'un téléphone peut varier de plusieurs mètres ; les applications en production demandent donc souvent des relevés répétés, une précision minimale ou une hystérésis avant toute action irréversible. Par exemple, un processus d'arrivée peut entrer seulement lorsque margin_m dépasse vingt mètres et sortir lorsqu'il descend sous moins vingt, ce qui évite les changements rapides près du bord. Le modèle sphérique de Haversine est cohérent et rapide partout, y compris près des pôles et de l'antiméridien, mais reste une approximation et non un calcul topographique ellipsoïdal. Des entrées identiques donnent toujours la même sortie, car le solveur n'utilise ni réseau, ni heure, ni hasard, ni base cartographique externe. L'exécution interactive est disponible dans le navigateur et chaque requête API automatisée coûte $0.002. Conservez les coordonnées originales avec le résultat si un audit ultérieur doit justifier la décision.