Índice H3 aproximado: coordenadas em célula hexagonal

Escolha uma resolução de 0 a 15 para passar de regiões amplas a células progressivamente menores. O resultado inclui um identificador legível, coordenadas axiais, um centro estimado e o comprimento aproximado da aresta. A solução foi criada para agrupamento, segmentação, cache e demonstrações leves nas quais células determinísticas importam mais do que a interoperabilidade exata com o sistema H3 oficial.

Escolha uma resolução adequada ao agrupamento

A resolução controla a escala da grade. A resolução 0 produz células muito amplas, e cada nível seguinte reduz pela metade a aresta em unidades angulares. A progressão fica previsível: pontos próximos separados em um nível podem compartilhar uma célula em um nível mais grosso, enquanto resoluções maiores criam grupos mais detalhados. Comece com uma resolução baixa para resumir atividades em grandes regiões e aumente-a para agrupamentos em escala de bairro ou visualizações densas. O comprimento aproximado da aresta oferece uma referência prática, mas não é uma garantia geodésica. Como a grade usa uma projeção equiretangular simples, as distâncias terrestres leste-oeste diminuem perto dos polos, embora a geometria angular permaneça regular. Teste coordenadas representativas da área real que será analisada em vez de escolher o nível apenas pela estimativa da aresta. Acima de tudo, armazene a resolução junto de cada índice, pois células de resoluções diferentes não representam a mesma área.

Entenda como o índice aproximado é produzido

O algoritmo coloca a longitude no eixo horizontal e a latitude no vertical, sobrepõe uma malha hexagonal com vértice superior, converte o ponto em coordenadas axiais fracionárias e as arredonda por coordenadas cúbicas. Esse arredondamento preserva a relação entre os três eixos de uma grade hexagonal e atribui cada entrada válida a uma única célula determinística. O identificador contém o prefixo ah3, a resolução selecionada e códigos base-36 com sinal para q e r. Assim, a mesma entrada gera a mesma saída sem acesso à rede, estado armazenado, aleatoriedade ou dados temporais. O centro retornado resulta da conversão da posição axial arredondada de volta para latitude e longitude e auxilia em rótulos, depuração e marcadores representativos. Pontos nos limites exigem atenção: uma mudança mínima perto da aresta pode selecionar uma célula vizinha, comportamento esperado em qualquer índice espacial. Use a precisão integral das coordenadas de origem quando a repetibilidade junto às bordas for importante.

Saiba quando usar esta grade ou o H3 oficial

Esta capacidade imita deliberadamente o fluxo do H3 sem alegar compatibilidade binária, textual, geométrica ou hierárquica com seus índices. É uma grade analítica compacta para situações em que o senhor ou a senhora precisa de grupos espaciais reproduzíveis sem carregar uma biblioteca geoespacial especializada. Ela atende bem ao agrupamento de locais de amostra, à divisão de chaves de cache, a contagens gerais de densidade, ao ensino de coordenadas axiais e à criação de testes estáveis. O campo compatible_with_h3 é sempre false para impedir que sistemas posteriores confundam o resultado com um endereço H3 oficial. Use a biblioteca H3 oficial para trocar índices com outros aplicativos, percorrer pais e filhos reais, obter limites canônicos, tratar pentágonos ou empregar o modelo terrestre icosaédrico. Esta aproximação usa latitude e longitude planas; suas células distorcem a área no solo conforme a latitude e não se conectam através do antimeridiano. Considere-a um sistema determinístico de agrupamento, não um substituto para análise geodésica.