ForHosting KIT · Ferramentas para dev

Conversor de quadkey para tile XYZ: X, Y e zoom

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.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

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. Esta ferramenta recebe essa string e devolve a tile inteira X, Y e o nível de zoom que representa, mais o comprimento do eixo dois elevado ao zoom e um caminho pronto z barra x barra y para URLs e fixtures de regressão. 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. O widget gratuito do navegador e a API paga compartilham uma única função isomórfica pura, de modo que sessões de depuração, chaves de exame e scripts em lote nunca divergem no mesmo quadkey.

Como um quadkey do Bing Maps vira tile X, Y e zoom

Insira os dados no formulário acima. A ferramenta os verifica antes de calcular e mostra o resultado na mesma página.

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. 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. 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. 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. 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. Equipes de QA que escrevem testes golden para produtos de imagens afirmam que um quadkey de marco conhecido sempre se expande para a mesma terna zoom, X e Y entre releases sem depender de um SDK Microsoft completo em integração contínua. 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. Como esta capacidade é um motor de parse puro, o preço da API é a base publicada de a tarifa-base publicada por item bem-sucedido e validação falha não consome saldo. 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.

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.

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.

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. Por exemplo, "213" é sempre zoom 3 e decodifica para tile X=3, Y=5.

O que acontece se o quadkey tiver um dígito diferente de 0–3?

A requisição falha com invalid_input nomeando o caractere ruim e o índice. 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. Requisições API usam saldo KIT pré-pago a a tarifa-base publicada por item bem-sucedido; entrada inválida não é cobrada.

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/quadkey-to-tile

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/quadkey-to-tile \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"quadkey":"1203"}'
{
  "quadkey": "1203"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.quadkey_to_tile",
  "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.

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.

Ver a documentação completa do KIT →