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

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. 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. 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.

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. Conservez les coordonnées originales avec le résultat si un audit ultérieur doit justifier la décision.