Boîte englobante point-rayon

Un calculateur de boîte englobante point-rayon transforme un centre géographique et une distance en le plus petit rectangle aligné sur les axes en latitude et longitude qui enferme entièrement la zone de recherche circulaire. Saisissez la latitude et la longitude en degrés décimaux du centre, plus un rayon non négatif en mètres ; l’outil renvoie min_lat, max_lat, min_lon, max_lon, un tableau bbox de style GeoJSON [west, south, east, north], le décalage angulaire de latitude et des notes pas à pas du modèle sphérique de rayon moyen de la Terre. Les rayons négatifs sont rejetés avec invalid_input pour que les appelants n’envoient jamais une fenêtre de recherche inversée ou sans sens. Le chemin est de l’arithmétique déterministe pure — pas de réseau, pas de graines aléatoires, pas de dépendance à l’horloge — de sorte que l’exécuteur gratuit du navigateur et l’API prépayée renvoient le même JSON après l’arrondi décimal fixe à chaque appel.

Ce qu’est une boîte englobante point-rayon et quand vous en avez besoin

Près des pôles le cosinus diminue et les portées de longitude s’élargissent ; si le cercle atteint un pôle ou si la demi-largeur de longitude atteint ou dépasse cent quatre-vingts degrés, cet outil signale une portée de longitude complète de moins cent quatre-vingts à plus cent quatre-vingts pour que la boîte ne sous-couvre jamais le cercle. Les enseignants, étudiants GIS et ingénieurs backend tiennent à ce qu’un rayon négatif soit une erreur dure : une distance signée n’est pas un rayon de recherche, et prendre silencieusement la valeur absolue masquerait des bogues client. Le rayon zéro est autorisé et produit une boîte dégénérée égale au centre, utile pour les tests unitaires et les appelants qui bornent des buffers vides. Une boîte englobante géographique est le rectangle défini par une latitude sud, une latitude nord, une longitude ouest et une longitude est. Lorsque la seule spécification dont vous disposez est un point centre et un rayon — rayon de localisateur de magasins, portée de livraison, recherche d’événements ou buffer de collier de faune — vous avez encore besoin de ce rectangle pour les systèmes qui indexent ou interrogent par plages de latitude et de longitude plutôt que par distance circulaire. La conversion utilise une Terre sphérique de rayon moyen 6,371,000 mètres : le rayon angulaire est le rayon physique divisé par cette constante ; la demi-largeur de latitude est cet angle en degrés ; la demi-largeur de longitude est le même angle divisé par le cosinus de la latitude du centre pour que les mètres restent approximativement égaux en étendue est-ouest. Lorsque le bord ouest ou est brut croise l’antiméridien, les longitudes sont normalisées dans l’intervalle fermé de moins cent quatre-vingts à plus cent quatre-vingts et un drapeau marque que min_lon peut être supérieur à max_lon après enroulement — le cas classique de l’antiméridien que les bibliothèques de cartes gèrent déjà.

Comment appeler l’API et ce qui revient

Les latitudes et longitudes absolues hors de ces plages fermées échouent à la validation avant toute trigonométrie. Envoyez un corps JSON avec trois nombres finis obligatoires : lat (alias latitude et center_lat) en degrés de moins quatre-vingt-dix à quatre-vingt-dix, lon (alias longitude, lng et center_lon) en degrés de moins cent quatre-vingts à cent quatre-vingts, et radius (alias radius_m et r) en mètres, non négatif et pas plus grand que la moitié de la circonférence terrestre. En succès la réponse renvoie lat, lon et radius_m arrondis ; fixe earth_radius_m à la constante 6371000 ; fixe delta_lat_deg à la demi-largeur de latitude en degrés ; fixe min_lat, max_lat, min_lon et max_lon de la boîte englobante ; fixe bbox au quadruplet min_lon, min_lat, max_lon, max_lat dans l’ordre ouest-sud-est-nord ; fixe les booléens full_longitude et crosses_antimeridian ; fixe message à un court résumé ; et fixe steps à un tableau ordonné de lignes de dérivation que vous pouvez montrer dans les journaux ou l’interface. L’échec de validation — champs manquants, nombres non finis, latitude ou longitude hors plage, rayon négatif ou rayon excessif — renvoie invalid_input et n’est jamais facturé. Le tarif est un flat $0.002 par requête réussie avec unité item et prix unitaire marginal zéro.

Conseils pratiques, limites et recherches connexes

Préférez les mètres pour le rayon afin que les clients ne mélangent pas kilomètres et miles statutaires ; convertissez les kilomètres en multipliant par mille avant l’appel. Souvenez-vous qu’une boîte de degrés alignée sur les axes est un préfiltre : les points aux coins du rectangle peuvent être plus loin que le rayon du centre, affinez donc avec haversine ou distance géodésique si vous avez besoin d’une coupe circulaire dure. Cette page cible ceux qui cherchent une boîte englobante point rayon, min max lat lon depuis un rayon ou un calculateur d’enveloppe de géorepère ; ce n’est pas un outil de distance de grand cercle, ni un encodeur geohash, ni un buffer de polygone. Préférez cette capacité lorsque vous avez déjà un centre et des mètres et n’avez besoin que de l’enveloppe rectangulaire ; si votre source est un polygone ou un ensemble multipoint, calculez plutôt une vraie bbox multipoint. Gardez le centre dans les plages publiées de latitude et de longitude ; n’envoyez pas de coordonnées web-mercator ou projetées. Près des pôles attendez full_longitude vrai pour des rayons modestes car les degrés de longitude se réduisent à zéro mètre. Pour les requêtes centrées sur le Pacifique près de l’antiméridien, vérifiez crosses_antimeridian et divisez la requête en deux intervalles de longitude lorsque votre base de données ne peut pas exprimer une plage enroulée. Exemples appariés : New York près de la latitude 40.71 et de la longitude moins 74.01 avec un rayon de cinq kilomètres pour une recherche de magasins à l’échelle urbaine ; un appel de rayon zéro qui renvoie min et max égaux au centre ; et un rayon délibérément négatif qui démontre le chemin dur invalid_input. Les tâches échouées qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui garde les scripts exploratoires bon marché lorsque les apprenants envoient délibérément des rayons négatifs. Les contrôles aller-retour sont faciles : aux latitudes moyennes recalculez le delta de latitude comme rayon sur R fois cent quatre-vingts sur pi et confirmez que min_lat et max_lat correspondent dans l’arrondi publié à douze décimales.