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

Uma geocerca circular possui três partes essenciais: latitude central, longitude central e raio não negativo medido em metros. A latitude e a longitude separadas do ponto identificam o local que você deseja verificar. Informe todas as coordenadas em graus decimais nos intervalos geográficos WGS84 usuais: latitude de menos noventa a noventa e longitude de menos cento e oitenta a cento e oitenta. Não envie coordenadas projetadas, textos em graus, minutos e segundos, nem um raio em quilômetros sem convertê-lo antes. Por exemplo, uma área de entrega com alcance de cinco quilômetros exige radius_m igual a 5000. 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. O booleano inside é verdadeiro quando a distância calculada é menor ou igual ao raio; portanto, um ponto exatamente na borda pertence à geocerca. distance_m é a distância de grande círculo entre o centro e o ponto sobre uma esfera terrestre média de raio 6,371,000 metros. radius_m repete o raio validado, enquanto margin_m subtrai a distância do raio. 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. Por exemplo, um fluxo de chegada pode entrar apenas quando margin_m passar de vinte metros e sair quando cair abaixo de menos vinte, evitando mudanças rápidas perto da borda. 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. A execução interativa está disponível no navegador, e solicitações API automatizadas custam US$ 0,002 cada. Guarde as coordenadas originais com o resultado quando auditorias futuras precisarem explicar a decisão.