Tile para quadkey Bing
Obtenha o quadkey do Bing Maps de qualquer tile: a coluna 3, linha 5 no zoom 3 dá 213, os mesmos dígitos usados em endereços de tiles e chaves de cache reais. Aceita níveis de zoom de 1 a 23. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Coluna do tile
- 3
- Linha do tile
- 5
- Nível de zoom
- 3
- Chave quadkey
- 213
- Comprimento
- 3
- Índice máximo
- 7
O Bing Maps e muitos pipelines de tiles do Azure Maps identificam cada quadrado da grade Web Mercator com uma string compacta em base 4 chamada quadkey. Dados a coluna inteira de tile X, a linha Y e um nível de zoom de detalhe, esta capacidade constrói essa string com as mesmas regras de dobramento de bits publicadas na documentação do sistema de tiles Bing Maps da Microsoft, de modo que os dígitos que você obtém batem com URLs de tiles de produção e chaves de cache. Índices de tile fora do intervalo para o zoom escolhido falham com erro claro de entrada inválida em vez de inventar um wrap silencioso.
O que é um quadkey do Bing Maps e quais X, Y, zoom enviar
Um quadkey é uma string de dígitos de zero a três cujo comprimento é igual ao nível de zoom. Cada dígito codifica um passo de uma divisão recursiva em quadrantes do mundo: zero é o filho noroeste, um o nordeste, dois o sudoeste e três o sudeste, coincidindo com o entrelaçamento de bits de tile X e Y do bit de zoom mais significativo ao menos significativo.
Envie os campos inteiros obrigatórios x e y para coluna e linha de tile na grade Bing Maps, e zoom para o nível de detalhe entre um e vinte e três. No zoom z o intervalo válido de x e y é o intervalo fechado de zero até dois elevado a z menos um. Esse é o mesmo limite que todo servidor de tiles conforme impõe antes de montar um caminho de URL.
Casos de uso
Construtores de URL de tiles Bing e Azure
Backends que montam caminhos de tiles Bing Maps ou Azure Maps convertem X/Y/zoom inteiros em uma string quadkey que bate com chaves CDN de produção e partições de cache.
Perguntas frequentes
Como converto tile X, Y e zoom para um quadkey do Bing Maps?
A resposta inclui a string quadkey (213 nesse exemplo clássico).
O que acontece se o índice de tile estiver fora do intervalo válido?
Para o zoom z, x e y devem estar em [0, 2^z − 1]. Índices fora do intervalo são rejeitados e não cobrados.
Quais níveis de zoom são suportados?
O comprimento do quadkey sempre é igual ao zoom.
A ferramenta de tile para quadkey Bing Maps é grátis?
A ferramenta do navegador roda grátis no seu dispositivo.
Isso corresponde ao TileXYToQuadKey da Microsoft?
Sim. A codificação segue as regras de dobramento de bits do sistema de tiles Bing Maps: para cada bit de zoom, some 1 se X tiver o bit e some 2 se Y tiver o bit.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
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.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/geo/quadkey-encode \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"x":3,"y":5,"zoom":3}'const res = await fetch("https://api.kit.forhosting.com/geo/quadkey-encode", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"x": 3,
"y": 5,
"zoom": 3
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/quadkey-encode",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"x": 3,
"y": 5,
"zoom": 3
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/quadkey-encode", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"x":3,"y":5,"zoom":3}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"x":3,"y":5,"zoom":3}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/quadkey-encode", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"x": 3,
"y": 5,
"zoom": 3
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.quadkey_encode",
"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.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Estudantes, engenheiros GIS e serviços backend podem fixar o JSON determinístico em testes sem embutir um SDK de mapas completo.
O que é um quadkey do Bing Maps e quais X, Y, zoom enviar
Aliases tile_x, tileX e col são aceitos para x; tile_y, tileY e row para y; e z, level, level_of_detail ou lod para zoom quando o cliente já usa esses nomes. Campos ausentes, não inteiros, zoom fora de um a vinte e três e índices de tile negativos ou excessivos falham com invalid_input para que corretores de lição e pipelines nunca aceitem uma coordenada cortada em silêncio. Entradas idênticas sempre produzem JSON idêntico porque o caminho é aritmética de bits pura sem rede, semente aleatória nem relógio de parede.
Como ler a resposta quadkey e validar limites de tile
Prefira os campos estruturados a analisar o quadkey você mesmo quando só precisa de metadados de limites; mantenha a string quando precisar montar caminhos de tiles Bing ou Azure que embutem a chave diretamente. Em sucesso a resposta ecoa x, y e zoom normalizados, devolve a string quadkey, define length igual a zoom para que clientes afirmem a contagem de dígitos sem contar caracteres à mão, e inclui max_index igual a dois elevado a zoom menos um como limite superior inclusivo aplicado na validação. O rótulo method é sempre bing_maps_tile_xy_to_quadkey para que o código a jusante possa ramificar sem cheirar formatos ao misturar este codificador com geohash ou outras chaves espaciais. Quando uma requisição falha porque x ou y cai fora de zero até max_index, a mensagem de erro nomeia o eixo ruim e o intervalo válido para aquele zoom, o que facilita depurar erros de um em conversores lat-lon para tile.
Uso da API, preços, fluxos de mapa e limites práticos
Envie um corpo JSON com os inteiros obrigatórios x, y e zoom. Chame a ferramenta gratuita no navegador de tile para quadkey Bing para demos de aula, checagens mentais rápidas de coordenadas TMS e verificação local sem instalar um SDK de mapas. Use a API pré-paga quando um cache de tiles, um purgador CDN, um job ETL GIS, um empacotador offline móvel ou uma plataforma educacional precisar de um contrato estável sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após a rejeição do motor. O zoom é limitado a vinte e três para cobrir níveis de detalhe de mapa práticos mantendo o loop de bits limitado em um Worker. Autores que publicam SDK podem mapear o campo quadkey diretamente em modelos de URL da forma caminho barra quadkey ponto formato de imagem usados por endpoints clássicos de tiles Bing.
Casos de integração
Fixtures de pipeline GIS e oráculos de CI
Equipes fixam tiles conhecidos como x=3, y=5, zoom=3 → 213 para que refatorações de projeção e TMS não mudem em silêncio o endereçamento espacial.
Ensinar o sistema de tiles Bing Maps
Instrutores e alunos codificam à mão níveis de zoom pequenos, comparam com a API e aprendem como os bits de X e Y se dobram em dígitos em base 4.