Riquadro punto-raggio

Inserisca latitudine e longitudine in gradi decimali del centro, più un raggio non negativo in metri; lo strumento restituisce min_lat, max_lat, min_lon, max_lon, un array bbox in stile GeoJSON [west, south, east, north], l’offset angolare di latitudine e note passo passo del modello sferico di raggio medio della Terra. I raggi negativi sono rifiutati con invalid_input così i chiamanti non inviano mai una finestra di ricerca invertita o senza senso. Il percorso è aritmetica deterministica pura — senza rete, senza semi casuali, senza dipendenza dall’orologio — così l’esecutore gratuito del browser e l’API prepagata restituiscono lo stesso JSON dopo l’arrotondamento decimale fisso ogni volta che la chiama.

Che cos’è un riquadro delimitante punto-raggio e quando le serve

Quando il bordo ovest o est grezzo attraversa l’antimeridiano, le longitudini sono normalizzate nell’intervallo chiuso da meno centoottanta a più centoottanta e un flag segna che min_lon può essere maggiore di max_lon dopo il wrap — il caso classico dell’antimeridiano che le librerie di mappe già gestiscono.

Come chiamare l’API e cosa torna indietro

Latitudine e longitudine assolute fuori da quegli intervalli chiusi falliscono la validazione prima di qualsiasi trig. Invii un corpo JSON con tre numeri finiti obbligatori: lat (alias latitude e center_lat) in gradi da meno novanta a novanta, lon (alias longitude, lng e center_lon) in gradi da meno centoottanta a centoottanta, e radius (alias radius_m e r) in metri, non negativo e non maggiore della metà della circonferenza terrestre. In caso di successo la risposta riecheggia lat, lon e radius_m arrotondati; imposta earth_radius_m alla costante 6371000; imposta delta_lat_deg alla semi-larghezza di latitudine in gradi; imposta min_lat, max_lat, min_lon e max_lon del riquadro avvolgente; imposta bbox alla quadrupla min_lon, min_lat, max_lon, max_lat in ordine ovest-sud-est-nord; imposta i booleani full_longitude e crosses_antimeridian; imposta message a un breve riepilogo; e imposta steps a un array ordinato di righe di derivazione che può mostrare in log o interfaccia. La validazione fallita — campi assenti, numeri non finiti, latitudine o longitudine fuori intervallo, raggio negativo o raggio eccessivo — restituisce invalid_input e non viene mai addebitata. Il prezzo è un flat $0.002 per richiesta riuscita con unità item e prezzo unitario marginale zero.

Suggerimenti pratici, limiti e ricerche correlate

Vicino ai poli si aspetti full_longitude true per raggi modesti perché i gradi di longitudine si riducono a zero metri. Per query centrate sul Pacifico vicino all’antimeridiano, controlli crosses_antimeridian e divida la query in due intervalli di longitudine quando il Suo database non può esprimere un intervallo avvolto. Esempi accoppiati: New York vicino a latitudine 40.71 e longitudine meno 74.01 con raggio di cinque chilometri per una ricerca negozi a scala urbana; una chiamata a raggio zero che restituisce min e max uguali al centro; e un raggio deliberatamente negativo che dimostra il percorso duro invalid_input. Le attività fallite che restituiscono invalid_input non consumano saldo prepagato, il che mantiene economici gli script esplorativi quando gli apprendisti inviano di proposito raggi negativi. I controlli andata e ritorno sono facili: a medie latitudini ricalcoli il delta di latitudine come raggio su R volte centoottanta su pi e confermi che min_lat e max_lat coincidono entro l’arrotondamento pubblicato a dodici decimali.