Caja delimitadora punto-radio
Un radio de 5000 m alrededor de 40,7128, −74,006 se convierte en la latitud y la longitud mínimas y máximas de una caja que encierra todo el círculo, lista para un filtro por rangos antes de comprobar la distancia exacta. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Latitud
- 40,7128
- Longitud
- -74,006
- Radio
- 5 000
- Radio m
- 5 000
- Radio terrestre m
- 6 371 000
- Delta lat (°)
- 0,0449660803
- Lat. mín.
- 40,6678339197
Una calculadora de caja delimitadora punto-radio convierte un centro geográfico y una distancia en el rectángulo más pequeño alineado a los ejes en latitud y longitud que encierra por completo el área de búsqueda circular. Las teselas de mapa, las consultas Overpass, los prefiltros espaciales de bases de datos y las vistas previas de geovalla móvil necesitan ese mismo envoltorio mín/máx antes de refinar con una comprobación real de distancia de círculo máximo.
Qué es una caja delimitadora punto-radio y cuándo la necesita
Una caja delimitadora geográfica es el rectángulo definido por una latitud sur, una latitud norte, una longitud oeste y una longitud este. Cuando la única especificación que tiene es un punto centro y un radio —radio de localizador de tiendas, rango de entrega, búsqueda de eventos o buffer de collar de fauna— sigue necesitando ese rectángulo para sistemas que indexan o consultan por rangos de latitud y longitud en lugar de por distancia circular.
La conversión usa una Tierra esférica de radio medio 6,371,000 metros: el radio angular es el radio físico dividido por esa constante; la semi-anchura de latitud es ese ángulo en grados; la semi-anchura de longitud es el mismo ángulo dividido por el coseno de la latitud del centro para que los metros se mantengan aproximadamente iguales en extensión este-oeste.
Cerca de los polos el coseno se reduce y los tramos de longitud se amplían; si el círculo alcanza un polo o la semi-anchura de longitud alcanza o supera ciento ochenta grados, esta herramienta informa un tramo de longitud completo de menos ciento ochenta a más ciento ochenta para que la caja nunca subcubra el círculo.
A docentes, estudiantes de GIS e ingenieros de backend les importa que un radio negativo sea un error duro: una distancia con signo no es un radio de búsqueda, y tomar el valor absoluto en silencio ocultaría fallos del cliente.
Consejos prácticos, límites y búsquedas relacionadas
Prefiera metros para el radio para que los clientes no mezclen kilómetros y millas estatutarias; convierta kilómetros multiplicando por mil antes de la llamada. Mantenga el centro dentro de los rangos publicados de latitud y longitud; no envíe coordenadas web-mercator o proyectadas. Recuerde que una caja de grados alineada a los ejes es un prefiltro: los puntos en las esquinas del rectángulo pueden estar más lejos que el radio del centro, así que refine con haversine o distancia geodésica si necesita un corte circular duro.
Esta página se dirige a quien busca caja delimitadora punto radio, min max lat lon desde radio o calculadora de envoltorio de geovalla; no es una herramienta de distancia de círculo máximo, ni un codificador geohash, ni un buffer de polígono. Prefiera esta capacidad cuando ya tiene un centro y metros y solo necesita el envoltorio rectangular; si su fuente es un polígono o un conjunto multipunto, calcule un bbox multipunto verdadero en su lugar.
Qué puede hacer con ella
Prefiltros de localizador de tiendas y radio de entrega
Convierta el centro de una tienda y el radio de entrega en metros en mín/máx lat/lon para cláusulas SQL BETWEEN, luego refine con una comprobación real de distancia en la lista corta.
Ventana de vista de mapa y precarga de teselas
Dado un pin y una distancia de buffer, calcule la caja delimitadora usada para pedir teselas de mapa, marcadores o elementos Overpass sin subcubrir el círculo.
Preguntas frecuentes
¿En qué unidades está el radio?
En metros. Convierta kilómetros multiplicando por 1000 (por ejemplo 5 km → 5000).
¿La caja delimitadora es lo mismo que el círculo?
No. La caja encierra por completo el círculo en un modelo esférico de la Tierra; los puntos de las esquinas del rectángulo pueden quedar fuera del radio. Use la caja como prefiltro y luego aplique una prueba de distancia si necesita un corte circular duro.
¿Qué modelo de la Tierra se usa?
Es el valor por defecto habitual en GIS para envoltorios rápidos; no es un buffer geodésico completo del elipsoide WGS84.
¿Es gratuita la calculadora de caja delimitadora punto-radio?
La herramienta del navegador es gratuita y se ejecuta en local.
¿Por qué la caja se ensancha tanto cerca de los polos?
Porque los meridianos convergen. La mitad del ancho este-oeste es la mitad del alto en latitud dividida por el coseno de la latitud central, así que crece hacia los polos. Si el círculo alcanza un polo, la caja abarca todas las longitudes, de −180 a 180.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/geo/bounding-box \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"lat":40.7128,"lon":-74.006,"radius":5000}'const res = await fetch("https://api.kit.forhosting.com/geo/bounding-box", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"lat": 40.7128,
"lon": -74.006,
"radius": 5000
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/bounding-box",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"lat": 40.7128,
"lon": -74.006,
"radius": 5000
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/bounding-box", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"lat":40.7128,"lon":-74.006,"radius":5000}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"lat":40.7128,"lon":-74.006,"radius":5000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/bounding-box", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"lat": 40.7128,
"lon": -74.006,
"radius": 5000
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.bounding_box",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
min_lat | -90 |
max_lat | 90 |
min_lon | -180 |
max_lon | 180 |
max_radius_m | 20037508.342789244 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Introduzca latitud y longitud en grados decimales del centro, más un radio no negativo en metros; la herramienta devuelve min_lat, max_lat, min_lon, max_lon, un array bbox al estilo GeoJSON [west, south, east, north], el desplazamiento angular de latitud y notas paso a paso del modelo esférico de radio medio de la Tierra. Los radios negativos se rechazan con invalid_input para que los llamadores no envíen una ventana de búsqueda invertida o sin sentido. El camino es aritmética determinista pura —sin red, sin semillas aleatorias, sin dependencia del reloj— de modo que el ejecutor gratuito del navegador y la API prepago devuelven el mismo JSON tras el redondeo decimal fijo cada vez que la llama.
Qué es una caja delimitadora punto-radio y cuándo la necesita
Cuando el borde oeste o este crudo cruza el antimeridiano, las longitudes se normalizan al intervalo cerrado de menos ciento ochenta a más ciento ochenta y una bandera marca que min_lon puede ser mayor que max_lon tras el envoltorio —el caso clásico del antimeridiano que las bibliotecas de mapas ya manejan.
Cómo llamar a la API y qué devuelve
La latitud y longitud absolutas fuera de esos rangos cerrados fallan la validación antes de cualquier trigonometría. Envíe un cuerpo JSON con tres números finitos obligatorios: lat (alias latitude y center_lat) en grados de menos noventa a noventa, lon (alias longitude, lng y center_lon) en grados de menos ciento ochenta a ciento ochenta, y radius (alias radius_m y r) en metros, no negativo y no mayor que la mitad de la circunferencia terrestre. En éxito la respuesta repite lat, lon y radius_m redondeados; fija earth_radius_m en la constante 6371000; fija delta_lat_deg en la semi-anchura de latitud en grados; fija min_lat, max_lat, min_lon y max_lon de la caja envolvente; fija bbox en la cuádrupla min_lon, min_lat, max_lon, max_lat en orden oeste-sur-este-norte; fija los booleanos full_longitude y crosses_antimeridian; fija message en un resumen corto; y fija steps en un array ordenado de líneas de derivación que puede mostrar en registros o IU. La validación fallida —campos ausentes, números no finitos, latitud o longitud fuera de rango, radio negativo o radio excesivo— devuelve invalid_input y nunca se cobra. El precio es un flat $0.002 por petición exitosa con unidad item y precio unitario marginal cero.
Consejos prácticos, límites y búsquedas relacionadas
Cerca de los polos espere full_longitude en true para radios modestos porque los grados de longitud se reducen a cero metros. Para consultas centradas en el Pacífico cerca del antimeridiano, compruebe crosses_antimeridian y divida la consulta en dos intervalos de longitud cuando su base de datos no pueda expresar un rango envuelto. Ejemplos emparejados: Nueva York cerca de latitud 40.71 y longitud menos 74.01 con un radio de cinco kilómetros para una búsqueda de tiendas a escala urbana; una llamada de radio cero que devuelve min y max iguales al centro; y un radio deliberadamente negativo que demuestra la vía dura invalid_input. Las tareas fallidas que devuelven invalid_input no consumen saldo prepago, lo que mantiene baratos los scripts exploratorios cuando los aprendices envían radios negativos a propósito. Las comprobaciones de ida y vuelta son fáciles: en latitudes medias recalcule el delta de latitud como radio sobre R por ciento ochenta sobre pi y confirme que min_lat y max_lat coinciden dentro del redondeo publicado a doce decimales.
Casos de integración
Pruebas unitarias para geovallas y API espaciales
Genere casos deterministas positivos, de radio cero, polares y de radio negativo para fixtures golden en código de geovalla móvil y de backend.
Preguntas técnicas
¿Qué ocurre cerca de los polos o del antimeridiano?
Si el círculo alcanza un polo o la semi-anchura de longitud es al menos 180°, full_longitude es true y las longitudes abarcan −180 a 180. Si la caja envuelve el antimeridiano, crosses_antimeridian es true y min_lon puede ser mayor que max_lon tras la normalización.