Calculadora de distância Vincenty

Esta capacidade recebe dois pares de latitude e longitude, executa a iteração clássica de Vincenty com semi-eixo maior e achatamento WGS-84 fixos, e devolve metros, quilômetros e rumos inicial e final como JSON determinístico.

O que a distância Vincenty mede e como fornecer os dois pontos

Envie os campos obrigatórios lat1 e lon1 para o primeiro ponto WGS-84 e lat2 e lon2 para o segundo, todos em graus decimais. Aliases como from_lat, to_lat, from_lon, to_lon, latitude1 e longitude1 são aceitos quando seu cliente já usa esses nomes. Qualquer coordenada fora desses intervalos lança invalid_input com uma mensagem que nomeia o campo e o limite, para que chamadores nunca recortem em silêncio ruído GPS ruim em uma geodésica falsa. Entradas idênticas sempre produzem o mesmo JSON porque o caminho é aritmética pura com constantes WGS-84 fixas, sem relógio de parede e sem serviço de mapa externo.

Lendo metros, quilômetros, rumos, iterações e convergência

Prefira metros para corredores de levantamento e trabalho em escala de pista; prefira quilômetros para trechos interurbanos e oceânicos. Em sucesso a resposta ecoa cada coordenada de entrada e então informa distance_m e distance_km como comprimento geodésico elipsoidal. initial_bearing_deg é o azimute direto no primeiro ponto medido no sentido horário a partir do norte verdadeiro no intervalo de zero a trezentos e sessenta; final_bearing_deg é o azimute inverso correspondente no segundo ponto após a chegada da geodésica. iterations conta quantas atualizações de longitude o solver precisou antes do resíduo cair abaixo do épsilon publicado, o que ajuda a diagnosticar pares limítrofes sem refazer o laço à mão. ellipsoid é sempre a string WGS-84, a_m é o semi-eixo maior em metros e f é o achatamento, para que o código a jusante possa afirmar o datum sem codificar constantes em cada cliente. method é sempre vincenty_inverse e converged é true em cada resposta bem-sucedida. Quando dois pontos são quase antípodas a iteração clássica pode nunca estabilizar; o motor para em um teto rígido de iterações e lança invalid_input com mensagem que nomeia a falha quase antípoda em vez de devolver uma distância pela metade. Falhas de validação por campos ausentes, números não finitos e coordenadas fora da faixa também falham fechadas e não são cobradas na API pré-paga.

Uso da API, preços, fluxos SIG e limites práticos

Envie um corpo JSON com as quatro coordenadas obrigatórias e use a calculadora gratuita de distância Vincenty no navegador para demos de sala, checagens de carta e verificação mental rápida sem instalar PROJ, GeographicLib ou um SIG completo. Use a API pré-paga quando uma plataforma logística, ferramenta de planejamento de voo, fluxo cadastral ou harness de simulação precisar de um contrato estável sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação e antípodas que não convergem nunca consomem saldo após a rejeição do motor. Combine este endpoint com seu próprio geocodificador quando precisar de nomes de lugar: este produto só mede geometria no elipsoide WGS-84. Para separações continentais ordinárias Vincenty é preciso a bem menos de um metro em relação a bibliotecas geodésicas modernas; para a faixa fina de casos quase antípodas em que a iteração de 1975 diverge, mude para um solver antípoda especializado ou uma geodésica estilo Karney em vez de forçar este endpoint. Autores de SDK podem mapear distance_m e initial_bearing_deg diretamente em cartões de rota e testes unitários — os mesmos números que os alunos veem ao trabalhar um exemplo de levantamento com pares lat-lon publicados.