Tuile vers quadkey Bing
Obtenez le quadkey Bing Maps de n'importe quelle tuile : la colonne 3, ligne 5 au zoom 3 donne 213, les mêmes chiffres que ceux des adresses de tuiles et des clés de cache réelles. Les zooms de 1 à 23 sont acceptés. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Colonne de tuile
- 3
- Ligne de tuile
- 5
- Niveau de zoom
- 3
- Clé quadkey
- 213
- Longueur
- 3
- Indice max
- 7
Bing Maps et de nombreux pipelines de tuiles Azure Maps identifient chaque carré de la grille Web Mercator par une chaîne compacte en base 4 appelée quadkey. Étant donnés la colonne entière de tuile X, la ligne Y et un niveau de zoom de détail, cette capacité construit cette chaîne avec les mêmes règles de pliage de bits publiées dans la documentation du système de tuiles Bing Maps de Microsoft, de sorte que les chiffres obtenus correspondent aux URL de tuiles de production et aux clés de cache. Les indices de tuile hors plage pour le zoom choisi échouent avec une erreur d’entrée invalide claire au lieu d’inventer un wrap silencieux.
Ce qu’est un quadkey Bing Maps et quels X, Y, zoom envoyer
Un quadkey est une chaîne de chiffres de zéro à trois dont la longueur égale le niveau de zoom. Chaque chiffre encode une étape d’une division récursive en quadrants du monde : zéro est l’enfant nord-ouest, un le nord-est, deux le sud-ouest et trois le sud-est, correspondant à l’entrelacement des bits de tuile X et Y du bit de zoom le plus significatif au moins significatif.
Envoyez les champs entiers obligatoires x et y pour la colonne et la ligne de tuile dans la grille Bing Maps, et zoom pour le niveau de détail entre un et vingt-trois. Au zoom z la plage valide de x et y est l’intervalle fermé de zéro à deux à la puissance z moins un. C’est la même borne que tout serveur de tuiles conforme applique avant de construire un chemin d’URL.
Cas d’usage
Constructeurs d’URL de tuiles Bing et Azure
Les backends qui assemblent des chemins de tuiles Bing Maps ou Azure Maps convertissent X/Y/zoom entiers en une chaîne quadkey alignée sur les clés CDN de production et les partitions de cache.
Questions fréquentes
Comment convertir tuile X, Y et zoom en quadkey Bing Maps ?
La réponse inclut la chaîne quadkey (213 pour cet exemple classique).
Que se passe-t-il si l’indice de tuile est hors plage valide ?
Pour le zoom z, x et y doivent être dans [0, 2^z − 1]. Les indices hors plage sont rejetés et non facturés.
Quels niveaux de zoom sont pris en charge ?
La longueur du quadkey égale toujours le zoom.
Cela correspond-il au TileXYToQuadKey de Microsoft ?
Oui. L’encodage suit les règles de pliage de bits du système de tuiles Bing Maps : pour chaque bit de zoom, ajoutez 1 si X a le bit et 2 si Y a le bit.
Que signifie chaque chiffre du quadkey obtenu ?
Chaque chiffre indique le quart choisi à chaque niveau de zoom. Le 0 désigne le nord-ouest, le 1 le nord-est, le 2 le sud-ouest et le 3 le sud-est. Le premier chiffre correspond au découpage le plus grossier, le dernier au plus fin.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre 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)Exemple de requête
{
"x": 3,
"y": 5,
"zoom": 3
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.quadkey_encode",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Étudiants, ingénieurs SIG et services backend peuvent figer le JSON déterministe dans les tests sans intégrer un SDK cartographique complet.
Ce qu’est un quadkey Bing Maps et quels X, Y, zoom envoyer
Les alias tile_x, tileX et col sont acceptés pour x ; tile_y, tileY et row pour y ; et z, level, level_of_detail ou lod pour zoom lorsque votre client utilise déjà ces noms. Champs manquants, non entiers, zoom hors de un à vingt-trois et indices de tuile négatifs ou excessifs échouent avec invalid_input pour que correcteurs de devoirs et pipelines n’acceptent jamais une coordonnée tronquée en silence. Des entrées identiques produisent toujours un JSON identique car le chemin est une pure arithmétique de bits sans réseau, sans graine aléatoire et sans horloge murale.
Lire la réponse quadkey et valider les bornes de tuile
Préférez les champs structurés à l’analyse du quadkey vous-même lorsque vous n’avez besoin que de métadonnées de bornes ; conservez la chaîne lorsque vous devez construire des chemins de tuiles Bing ou Azure qui intègrent la clé directement. En cas de succès la réponse renvoie x, y et zoom normalisés, fournit la chaîne quadkey, fixe length égal à zoom pour que les clients affirment le nombre de chiffres sans compter les caractères à la main, et inclut max_index égal à deux à la puissance zoom moins un comme borne supérieure inclusive appliquée pendant la validation. L’étiquette method est toujours bing_maps_tile_xy_to_quadkey pour que le code aval puisse brancher sans renifler les formes lorsque vous mélangez cet encodeur avec geohash ou d’autres clés spatiales. Lorsqu’une requête échoue parce que x ou y tombe hors de zéro à max_index, le message d’erreur nomme le mauvais axe et la plage valide pour ce zoom, ce qui facilite le débogage des erreurs de un dans les convertisseurs lat-lon vers tuile.
Usage de l’API, tarification, flux cartographiques et limites pratiques
Envoyez un corps JSON avec les entiers obligatoires x, y et zoom. Appelez l’outil gratuit dans le navigateur tuile vers quadkey Bing pour des démos de cours, des vérifications mentales rapides de coordonnées TMS et une vérification locale sans installer de SDK cartographique. Utilisez l’API prépayée lorsqu’un cache de tuiles, un purgateur CDN, un job ETL SIG, un empaqueteur hors ligne mobile ou une plateforme éducative a besoin d’un contrat stable sous solde KIT à $0.002 par élément réussi ; les échecs de validation ne consomment jamais de solde après le rejet du moteur. Le zoom est plafonné à vingt-trois pour couvrir des niveaux de détail cartographiques pratiques tout en gardant la boucle de bits bornée sur un Worker. Les auteurs qui livrent des SDK peuvent mapper le champ quadkey directement dans des modèles d’URL de la forme chemin barre quadkey point format d’image utilisés par les points d’accès classiques de tuiles Bing.
Cas d'intégration
Fixtures de pipeline SIG et oracles de CI
Les équipes figent des tuiles connues telles que x=3, y=5, zoom=3 → 213 pour que les refactors de projection et TMS ne changent pas silencieusement l’adressage spatial.
Enseigner le système de tuiles Bing Maps
Formateurs et étudiants encodent à la main de petits niveaux de zoom, comparent à l’API et apprennent comment les bits X et Y se plient en chiffres en base 4.
Questions techniques
L’outil tuile vers quadkey Bing Maps est-il gratuit ?
L’outil navigateur s’exécute gratuitement sur votre appareil. Les appels API utilisent le solde KIT prépayé à $0.002 par élément réussi ; les échecs de validation ne sont pas facturés.