Comprobar geovalla circular

Calcula la distancia de círculo máximo mediante la fórmula de Haversine, la compara con el radio en metros y devuelve un margen con signo que indica el espacio restante. Un margen positivo señala que el punto está dentro; cero identifica el límite; y un margen negativo muestra cuánto queda fuera. El cálculo es determinista y no necesita mapas, localización de dispositivos ni solicitudes de red.

Defina con claridad el punto, el centro y el radio

Una geovalla circular tiene tres elementos esenciales: latitud central, longitud central y un radio no negativo medido en metros. La latitud y longitud separadas del punto identifican la ubicación que usted desea comprobar. Introduzca todas las coordenadas en grados decimales con los intervalos geográficos WGS84 habituales: latitud de menos noventa a noventa y longitud de menos ciento ochenta a ciento ochenta. No envíe coordenadas proyectadas, cadenas en grados, minutos y segundos, ni un radio en kilómetros sin convertirlo antes. Por ejemplo, una zona de reparto de cinco kilómetros requiere radius_m con valor 5000. El comprobador admite cero como radio útil; en ese caso, solo un punto con exactamente las mismas coordenadas que el centro está dentro. Rechaza valores ausentes, números no finitos, coordenadas fuera de sus intervalos legales y radios negativos, en vez de corregir silenciosamente un probable error de integración. Las longitudes a ambos lados del antimeridiano funcionan sin lógica especial del cliente, porque la fórmula trigonométrica utiliza naturalmente la separación esférica más corta.

Interprete la pertenencia, la distancia y el margen con signo

La respuesta contiene cuatro campos compactos. El booleano inside es verdadero cuando la distancia calculada es menor o igual que el radio, por lo que un punto situado exactamente en el límite pertenece a la geovalla. El campo distance_m expresa la distancia de círculo máximo entre el centro y el punto sobre una esfera terrestre media de radio 6,371,000 metros. radius_m repite el radio validado, mientras que margin_m resta la distancia al radio. Este margen con signo suele aportar más información que un booleano: 240 significa que el punto está dentro y conserva unos 240 metros; cero indica el borde; y menos 85 significa que está aproximadamente 85 metros fuera. Las distancias de salida se redondean a seis decimales para lograr una serialización estable, pero la decisión inside usa el cálculo completo sin redondear. Así, un valor mostrado tras el redondeo no altera la comparación real. Para políticas de rutas o facturación, determine previamente un margen operativo o compare el margen devuelto con su propio umbral de seguridad.

Use el resultado con seguridad en flujos reales

Las comprobaciones circulares son prácticas para detectar llegadas, decidir cobertura de reparto, alertar sobre equipos cercanos y delimitar zonas de acceso aproximadas. No representan linderos legales ni consideran carreteras, paredes, elevación, plantas de edificios o incertidumbre GPS. La ubicación de un teléfono puede variar varios metros, por lo que las aplicaciones de producción suelen exigir lecturas repetidas, un límite de precisión o histéresis antes de activar una acción irreversible. Por ejemplo, un flujo de llegada podría entrar solo cuando margin_m supere veinte metros y salir cuando baje de menos veinte, evitando cambios rápidos cerca del borde. El modelo esférico de Haversine es uniforme y rápido en todo el planeta, incluso junto a los polos y el antimeridiano, pero es una aproximación y no un cálculo topográfico elipsoidal. Las mismas entradas producen siempre la misma salida porque el solucionador no usa red, hora actual, aleatoriedad ni mapas externos. La ejecución interactiva está disponible en el navegador y cada solicitud API automatizada cuesta $0.002. Conserve las coordenadas originales junto al resultado si una auditoría posterior debe explicar la decisión.