ForHosting KIT · Viagens e geografia

Células-filhas geohash

O geohash u4pruyd se divide em 32 filhas, de u4pruyd0 a u4pruydz, cada uma com um caractere a mais e, juntas, cobrindo a célula-mãe inteira. Cole um geohash e receba todas as filhas na mesma ordem fixa, prontas para indexação ou mapas. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Geohash
u4pruyd
Você obtém
Precisão
7
Precisão do filho
8
Quantidade
32

A ferramenta de células-filhas geohash recebe um geohash existente e subdivide sua área retangular nas trinta e duas células do próximo nível de precisão. Ela retorna cada filha anexando os caracteres do alfabeto base32 geohash canônico em ordem estável, deixando o resultado pronto para indexação, mapas, testes ou percursos recursivos. A entrada é normalizada para minúsculas, enquanto caracteres inválidos e comprimentos não aceitos geram um erro de entrada claro. O cálculo é determinístico e funciona sem rede, valores aleatórios ou dependência do horário.

Como funciona a subdivisão de geohash

Um geohash representa uma célula geográfica retangular por meio de uma sequência intercalada de bits de longitude e latitude. Cada caractere acrescenta cinco bits; portanto, anexar um caractere divide a célula-pai em trinta e dois retângulos menores. Esses retângulos são exatamente as filhas imediatas: não é necessário decodificar coordenadas, arredondar ou realizar uma busca espacial para nomeá-los.

Esta capacidade anexa todos os caracteres do alfabeto geohash canônico, <code>0123456789bcdefghjkmnpqrstuvwxyz</code>, ao pai normalizado. Se o pai for <code>u4pruyd</code>, as primeiras filhas serão <code>u4pruyd0</code>, <code>u4pruyd1</code> e assim por diante, e a última será <code>u4pruydz</code>. Toda string mantém o prefixo do pai e tem exatamente um caractere a mais.

Juntas, as trinta e duas cobrem a célula-pai inteira, sem lacunas ou sobreposição nessa precisão. A ordem segue o valor dos caracteres, não uma leitura geográfica. Use esta operação quando precisar do próximo nível completo de uma hierarquia geohash, e não das células vizinhas ao pai na precisão atual.

Uso de células-filhas em sistemas espaciais

A geração de filhas é útil quando uma aplicação espacial armazena ou explora locais como uma árvore de prefixos. Um serviço de mapas pode começar por uma célula ampla, solicitar suas filhas e continuar subdividindo apenas os ramos com dados suficientes. Uma rotina de manutenção pode expandir um agrupamento amplo em chaves mais finas antes de redistribuir registros.

Testes podem usar a saída ordenada para confirmar que um codificador, índice de prefixos ou percurso recursivo aceita todo sufixo legal e nunca admite caracteres base32 proibidos. Esta operação apenas nomeia células: ela não calcula limites de latitude e longitude, não verifica quais filhas contêm dados e não retorna os oito vizinhos adjacentes. Use um decodificador quando precisar de coordenadas ou caixas delimitadoras e um localizador de vizinhos para células contíguas na mesma precisão.

Para subdivisão recursiva, envie novamente qualquer filha até alcançar a precisão desejada, respeitando o limite de entrada. Como cada nível multiplica as folhas por trinta e dois, controle a recursão na aplicação e evite materializar árvores desnecessariamente grandes.

Criar uma árvore de prefixos geohash

Expanda agrupamentos espaciais selecionados um nível por vez e mantenha cada chave gerada em ordem canônica reproduzível.

Refinar células de agregação do mapa

Substitua uma região ampla pelo conjunto completo de células da próxima precisão antes de calcular estatísticas detalhadas.

Quantas células-filhas um geohash possui?

Exatamente 32 filhas imediatas, pois um caractere geohash acrescentado fornece cinco bits e representa 32 valores possíveis.

As filhas são retornadas em ordem geográfica?

Não. Elas seguem a ordem canônica dos caracteres base32, que é estável, mas não percorre o mapa de norte a sul ou de oeste a leste.

A subdivisão altera a área coberta?

As 32 filhas cobrem juntas a mesma área do pai. Cada filha individual cobre uma subdivisão na precisão seguinte.

Quais caracteres são válidos?

São válidos 0–9 e bcdefghjkmnpqrstuvwxyz. As letras a, i, l e o não pertencem ao alfabeto geohash.

Como desço mais de um nível?

Informe de novo qualquer filha e divida-a outra vez, repetindo até chegar à precisão de que precisa, dentro do limite de 12 caracteres. Cada nível multiplica as células por 32, então expanda só os ramos que interessam.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/geo/geohash-children

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/geo/geohash-children \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"geohash":"u4pruyd"}'
{
  "geohash": "u4pruyd"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.geohash_children",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_precision12
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Validação da entrada e campos da resposta

Espaços nas extremidades são removidos e letras maiúsculas são convertidas em minúsculas antes da validação. Um valor válido contém entre um e doze caracteres do alfabeto base32 de geohash. Também são rejeitados valores ausentes, tipos que não sejam string, strings vazias depois do corte e entradas acima do limite publicado. Não há campos opcionais nulos. Envie um objeto JSON com a string obrigatória <code>geohash</code>. Os aliases curtos <code>hash</code> e <code>gh</code> são aceitos por compatibilidade, embora novas integrações devam preferir o campo canônico. Esse alfabeto omite a, i, l e o para reduzir ambiguidades visuais; qualquer uma dessas letras gera <code>invalid_input</code>. O resultado inclui <code>geohash</code>, o pai normalizado; <code>precision</code>, seu comprimento; <code>child_precision</code>, uma unidade maior; <code>children</code>, o array ordenado das trinta e duas filhas; e <code>count</code>, sempre trinta e dois. Uma solicitação de API bem-sucedida custa US$ 0,002, enquanto a ferramenta do navegador executa localmente o mesmo cálculo puro.

Testar bibliotecas geohash

Gere o conjunto completo de sufixos legais para fixtures que validem percurso de prefixos, regras de entrada e contagem.

Quanto custa uma solicitação de API?

Cada solicitação de API bem-sucedida custa US$ 0,002. A versão no navegador executa gratuitamente o mesmo cálculo determinístico.

Ver a documentação completa do KIT →