Ajustar coordenadas de latitude e longitude a uma grade

Informe latitude, longitude e espaçamento entre os nós em graus decimais; se necessário, desloque a grade escolhendo uma origem personalizada. O resultado inclui a coordenada ajustada, índices inteiros e deslocamentos com sinal em relação ao ponto original. Assim, você pode agrupar, comparar e armazenar coordenadas em cache, além de usá-las como células espaciais compactas, sem depender de geocodificação remota nem de um sistema de informações geográficas complexo.

Escolha uma grade adequada ao seu índice

Uma grade geográfica regular divide latitude e longitude em intervalos reproduzíveis. Comece informando uma coordenada e um espaçamento positivo em graus decimais. Um espaçamento menor cria mais nós e preserva mais detalhes da posição, enquanto um valor maior reúne uma área mais ampla sob a mesma coordenada ajustada. O espaçamento é aplicado separadamente aos dois eixos, portanto a saída forma uma grade retangular em unidades angulares. Isso é útil para indexação espacial quantizada, agregação, chaves de cache, deduplicação aproximada e redução de precisão para proteção da privacidade. Lembre-se de que graus são unidades angulares: a distância no solo correspondente a um grau de longitude diminui perto dos polos. Se você precisar de células com tamanho quase constante em metros sobre uma região extensa, projete os dados em um sistema de coordenadas plano apropriado antes de aplicar uma grade métrica. Para conjuntos locais ou intencionalmente baseados em graus, o ajuste direto costuma ser a solução mais simples e transparente. O cálculo não deduz o espaçamento nem altera unidades silenciosamente, portanto todo resultado pode ser reproduzido a partir das entradas declaradas.

Controle o alinhamento pela origem

Por padrão, a grade fica ancorada em zero grau de latitude e zero grau de longitude. Cada nó corresponde à origem somada a um múltiplo inteiro do espaçamento escolhido em cada eixo. Você pode fornecer origin_lat e origin_lon quando um mosaico existente usar outro alinhamento. Isso é importante porque duas grades com o mesmo espaçamento, mas origens diferentes, produzem células distintas. Os índices retornados representam o número com sinal de passos desde a origem e formam uma chave composta prática quando a definição da grade é armazenada junto deles. Latitude e longitude são ajustadas de modo independente. Se o ponto estiver exatamente no meio, o empate é resolvido para longe do índice zero, garantindo um resultado estável em coordenadas positivas e negativas. Nos limites geográficos, o cálculo escolhe o nó mais próximo que pertence à grade declarada e permanece nos intervalos válidos. Ele nunca retorna latitude acima de 90 graus nem longitude acima de 180 graus apenas porque um nó aritmético sem restrição estaria mais perto.

Interprete a coordenada e os deslocamentos

A resposta apresenta latitude e longitude ajustadas como resultado principal, acompanhadas por lat_index e lon_index. Ela também informa as variações com sinal em graus. Um deslocamento positivo de latitude indica que o nó está ao norte do ponto enviado; um deslocamento negativo de longitude indica que está a oeste. Esses valores permitem auditar a quantização introduzida ou rejeitar registros cujo deslocamento exceda uma política da sua aplicação. Os resultados são arredondados para doze casas decimais, removendo ruído irrelevante de ponto flutuante binário sem perder detalhes abaixo do menor espaçamento aceito. A operação é determinística, não usa rede e não mantém estado; assim, a mesma entrada JSON gera a mesma saída no navegador e pela API. Uma solicitação processa uma coordenada e custa US$ 0,002 pela API. Em fluxos em lote, chame a capacidade para cada item e guarde espaçamento e origem com os índices, para que futuros leitores reconstruam a definição exata da grade em vez de tentar deduzi-la dos valores ajustados.