Punkt-Radius-Bounding-Box

Geben Sie Dezimalgrad-Breite und -Länge des Zentrums plus einen nichtnegativen Radius in Metern ein; das Werkzeug liefert min_lat, max_lat, min_lon, max_lon, ein GeoJSON-artiges bbox-Array [west, south, east, north], den Winkelversatz der Breite und schrittweise Notizen zum sphärischen Mittel-Erde-Modell. Negative Radien werden mit invalid_input abgelehnt, damit Aufrufer nie ein invertiertes oder sinnloses Suchfenster ausliefern.

Was eine Punkt-Radius-Bounding-Box ist und wann Sie eine brauchen

Wenn die rohe West- oder Ostkante den Antimeridian kreuzt, werden Längen ins geschlossene Intervall von minus einhundertachtzig bis plus einhundertachtzig normalisiert und ein Flag markiert, dass min_lon nach dem Wrap größer als max_lon sein kann — der klassische Antimeridian-Fall, den Kartenbibliotheken bereits handhaben.

So rufen Sie die API auf und was zurückkommt

Absolute Breite und Länge außerhalb dieser geschlossenen Bereiche scheitern an der Validierung, bevor Trigonometrie läuft. Senden Sie einen JSON-Body mit drei Pflicht-endlichen Zahlen: lat (Aliase latitude und center_lat) in Grad von minus neunzig bis neunzig, lon (Aliase longitude, lng und center_lon) in Grad von minus einhundertachtzig bis einhundertachtzig, und radius (Aliase radius_m und r) in Metern, nichtnegativ und nicht größer als die halbe Erdumfangslänge. Bei Erfolg spiegelt die Antwort gerundetes lat, lon und radius_m; setzt earth_radius_m auf die Konstante 6371000; setzt delta_lat_deg auf die Breiten-Halbweite in Grad; setzt min_lat, max_lat, min_lon und max_lon der umschließenden Box; setzt bbox auf das Vierertupel min_lon, min_lat, max_lon, max_lat in West-Süd-Ost-Nord-Reihenfolge; setzt die Booleans full_longitude und crosses_antimeridian; setzt message auf eine kurze Zusammenfassung; und setzt steps auf ein geordnetes Array von Ableitungszeilen, die Sie in Logs oder UI zeigen können. Fehlgeschlagene Validierung — fehlende Felder, nichtendliche Zahlen, Breite oder Länge außerhalb, negativer Radius oder überhöhter Radius — liefert invalid_input und wird nie berechnet. Der Preis ist ein flat $0.002 pro erfolgreicher Anfrage mit Einheit item und marginalem Einheitspreis null.

Praktische Tipps, Grenzen und verwandte Suchen

Bevorzugen Sie Meter für den Radius, damit Clients Kilometer und Statute Miles nicht mischen; wandeln Sie Kilometer um, indem Sie vor dem Aufruf mit tausend multiplizieren. Halten Sie das Zentrum in veröffentlichten Breiten- und Längenbereichen; senden Sie keine Web-Mercator- oder projizierten Koordinaten. Denken Sie daran, dass eine achsenparallele Grad-Box ein Vorfilter ist: Punkte in den Ecken des Rechtecks können weiter als der Radius vom Zentrum liegen, verfeinern Sie also mit Haversine oder geodätischer Distanz, wenn Sie einen harten Kreisschnitt brauchen. Bevorzugen Sie diese Fähigkeit, wenn Sie bereits ein Zentrum und Meter haben und nur die rechteckige Hülle brauchen; ist Ihre Quelle ein Polygon oder Mehrpunkt-Satz, berechnen Sie stattdessen eine echte Multipunkt-bbox. Nahe den Polen erwarten Sie full_longitude true bei bescheidenen Radien, weil Längengrade auf null Meter schrumpfen. Für pazifikzentrierte Abfragen nahe dem Antimeridian prüfen Sie crosses_antimeridian und teilen Sie die Abfrage in zwei Längenintervalle, wenn Ihre Datenbank keinen umwickelten Bereich ausdrücken kann. Gepaarte Beispiele: New York bei etwa Breite 40.71 und Länge minus 74.01 mit einem Fünf-Kilometer-Radius für städtische Store-Suche; ein Nullradius-Aufruf, der min und max gleich dem Zentrum liefert; und ein absichtlich negativer Radius, der den harten invalid_input-Pfad zeigt. Diese Seite zielt auf Menschen, die nach Punkt-Radius-Bounding-Box, lat lon min max aus Radius oder Geofence-Hüllenrechner suchen; sie ist kein Großkreis-Distanzwerkzeug, kein Geohash-Encoder und kein Polygonpuffer. Fehlgeschlagene Aufgaben mit invalid_input verbrauchen kein Prepaid-Guthaben, was Erkundungsskripte billig hält, wenn Lernende absichtlich negative Radien senden. Hin- und Rückprüfungen sind einfach: bei mittleren Breiten berechnen Sie den Breiten-Delta als Radius über R mal einhundertachtzig über pi neu und bestätigen, dass min_lat und max_lat innerhalb der veröffentlichten Zwölf-Dezimal-Rundung übereinstimmen.