Verifica geofence circolare

Calcola la distanza ortodromica con la formula di Haversine, la confronta con il raggio in metri e restituisce un margine con segno che mostra lo spazio residuo. Un margine positivo indica che il punto è interno, zero identifica il confine e un margine negativo comunica di quanto il punto è esterno. Il calcolo è deterministico e non richiede mappe, ricerche di dispositivi o richieste di rete.

Definisca con precisione punto, centro e raggio

Un geofence circolare comprende tre elementi essenziali: latitudine centrale, longitudine centrale e raggio non negativo misurato in metri. La latitudine e la longitudine distinte del punto identificano la posizione che Lei desidera verificare. Fornisca tutte le coordinate in gradi decimali rispettando i normali intervalli geografici WGS84: latitudine da meno novanta a novanta e longitudine da meno centottanta a centottanta. Non invii coordinate cartografiche proiettate, stringhe in gradi, minuti e secondi o un raggio in chilometri senza prima convertirlo. Per esempio, una zona di consegna con estensione di cinque chilometri richiede radius_m pari a 5000. Lo strumento accetta zero come raggio valido; in quel caso è interno soltanto un punto con coordinate identiche al centro. I valori mancanti, i numeri non finiti, le coordinate fuori dall'intervallo legale e i raggi negativi vengono rifiutati, anziché correggere silenziosamente un probabile errore d'integrazione. Le longitudini sui lati opposti dell'antimeridiano funzionano senza logica speciale nel client, perché la formula trigonometrica usa naturalmente la separazione sferica più breve.

Interpreti appartenenza, distanza e margine con segno

La risposta contiene quattro campi compatti. Il valore booleano inside è vero quando la distanza calcolata è minore o uguale al raggio; di conseguenza, un punto esattamente sul confine appartiene al geofence. Il campo distance_m rappresenta la distanza ortodromica fra centro e punto su una sfera terrestre media con raggio di 6,371,000 metri. radius_m ripete il raggio convalidato, mentre margin_m sottrae la distanza dal raggio. Il margine con segno è spesso più utile di un semplice booleano: 240 significa che il punto è interno con circa 240 metri disponibili, zero indica il bordo e meno 85 significa che è circa 85 metri all'esterno. Le distanze restituite vengono arrotondate a sei cifre decimali per una serializzazione stabile, ma la decisione inside utilizza il calcolo completo non arrotondato. Pertanto, un valore visualizzato dopo l'arrotondamento non cambia il confronto reale. Per regole di instradamento o fatturazione, scelga prima una tolleranza operativa oppure confronti il margine restituito con la propria soglia di sicurezza.

Usi il risultato in sicurezza nei flussi reali

Le verifiche circolari sono adatte al rilevamento degli arrivi, all'idoneità delle consegne, agli avvisi per apparecchiature vicine e a zone di accesso approssimative. Non rappresentano confini catastali e non considerano strade, muri, altitudine, piani degli edifici o incertezza del GPS. La posizione di un telefono può oscillare di diversi metri; perciò, le applicazioni in produzione richiedono spesso letture ripetute, un limite di precisione o isteresi prima di avviare un'azione irreversibile. Per esempio, un flusso di arrivo potrebbe entrare soltanto quando margin_m supera venti metri e uscire quando scende sotto meno venti, evitando rapidi cambiamenti vicino al bordo. Il modello sferico di Haversine è coerente e rapido in tutto il mondo, anche presso i poli e l'antimeridiano, ma è un'approssimazione e non un calcolo topografico ellissoidale. Gli stessi input restituiscono sempre lo stesso output, perché il risolutore non usa rete, ora corrente, casualità o database cartografici esterni. L'esecuzione interattiva è disponibile nel browser e ogni richiesta API automatizzata costa $0.002. Conservi le coordinate originali insieme al risultato qualora una verifica successiva debba motivare la decisione.