Baldosa a quadkey Bing
Calcule el quadkey de Bing Maps de cualquier baldosa: la columna 3, fila 5 en zoom 3 da 213, los mismos dígitos que usan las direcciones de baldosas y las claves de caché reales. Acepta niveles de zoom del 1 al 23. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Columna de baldosa
- 3
- Fila de baldosa
- 5
- Nivel de zoom
- 3
- Clave quadkey
- 213
- Longitud
- 3
- Índice máximo
- 7
Bing Maps y muchas canalizaciones de baldosas Azure Maps identifican cada cuadrado de la rejilla Web Mercator con una cadena compacta en base 4 llamada quadkey. Dados la columna entera de baldosa X, la fila Y y un nivel de zoom de detalle, esta capacidad construye esa cadena con las mismas reglas de plegado de bits publicadas en la documentación del sistema de baldosas Bing Maps de Microsoft, de modo que los dígitos que obtiene coinciden con las URL de baldosas de producción y las claves de caché. Los índices de baldosa fuera de rango para el zoom elegido fallan con un error de entrada inválida claro en lugar de inventar un envoltorio silencioso.
Qué es un quadkey de Bing Maps y qué X, Y, zoom enviar
Un quadkey es una cadena de dígitos de cero a tres cuya longitud es igual al nivel de zoom. Cada dígito codifica un paso de una división recursiva en cuadrantes del mundo: cero es el hijo noroeste, uno el noreste, dos el suroeste y tres el sureste, coincidiendo con el entrelazado de bits de baldosa X e Y desde el bit de zoom más significativo hasta el menos significativo.
Envíe los campos enteros obligatorios x e y para la columna y fila de baldosa en la rejilla Bing Maps, y zoom para el nivel de detalle entre uno y veintitrés. En el zoom z el rango válido de x e y es el intervalo cerrado de cero a dos elevado a z menos uno. Ese es el mismo límite que impone todo servidor de baldosas conforme antes de construir una ruta URL.
Qué puede hacer con ella
Constructores de URL de baldosas Bing y Azure
Los backends que ensamblan rutas de baldosas Bing Maps o Azure Maps convierten X/Y/zoom enteros en una cadena quadkey que coincide con claves CDN de producción y particiones de caché.
Preguntas frecuentes
¿Cómo convierto baldosa X, Y y zoom a un quadkey de Bing Maps?
La respuesta incluye la cadena quadkey (213 en ese ejemplo clásico).
¿Qué ocurre si el índice de baldosa está fuera del rango válido?
Para el zoom z, x e y deben estar en [0, 2^z − 1]. Los índices fuera de rango se rechazan y no se cobran.
¿Qué niveles de zoom se admiten?
La longitud del quadkey siempre es igual al zoom.
¿Es gratis la herramienta de baldosa a quadkey Bing Maps?
La herramienta del navegador se ejecuta gratis en su dispositivo.
¿Coincide con TileXYToQuadKey de Microsoft?
Sí. La codificación sigue las reglas de plegado de bits del sistema de baldosas Bing Maps: por cada bit de zoom, sume 1 si X tiene el bit y sume 2 si Y tiene el bit.
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-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)Ejemplo de solicitud
{
"x": 3,
"y": 5,
"zoom": 3
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.quadkey_encode",
"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
Estudiantes, ingenieros SIG y servicios backend pueden fijar el JSON determinista en pruebas sin incrustar un SDK de mapas completo.
Qué es un quadkey de Bing Maps y qué X, Y, zoom enviar
Se aceptan los alias tile_x, tileX y col para x; tile_y, tileY y row para y; y z, level, level_of_detail o lod para zoom cuando su cliente ya use esos nombres. Campos ausentes, no enteros, zoom fuera de uno a veintitrés e índices de baldosa negativos o excesivos fallan con invalid_input para que correctores de deberes y canalizaciones nunca acepten una coordenada recortada en silencio. Entradas idénticas siempre producen JSON idéntico porque la ruta es aritmética de bits pura sin red, semilla aleatoria ni reloj de pared.
Cómo leer la respuesta quadkey y validar los límites de baldosa
Prefiera los campos estructurados a analizar el quadkey usted mismo cuando solo necesite metadatos de límites; conserve la cadena cuando deba construir rutas de baldosas Bing o Azure que incrusten la clave directamente. Si tiene éxito, la respuesta repite x, y y zoom normalizados, devuelve la cadena quadkey, fija length igual a zoom para que los clientes afirmen el recuento de dígitos sin contar caracteres a mano, e incluye max_index igual a dos elevado a zoom menos uno como cota superior inclusiva aplicada durante la validación. La etiqueta method es siempre bing_maps_tile_xy_to_quadkey para que el código descendente pueda ramificar sin husmear formas al mezclar este codificador con geohash u otras claves espaciales. Cuando una petición falla porque x o y cae fuera de cero a max_index, el mensaje de error nombra el eje malo y el rango válido para ese zoom, lo que facilita depurar errores de uno en convertidores lat-lon a baldosa.
Uso de la API, precios, flujos de mapas y límites prácticos
Envíe un cuerpo JSON con los enteros obligatorios x, y y zoom. Llame a la herramienta gratuita en el navegador de baldosa a quadkey Bing para demos de clase, comprobaciones mentales rápidas de coordenadas TMS y verificación local sin instalar un SDK de mapas. Use la API prepago cuando una caché de baldosas, un purgador CDN, un trabajo ETL SIG, un empaquetador offline móvil o una plataforma educativa necesiten un contrato estable bajo saldo KIT a $0.002 por elemento correcto; los fallos de validación nunca consumen saldo tras el rechazo del motor. El zoom está limitado a veintitrés para cubrir niveles de detalle de mapa prácticos manteniendo el bucle de bits acotado en un Worker. Los autores que publican SDK pueden mapear el campo quadkey directamente a plantillas URL de la forma ruta barra quadkey punto formato de imagen usadas por extremos clásicos de baldosas Bing.
Casos de integración
Fixtures de canalización SIG y oráculos de CI
Los equipos fijan baldosas conocidas como x=3, y=5, zoom=3 → 213 para que las refactorizaciones de proyección y TMS no cambien en silencio el direccionamiento espacial.
Enseñar el sistema de baldosas Bing Maps
Instructores y estudiantes codifican a mano niveles de zoom pequeños, comparan con la API y aprenden cómo los bits de X e Y se pliegan en dígitos en base 4.