Decodificador quadkey Bing
Convierta un quadkey de Bing Maps en la baldosa que representa: 213 es la columna 3, fila 5 en zoom 3, lista para usar como ruta 3/3/5. Útil para revisar una clave de caché o pasar baldosas a un servidor XYZ. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Clave quadkey
- 213
- X
- 3
- Y
- 5
- Nivel de zoom
- 3
- Z
- 3
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. 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.
Cómo un quadkey de Bing Maps se convierte en baldosa X, Y y zoom
El sistema de baldosas Microsoft Bing Maps construye una pirámide cuadrada en Web Mercator. En el zoom uno el mundo se divide en cuatro cuadrantes hijos etiquetados cero, uno, dos y tres; cada zoom más profundo añade otro dígito al subdividir el padre. Leer la cadena de izquierda a derecha camina por tanto del bit más grueso al más fino de los índices de baldosa.
El zoom es igual a la longitud de la cadena: una clave de tres caracteres como dos uno tres es siempre zoom tres, y una clave de dieciséis caracteres es siempre zoom dieciséis. Para recuperar X e Y, inicialice ambas coordenadas a cero y, para cada posición de bit de la más significativa a la menos significativa, aplique una máscara binaria de uno desplazado a la izquierda por la profundidad restante.
El dígito cero deja ambos bits en cero, el uno fija el bit X, el dos el bit Y y el tres ambos bits. Tras aplicar todos los dígitos, X e Y son enteros no negativos en el rango semiabierto de cero a dos elevado al zoom menos uno, coincidiendo con el esquema familiar z barra x barra y de servidores estilo OpenStreetMap una vez conocido el zoom.
Comprobaciones clásicas de documentación incluyen la clave dos uno tres que decodifica a X igual a tres e Y igual a cinco en zoom tres, y el dígito único uno a X igual a uno e Y igual a cero en zoom uno.
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. 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. 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 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.
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.
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.
¿Qué ocurre si el quadkey tiene un dígito distinto de 0–3?
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.
Herramientas relacionadas
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-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)Ejemplo de solicitud
{
"quadkey": "213"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.quadkey_decode",
"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. |
Notas técnicas
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.
Cómo un quadkey de Bing Maps se convierte en baldosa X, Y y zoom
La entrada vacía y cualquier carácter fuera de los cuatro dígitos legales se rechazan con invalid_input antes de calcular cualquier índice.
Qué envía usted y qué recibe a cambio
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. 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.
Dónde aparece la decodificación de quadkey Bing en el trabajo real
Como esta capacidad es un motor de análisis puro, el precio de la API es la base publicada de $0.002 por elemento correcto y la validación fallida no consume saldo.
Casos de integración
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.