Convertidor de quadkey a tile XYZ: X, Y y zoom
Un quadkey de Bing Maps es una dirección compacta en base cuatro de un cuadrado en la pirámide global de baldosas Web Mercator usada por Bing Maps, Azure Maps y muchas cachés de baldosas compatibles.
Ejecutar — gratis
En lugar de tres enteros separados para zoom, columna y fila, una sola cadena de dígitos de cero a tres codifica la ruta completa desde la baldosa raíz hasta una hoja. Esta herramienta toma esa cadena y devuelve la baldosa entera X, Y y el nivel de zoom que representa, más la longitud del eje dos elevado al zoom y una ruta lista z barra x barra y para URL y fixtures de regresión. Dígitos fuera de cero a tres, cadenas vacías y claves absurdamente largas fallan con un mensaje invalid_input claro en lugar de inventar un envoltorio silencioso. El widget gratuito del navegador y la API de pago comparten una sola función isomorfa pura, de modo que sesiones de depuración, claves de examen y scripts por lotes nunca divergen sobre el mismo quadkey.
Cómo un quadkey de Bing Maps se convierte en baldosa X, Y y zoom
Ingrese sus datos en el formulario de arriba. La herramienta los revisa antes de calcular y muestra el resultado en la misma página.
Qué envía usted y qué recibe a cambio
Envíe una cadena obligatoria bajo el campo quadkey. El valor debe ser una secuencia no vacía de los dígitos cero, uno, dos y tres únicamente; los espacios se recortan en los bordes, pero el espacio interno y las letras fallan la validación. Alias comunes como quadKey y qk se aceptan en el análisis mientras la respuesta siempre devuelve el nombre de campo canónico. La longitud es el nivel de zoom y debe ser como máximo treinta para que dos elevado al zoom siga siendo un recuento de baldosas entero práctico para Worker y navegador. Si tiene éxito, la respuesta devuelve la cadena quadkey limpia, índices de baldosa enteros x e y, zoom y un campo z espejo, la longitud del eje n igual a dos elevado al zoom, una cadena tile_path en forma z barra x barra y, la etiqueta method bing_maps_quadkey y una cadena formula compacta para documentación. Use el formulario gratuito del navegador cuando inspeccione una clave de caché sospechosa de una URL de Bing o Azure Maps y necesite la terna XYZ de inmediato. Llame al contrato idéntico desde scripts al migrar un almacén de quadkeys a un CDN de baldosas XYZ, generar claves de respuesta para cursos SIG o afirmar que un quadkey de hito fijo sigue mapeando a la misma columna y fila tras una actualización de biblioteca. El precio de las llamadas API correctas es la base publicada de $0.002 por elemento; los fallos de validación como un dígito cinco en medio de la clave no consumen saldo prepago. Combine este decodificador con un codificador separado o un aterrizaje lat-lon a baldosa cuando su flujo necesite la dirección inversa en lugar de sobrecargar un solo formulario.
Dónde aparece la decodificación de quadkey Bing en el trabajo real
Los ingenieros de plataformas de mapas reciben constantemente URL de baldosas Bing o Azure Maps que incrustan un segmento de ruta quadkey y necesitan la columna y fila equivalentes para una caché XYZ, una superposición de depuración o una comparación con baldosas OpenStreetMap de la misma celda de pirámide. Los servicios backend que históricamente solo almacenaban quadkeys como claves primarias compactas siguen necesitando una forma cerrada de confianza para unirse a shards de mapas deslizantes, calentar regiones CDN o exportar entidades GeoJSON indexadas por z barra x barra y. Los equipos de QA que escriben pruebas golden para productos de imágenes afirman que un quadkey de hito conocido siempre se expande a la misma terna zoom, X e Y entre versiones sin depender de un SDK Microsoft completo en integración continua. Los autores de currículos que enseñan cartografía web y SIG quieren que los estudiantes vean cómo las etiquetas de cuadrante en base cuatro producen índices enteros sin un clamp silencioso ni un paso de proyección de punto flotante. Las canalizaciones de logística y privacidad que guardan claves de pirámide gruesas pueden decodificar un lote de quadkeys en índices de baldosa delimitadores para analítica manteniendo la conversión pura y sin conexión. Como esta capacidad es un motor de análisis puro, el precio de la API es la base publicada de la tarifa base publicada por elemento correcto y la validación fallida no consume saldo. Si más adelante necesita la codificación inversa de X Y zoom a un quadkey, lat lon a índices de baldosa slippy o puntos de destino de gran círculo, trátelos como intenciones de búsqueda y aterrizajes separados en lugar de sobrecargar esta página del decodificador de quadkey de Bing Maps.
Qué puede hacer con ella
Migrar quadkeys Bing a rutas de baldosa XYZ
Decodifique claves primarias quadkey de Bing o Azure Maps almacenadas en z/x/y para calentamiento CDN, cachés estilo OpenStreetMap y comparaciones de baldosas entre proveedores.
Depurar URL de imágenes y claves de caché
Pegue un quadkey de una URL de baldosa de producción y recupere al instante baldosa X, Y y zoom para abrir la celda de pirámide coincidente en otro cliente de mapa.
Deberes SIG y fixtures golden
Genere ternas X/Y/zoom estables a partir de quadkeys de libro de texto para que instructores, auto-calificadores y suites de regresión compartan una misma verdad del sistema de baldosas Bing.
Preguntas frecuentes
¿Qué es un quadkey de Bing Maps?
Una cadena en base cuatro de dígitos 0–3 que codifica la ruta desde la baldosa raíz hasta una hoja en la pirámide Web Mercator de Bing Maps / Azure Maps. Su longitud es el nivel de zoom.
¿Cómo se relaciona el zoom con la cadena?
El zoom es igual al número de caracteres. Por ejemplo, "213" es siempre zoom 3 y decodifica a baldosa X=3, Y=5.
¿Qué ocurre si el quadkey tiene un dígito distinto de 0–3?
La petición falla con invalid_input nombrando el carácter malo y el índice. Solo son legales los dígitos 0, 1, 2 y 3. La validación fallida no se cobra.
¿Esto convierte latitud y longitud en una baldosa?
No. Este aterrizaje solo decodifica un quadkey existente en X, Y y zoom. Lat/lon a baldosa slippy es otra intención de búsqueda y herramienta.
¿Cuánto cuesta?
La herramienta del navegador es gratuita y se ejecuta localmente. Las peticiones API usan saldo KIT prepago a la tarifa base publicada por elemento correcto; la entrada inválida no se cobra.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
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"}'const res = await fetch("https://api.kit.forhosting.com/geo/quadkey-to-tile", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"quadkey": "1203"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/quadkey-to-tile",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"quadkey": "1203"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/quadkey-to-tile", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"quadkey":"1203"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"quadkey":"1203"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/quadkey-to-tile", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"quadkey": "1203"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.quadkey_to_tile",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |