Rumbo loxodrómico

Las coordenadas fuera del rango de latitud válido de menos noventa a más noventa o del de longitud de menos ciento ochenta a más ciento ochenta producen un error invalid_input claro y nunca se cobran. La ruta es aritmética esférica determinista pura —sin red, sin semillas aleatorias, sin dependencia del reloj de pared— de modo que el ejecutor gratuito del navegador y la API prepago devuelven el mismo JSON tras un redondeo decimal fijo cada vez que la llama.

Qué es un rumbo loxodrómico y cómo se diferencia del gran círculo

Cuando origen y destino coinciden, el rumbo geométrico no está definido; esta API informa convencionalmente cero grados y lo declara en el campo message para que las pruebas automatizadas se mantengan deterministas.

Cómo llamar a la API y qué vuelve

También se rechazan las latitudes en los polos geográficos porque la fórmula de latitud isométrica no es finita allí. Envíe un cuerpo JSON con cuatro números finitos obligatorios: lat1 (alias start_lat, latitude1, from_lat), lon1 (alias start_lon, longitude1, from_lon, lng1), lat2 (alias end_lat, latitude2, to_lat) y lon2 (alias end_lon, longitude2, to_lon, lng2). La latitud debe estar en el intervalo cerrado de menos noventa a más noventa grados y la longitud en el de menos ciento ochenta a más ciento ochenta; cualquier valor fuera de esos rangos devuelve invalid_input con un mensaje explícito de fuera de su rango válido. Si tiene éxito, la respuesta repite lat1, lon1, lat2 y lon2 redondeados; fija bearing_deg al rumbo constante en grados de cero inclusive a trescientos sesenta exclusive; bearing_rad al mismo ángulo en radianes; compass a una etiqueta de dieciséis rumbos como N, NE o WSW; formula a la expresión atan2 y delta-psi; units para grados y radianes; message a un resumen breve en inglés; y steps a un array ordenado de líneas de sustitución que puede afirmar en pruebas. La validación fallida —campos ausentes, números no finitos, coordenadas fuera de rango o latitudes polares— devuelve invalid_input y nunca se cobra. El precio es un $0.002 fijo por petición correcta con unidad item y precio unitario marginal cero.

Consejos prácticos, límites y búsquedas relacionadas

Este aterrizaje apunta a quienes buscan una calculadora de rumbo loxodrómico, curso constante de loxodroma o rumbo de brújula constante entre dos coordenadas; no es una calculadora de distancia loxodrómica, ni una herramienta de destino desde rumbo, ni un solucionador geodésico elipsoidal. Prefiera esta capacidad cuando ya tiene dos puntos y solo necesita el rumbo constante; si su fuente es un plan de vuelo de gran círculo, convierta o remuestree con una herramienta ortodrómica en su lugar. Mantenga ambas latitudes estrictamente dentro de la banda polar abierta si planea tramos largos norte–sur cerca de altas latitudes; la API ya rechaza polos verdaderos, pero valores a pocos microgrados de noventa aún pueden estresar tan de pi sobre cuatro más phi sobre dos en punto flotante en otros sistemas. Prefiera enviar JSON numérico en lugar de cadenas preformateadas cuando controle el cliente; los números en cadena solo se aceptan si coinciden con un patrón numérico finito estricto. Al enseñar, combine ejemplos: un tramo clásico del área de Dover alrededor de cincuenta y uno punto uno dos siete norte, uno punto tres tres ocho este a cincuenta punto nueve seis cuatro norte, uno punto ocho cinco tres este produce un rumbo constante hacia el sureste; un tramo este puro a lo largo de un paralelo produce noventa grados; un tramo sur puro a lo largo de un meridiano produce ciento ochenta grados; y latitud noventa y uno o longitud doscientos demuestran la ruta dura de 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 deliberadamente longitudes fuera de rango. Las comprobaciones de ida y vuelta son fáciles: recompute delta-psi y atan2 a mano para un tramo corto este–oeste o norte–sur y confirme que bearing_deg coincide dentro del mismo redondeo a seis decimales, y confirme que intercambiar origen y destino rota el rumbo aproximadamente ciento ochenta grados en un segmento meridional simple.