Calculadora de distancia cross-track a una ruta de círculo máximo

Las latitudes o longitudes fuera de rango fallan con invalid_input y no se cobran.

Qué significa la distancia transversal y cómo proporcionar los tres puntos

Imagine un círculo máximo trazado por el inicio A y el fin B de la ruta sobre un modelo esférico de la Tierra. Desde cualquier tercer punto P puede trazar una perpendicular a lo largo de otro círculo máximo que corta la línea de rumbo en ángulo recto en sentido esférico. La longitud de esa perpendicular, escalada por el radio de la esfera, es la distancia transversal. La latitud debe estar entre menos noventa y noventa inclusive; la longitud entre menos ciento ochenta y ciento ochenta inclusive. Si A y B coinciden, la ruta no está definida y el motor rechaza la solicitud. La forma con signo indica de qué lado de la ruta dirigida se encuentra: los valores positivos significan a la izquierda al viajar de A hacia B, los negativos a la derecha, y las magnitudes cercanas a cero se reportan como on_track por estabilidad numérica. Envíe los campos obligatorios lat y lon para el punto de consulta, start_lat y start_lon para A, y end_lat y end_lon para B, todos en grados decimales. Se aceptan alias como latitude, longitude, lat1, lon1, lat2 y lon2 cuando su cliente ya usa esos nombres. Cualquier coordenada fuera de esos rangos genera invalid_input con un mensaje que nombra el campo y el límite, de modo que las llamadas nunca recortan en silencio ruido GPS defectuoso convirtiéndolo en una desviación falsa. El campo opcional radius_m toma por defecto seis millones trescientos setenta y un mil metros, el radio medio terrestre usado en muchos ejemplos de aviación; súbalo o bájelo solo cuando modele intencionadamente otra esfera. Entradas idénticas siempre producen un JSON idéntico porque el cálculo es aritmética pura, sin reloj de pared ni servicio cartográfico externo.

Cómo leer los metros con signo, las etiquetas de lado, la distancia a lo largo de la ruta y los rumbos

Prefiera metros para corredores de drones y vigilancia a escala de pista; prefiera kilómetros para rutas oceánicas o aéreas de largo recorrido. En caso de éxito, la respuesta repite cada coordenada y el radio usado, y luego reporta cross_track_m y cross_track_km como la desviación perpendicular con signo. absolute_m y absolute_km son la magnitud sin signo, útiles para comprobaciones de umbral en las que solo importa cuánto se desvió. Los fallos de validación nunca inventan una distancia: campos ausentes, números no finitos, coordenadas fuera de rango y extremos coincidentes fallan en cerrado con invalid_input y no se cobran en la API prepagada.

Uso de la API, precios, flujos de navegación y límites prácticos

El modelo es esférico, no elipsoidal, así que para trabajos topográficos de precisión submétrica debería aplicar una biblioteca geodésica local ENU o completa; para corredores de navegación, tareas y alertas de flota, la esfera de Tierra media coincide con las fórmulas publicadas en los manuales estándar de pilotos y marinos. Envíe un cuerpo JSON con las seis coordenadas obligatorias y el radius_m opcional; use la calculadora de distancia transversal gratuita en el navegador para demostraciones en clase, trabajo de carta y comprobaciones rápidas sin instalar una biblioteca geoespacial. Use la API prepagada cuando un panel de operaciones de vuelo, un sistema de tráfico marítimo, un enrutador de reparto de última milla o un harness de simulación necesite un contrato estable con saldo KIT a $0.002 por elemento correcto; los fallos de validación nunca consumen saldo después de que el motor rechace la solicitud. Combine este endpoint con su propio geocodificador o fuente AIS cuando necesite nombres de lugares o rutas en vivo: este producto solo mide geometría sobre la esfera. Los autores que publican SDKs pueden mapear cross_track_m y side directamente en reglas de alerta: disparar cuando absolute_m supere el semiancho del corredor y colorear el mapa en verde, ámbar o rojo con los mismos campos que ven los estudiantes al resolver el triángulo esférico a mano.