Calculadora de distância cross-track em rota de círculo máximo

Este recurso recebe a latitude e a longitude do ponto de consulta junto com as coordenadas de início e fim da rota sobre a esfera WGS84, aplica a fórmula esférica clássica com distância de haversine e rumos iniciais, e retorna metros e quilômetros com um rótulo claro de esquerda, direita ou sobre a rota. Latitudes ou longitudes fora do intervalo falham com invalid_input e não são cobradas.

O que significa a distância cross-track e como informar os três pontos

Imagine um círculo máximo traçado pelo início A e pelo fim B da rota sobre um modelo esférico da Terra. A partir de qualquer terceiro ponto P é possível baixar uma perpendicular ao longo de outro círculo máximo que encontra a linha de rumo em ângulo reto no sentido esférico. O comprimento dessa perpendicular, escalado pelo raio da esfera, é a distância cross-track. Se A e B coincidirem, a rota é indefinida e o motor rejeita a solicitação. A forma com sinal indica de que lado da rota dirigida você está: valores positivos significam à esquerda ao viajar de A para B, valores negativos à direita, e magnitudes próximas de zero são reportadas como on_track por estabilidade numérica. Envie os campos obrigatórios lat e lon para o ponto de consulta, start_lat e start_lon para A, e end_lat e end_lon para B, todos em graus decimais. Aliases como latitude, longitude, lat1, lon1, lat2 e lon2 são aceitos quando seu cliente já usa esses nomes. A latitude deve ficar entre menos noventa e noventa, inclusive; a longitude entre menos cento e oitenta e cento e oitenta, inclusive. Qualquer coordenada fora desses intervalos gera invalid_input com uma mensagem que indica o campo e o limite, de modo que as chamadas nunca truncam silenciosamente ruído de GPS inválido em um desvio falso. O campo opcional radius_m assume por padrão seis milhões trezentos e setenta e um mil metros, o raio médio da Terra usado em muitos exemplos de aviação; aumente-o ou reduza-o apenas quando modelar intencionalmente outra esfera. Entradas idênticas sempre produzem o mesmo JSON, pois o cálculo é aritmética pura, sem relógio de parede nem serviço externo de mapas.

Como ler os metros com sinal, os rótulos de lado, a distância ao longo da rota e os rumos

Prefira metros para corredores de drones e monitoramento em escala de pista; prefira quilômetros para rotas oceânicas ou aéreas de longo curso. Em caso de sucesso, a resposta repete cada coordenada e o raio utilizado e, em seguida, reporta cross_track_m e cross_track_km como o desvio perpendicular com sinal. absolute_m e absolute_km são a magnitude sem sinal, úteis para verificações de limiar em que só importa o quanto você se desviou. O campo side vale left, right ou on_track conforme a convenção de sinal positive_left_of_path_A_to_B documentada no payload. along_track_m mede o avanço a partir de A ao longo do círculo máximo infinito em direção a B e pode ser negativo ou maior que o comprimento do segmento quando P se projeta fora do arco finito A–B; use-o com path_length_m quando precisar de contexto lateral e longitudinal ao mesmo tempo. path_bearing_deg é o rumo inicial de A para B em graus a partir do norte, no sentido horário, no intervalo de zero a trezentos e sessenta, e angular_cross_track_deg reexpressa o desvio em graus angulares para testes unitários que comparam com tabelas de livros didáticos. method é sempre spherical_cross_track, para que o código posterior possa verificar o algoritmo sem inspecionar formatos. As falhas de validação nunca inventam uma distância: campos ausentes, números não finitos, coordenadas fora do intervalo e extremos coincidentes falham de forma fechada com invalid_input e não são cobrados na API pré-paga.

Uso da API, preços, fluxos de navegação e limites práticos

O modelo é esférico, não elipsoidal; portanto, para levantamentos com precisão submétrica você deve aplicar uma biblioteca geodésica local ENU ou completa; para corredores de navegação, lições e alertas de frota, a esfera de Terra média corresponde às fórmulas publicadas nas referências padrão de pilotos e marinheiros. Envie um corpo JSON com as seis coordenadas obrigatórias e o radius_m opcional; use a calculadora de distância cross-track gratuita no navegador para demonstrações em sala de aula, trabalho de carta náutica e verificações rápidas sem instalar uma biblioteca geoespacial. Use a API pré-paga quando um painel de operações de voo, um sistema de tráfego de embarcações, um roteador de entregas de última milha ou um harness de simulação precisar de um contrato estável com saldo KIT a US$ 0,002 por item bem-sucedido; as falhas de validação nunca consomem saldo depois que o motor rejeita a solicitação. Combine este endpoint com seu próprio geocodificador ou feed AIS quando precisar de nomes de lugares ou rotas ao vivo: este produto mede apenas geometria sobre a esfera. Autores que distribuem SDKs podem mapear cross_track_m e side diretamente em regras de alerta: dispare quando absolute_m exceder a metade da largura do corredor e pinte o mapa de verde, âmbar ou vermelho com os mesmos campos que os estudantes veem ao resolver o triângulo esférico à mão.