Decodificador quadkey Bing
Transforme um quadkey do Bing Maps no tile que ele representa: 213 é a coluna 3, linha 5 no zoom 3, pronto para usar como caminho 3/3/5. Útil para conferir uma chave de cache ou levar tiles para um servidor XYZ. 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
- Chave quadkey
- 213
- X
- 3
- Y
- 5
- Nível de zoom
- 3
- Z
- 3
Um quadkey do Bing Maps é um endereço compacto em base quatro de um quadrado na pirâmide global de tiles Web Mercator usada pelo Bing Maps, Azure Maps e muitas caches de tiles compatíveis. Em vez de três inteiros separados para zoom, coluna e linha, uma única string de dígitos de zero a três codifica o caminho completo da tile raiz até uma folha.
Como um quadkey do Bing Maps vira tile X, Y e zoom
O sistema de tiles Microsoft Bing Maps constrói uma pirâmide quadrada em Web Mercator. No zoom um o mundo se divide em quatro quadrantes filhos rotulados zero, um, dois e três; cada zoom mais profundo acrescenta outro dígito ao subdividir o pai. Ler a string da esquerda para a direita caminha do bit mais grosso ao mais fino dos índices de tile.
O zoom é igual ao comprimento da string: uma chave de três caracteres como dois um três é sempre zoom três, e uma chave de dezesseis caracteres é sempre zoom dezesseis. Para recuperar X e Y, inicialize ambas as coordenadas em zero e, para cada posição de bit da mais significativa à menos significativa, aplique uma máscara binária de um deslocado à esquerda pela profundidade restante.
O dígito zero deixa ambos os bits limpos, o um define o bit X, o dois o bit Y e o três ambos os bits. Após aplicar todos os dígitos, X e Y são inteiros não negativos no intervalo semiaberto de zero até dois elevado ao zoom menos um, coincidindo com o esquema familiar z barra x barra y de servidores estilo OpenStreetMap uma vez conhecido o zoom.
Checagens clássicas de documentação incluem a chave dois um três decodificando para X igual a três e Y igual a cinco no zoom três, e o dígito único um para X igual a um e Y igual a zero no zoom um.
O que você envia e o que recebe de volta
Envie uma string obrigatória no campo quadkey. O valor deve ser uma sequência não vazia apenas dos dígitos zero, um, dois e três; espaços são aparados nas bordas, mas espaço interno e letras falham na validação. Use o formulário gratuito do navegador ao inspecionar uma chave de cache suspeita de uma URL Bing ou Azure Maps e precisar da terna XYZ imediatamente.
Chame o contrato idêntico a partir de scripts ao migrar um armazenamento de quadkeys para um CDN de tiles XYZ, gerar chaves de resposta para cursos GIS ou afirmar que um quadkey de marco fixo ainda mapeia para a mesma coluna e linha após upgrade de biblioteca. Combine este decodificador com um codificador separado ou um landing lat-lon para tile quando seu fluxo precisar da direção inversa em vez de sobrecarregar um único formulário.
Onde a decodificação de quadkey Bing aparece no trabalho real
Engenheiros de plataformas de mapas recebem constantemente URLs de tiles Bing ou Azure Maps que embutem um segmento de caminho quadkey e precisam da coluna e linha equivalentes para um cache XYZ, uma sobreposição de depuração ou uma comparação com tiles OpenStreetMap da mesma célula de pirâmide. Serviços backend que historicamente armazenavam apenas quadkeys como chaves primárias compactas ainda precisam de uma forma fechada confiável para unir a shards de mapas deslizantes, aquecer regiões CDN ou exportar entidades GeoJSON indexadas por z barra x barra y.
Autores de currículo que ensinam mapeamento web e GIS querem que alunos vejam rótulos de quadrante em base quatro produzirem índices inteiros sem um clamp silencioso nem um passo de projeção de ponto flutuante. Pipelines de logística e privacidade que guardam chaves de pirâmide grossas podem decodificar um lote de quadkeys em índices de tile delimitadores para analytics mantendo a conversão pura e offline.
Se mais tarde você precisar da codificação inversa de X Y zoom em um quadkey, lat lon para índices de tile slippy ou pontos de destino de grande círculo, trate-os como intenções de busca e landings separados em vez de sobrecarregar esta página do decodificador de quadkey do Bing Maps.
Casos de uso
Migrar quadkeys Bing para caminhos de tile XYZ
Decodifique chaves primárias quadkey do Bing ou Azure Maps armazenadas em z/x/y para aquecimento CDN, caches estilo OpenStreetMap e comparações de tiles entre provedores.
Depurar URLs de imagens e chaves de cache
Cole um quadkey de uma URL de tile de produção e recupere instantaneamente tile X, Y e zoom para abrir a célula de pirâmide correspondente em outro cliente de mapa.
Perguntas frequentes
O que é um quadkey do Bing Maps?
Uma string em base quatro de dígitos 0–3 que codifica o caminho da tile raiz até uma folha na pirâmide Web Mercator do Bing Maps / Azure Maps. Seu comprimento é o nível de zoom.
Como o zoom se relaciona com a string?
O zoom é igual ao número de caracteres.
O que acontece se o quadkey tiver um dígito diferente de 0–3?
Só são legais os dígitos 0, 1, 2 e 3. Validação falha não é cobrada.
Isto converte latitude e longitude em um tile?
Não. Este landing só decodifica um quadkey existente em X, Y e zoom. Lat/lon para tile slippy é outra intenção de busca e ferramenta.
Quanto custa?
A ferramenta do navegador é grátis e roda localmente.
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-decode \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"quadkey":"213"}'const res = await fetch("https://api.kit.forhosting.com/geo/quadkey-decode", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"quadkey": "213"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/quadkey-decode",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"quadkey": "213"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/quadkey-decode", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"quadkey":"213"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"quadkey":"213"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/quadkey-decode", 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
{
"quadkey": "213"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.quadkey_decode",
"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
Dígitos fora de zero a três, strings vazias e chaves absurdamente longas falham com mensagem invalid_input clara em vez de inventar um wrap silencioso.
Como um quadkey do Bing Maps vira tile X, Y e zoom
Entrada vazia e qualquer caractere fora dos quatro dígitos legais são rejeitados com invalid_input antes de qualquer índice ser calculado.
O que você envia e o que recebe de volta
Aliases comuns como quadKey e qk são aceitos no parse enquanto a resposta sempre ecoa o nome de campo canônico. O comprimento é o nível de zoom e deve ficar no máximo em trinta para que dois elevado ao zoom continue um contagem de tiles inteira prática para Worker e navegador. Em sucesso a resposta devolve a string quadkey limpa, índices de tile inteiros x e y, zoom e um campo z espelhado, o comprimento do eixo n igual a dois elevado ao zoom, uma string tile_path na forma z barra x barra y, a tag method bing_maps_quadkey e uma string formula compacta para documentação. O preço de chamadas API bem-sucedidas é a base publicada de US$ 0,002 por item; falhas de validação como um dígito cinco no meio da chave não consomem saldo pré-pago.
Onde a decodificação de quadkey Bing aparece no trabalho real
Como esta capacidade é um motor de parse puro, o preço da API é a base publicada de US$ 0,002 por item bem-sucedido e validação falha não consome saldo.
Casos de integração
Lições GIS e fixtures golden
Gere ternas X/Y/zoom estáveis a partir de quadkeys de livro-texto para que instrutores, autoavaliadores e suítes de regressão compartilhem uma verdade do sistema de tiles Bing.