Verificar geocerca circular

Ele calcula a distância de grande círculo pela fórmula de Haversine, compara essa distância com o raio em metros e retorna uma margem com sinal que mostra o espaço restante. Uma margem positiva indica que o ponto está dentro, zero marca a borda e uma margem negativa informa quanto ele está fora. O cálculo é determinístico e não precisa de mapas, consulta de dispositivo nem solicitação de rede.

Defina claramente o ponto, o centro e o raio

Não envie coordenadas projetadas, textos em graus, minutos e segundos, nem um raio em quilômetros sem convertê-lo antes. O verificador aceita zero como raio útil; nesse caso, somente um ponto exatamente nas mesmas coordenadas do centro fica dentro. Valores ausentes, números não finitos, coordenadas fora dos intervalos legais e raios negativos são rejeitados, em vez de uma provável falha de integração ser corrigida silenciosamente.

Longitudes em lados opostos do antimeridiano funcionam sem lógica especial do cliente, pois a fórmula trigonométrica usa naturalmente a menor separação esférica.

Interprete a inclusão, a distância e a margem com sinal

A resposta contém quatro campos compactos. Essa margem com sinal costuma ser mais útil que apenas um booleano: 240 significa que o ponto está dentro com cerca de 240 metros disponíveis; zero indica a borda; e menos 85 significa que está aproximadamente 85 metros fora. As distâncias de saída são arredondadas para seis casas decimais, garantindo serialização estável, mas a decisão inside usa o cálculo completo sem arredondamento.

Assim, um valor exibido após arredondamento não muda a comparação real. Para políticas de rota ou cobrança, escolha antecipadamente uma folga operacional ou compare a margem retornada com seu próprio limite de segurança.

Use o resultado com segurança em operações reais

Verificações circulares são adequadas para detectar chegadas, decidir elegibilidade de entrega, emitir alertas sobre equipamentos próximos e definir zonas aproximadas de acesso. Elas não representam divisas legais e não consideram estradas, paredes, altitude, andares de edifícios ou incerteza do GPS. A localização de um telefone pode oscilar vários metros; por isso, aplicações em produção normalmente exigem leituras repetidas, um limite de precisão ou histerese antes de iniciar uma ação irreversível.

O modelo esférico de Haversine é consistente e rápido no mundo inteiro, inclusive perto dos polos e do antimeridiano, mas continua sendo uma aproximação, não um cálculo topográfico elipsoidal. Entradas iguais sempre produzem a mesma saída, pois o solucionador não usa rede, horário atual, aleatoriedade nem banco externo de mapas. Guarde as coordenadas originais com o resultado quando auditorias futuras precisarem explicar a decisão.