Kreisförmigen Geofence prüfen

Er berechnet mit der Haversine-Formel die Großkreisentfernung, vergleicht sie mit dem Radius in Metern und gibt eine vorzeichenbehaftete Randdistanz für den verbleibenden Spielraum zurück. Ein positiver Wert bedeutet innen, null kennzeichnet die Grenze und ein negativer Wert zeigt die Entfernung außerhalb. Die Berechnung ist deterministisch und benötigt weder Kartendienst noch Geräteabfrage oder Netzwerkzugriff.

Legen Sie Punkt, Mittelpunkt und Radius eindeutig fest

Ein kreisförmiger Geofence besteht aus drei wesentlichen Angaben: dem Breitengrad des Mittelpunkts, dessen Längengrad und einem nicht negativen Radius in Metern. Die getrennten Breiten- und Längengrade des Punkts bestimmen den Ort, den Sie prüfen möchten. Geben Sie sämtliche Koordinaten als Dezimalgrad in den üblichen geografischen WGS84-Bereichen an: Breitengrad von minus neunzig bis neunzig und Längengrad von minus einhundertachtzig bis einhundertachtzig. Senden Sie keine projizierten Kartenkoordinaten, keine Zeichenfolgen aus Grad, Minuten und Sekunden und keinen Kilometerwert ohne vorherige Umrechnung. Ein Liefergebiet mit fünf Kilometern Reichweite benötigt beispielsweise radius_m mit dem Wert 5000. Null ist ein gültiger Radius; dann liegt nur ein Punkt mit exakt denselben Koordinaten wie der Mittelpunkt innen. Fehlende Werte, nicht endliche Zahlen, Koordinaten außerhalb des zulässigen Bereichs und negative Radien werden abgelehnt, statt einen wahrscheinlichen Integrationsfehler stillschweigend zu verändern. Längengrade auf gegenüberliegenden Seiten des Antimeridians funktionieren ohne besondere Clientlogik, weil die trigonometrische Formel von selbst die kürzeste sphärische Trennung verwendet.

Deuten Sie Zugehörigkeit, Entfernung und Randdistanz

Die Antwort umfasst vier kompakte Felder. Der boolesche Wert inside ist wahr, wenn die berechnete Entfernung kleiner oder gleich dem Radius ist; damit gehört ein Punkt genau auf der Grenze zum Geofence. distance_m enthält die Großkreisentfernung zwischen Mittelpunkt und Punkt auf einer mittleren Erdkugel mit einem Radius von 6,371,000 Metern. radius_m wiederholt den geprüften Radius, während margin_m die Entfernung vom Radius abzieht. Diese vorzeichenbehaftete Randdistanz ist häufig hilfreicher als ein boolescher Wert allein: 240 bedeutet innen mit ungefähr 240 Metern Spielraum, null bedeutet genau am Rand und minus 85 ungefähr 85 Meter außerhalb. Die ausgegebenen Entfernungen werden für eine stabile Serialisierung auf sechs Nachkommastellen gerundet; die Entscheidung inside verwendet jedoch die vollständige ungerundete Berechnung. Ein gerundeter Anzeigewert kann den tatsächlichen Vergleich daher nicht verändern. Bestimmen Sie für Routen- oder Abrechnungsregeln schon vor dem Aufruf einen betrieblichen Puffer oder vergleichen Sie die zurückgegebene Randdistanz mit Ihrem eigenen Sicherheitsschwellenwert.

Nutzen Sie das Ergebnis sicher in realen Abläufen

Kreisprüfungen eignen sich für Ankunftserkennung, Lieferberechtigung, Warnungen zu nahen Geräten und grobe Zugangszonen. Sie bilden keine rechtsverbindlichen Grundstücksgrenzen ab und berücksichtigen weder Straßen noch Wände, Höhe, Stockwerke oder GPS-Ungenauigkeit. Ein Mobiltelefon kann um mehrere Meter springen; Produktionsanwendungen verlangen deshalb häufig wiederholte Messungen, eine Genauigkeitsgrenze oder Hysterese, bevor sie eine unumkehrbare Aktion auslösen. Ein Ankunftsablauf könnte beispielsweise erst eintreten, wenn margin_m zwanzig Meter überschreitet, und erst austreten, wenn der Wert unter minus zwanzig fällt. So werden schnelle Zustandswechsel am Rand vermieden. Das sphärische Haversine-Modell arbeitet weltweit einheitlich und schnell, auch nahe den Polen und am Antimeridian, ist aber eine Näherung und keine ellipsoidische Vermessung. Gleiche Eingaben liefern immer gleiche Ergebnisse, weil der Löser weder Netzwerk noch aktuelle Zeit, Zufall oder externe Kartendaten verwendet. Interaktive Prüfungen laufen im Browser; automatisierte API-Anfragen kosten jeweils $0.002. Bewahren Sie die ursprünglichen Koordinaten mit dem Ergebnis auf, wenn eine spätere Prüfung die Entscheidung nachvollziehen muss.