ForHosting KIT · Voyages et géographie

Décodeur quadkey Bing

Retrouvez la tuile que désigne un quadkey Bing Maps : 213 correspond à la colonne 3, ligne 5 au zoom 3, prête à servir comme chemin 3/3/5. Pratique pour vérifier une clé de cache ou migrer vers un serveur XYZ. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Clé quadkey: 213

Vous obtenez

X: 3
Y: 5
Niveau de zoom: 3
Z: 3

Un quadkey Bing Maps est une adresse compacte en base quatre d’un carré de la pyramide mondiale de tuiles Web Mercator utilisée par Bing Maps, Azure Maps et de nombreux caches de tuiles compatibles. Au lieu de trois entiers séparés pour zoom, colonne et ligne, une seule chaîne de chiffres de zéro à trois encode le chemin complet de la tuile racine jusqu’à une feuille.

Comment un quadkey Bing Maps devient tuile X, Y et zoom

Le système de tuiles Microsoft Bing Maps construit une pyramide carrée en Web Mercator. Au zoom un le monde se divise en quatre quadrants enfants étiquetés zéro, un, deux et trois ; chaque zoom plus profond ajoute un autre chiffre en subdivisant le parent. Lire la chaîne de gauche à droite marche donc du bit le plus grossier au plus fin des indices de tuile.

Le zoom égale la longueur de la chaîne : une clé de trois caractères comme deux un trois est toujours zoom trois, et une clé de seize caractères est toujours zoom seize. Pour récupérer X et Y, initialisez les deux coordonnées à zéro puis pour chaque position de bit de la plus significative à la moins significative appliquez un masque binaire d’un décalé à gauche de la profondeur restante.

Le chiffre zéro laisse les deux bits clairs, un fixe le bit X, deux le bit Y et trois les deux bits. Après application de chaque chiffre, X et Y sont des entiers non négatifs dans l’intervalle semi-ouvert de zéro à deux à la puissance du zoom moins un, correspondant au schéma familier z barre x barre y des serveurs style OpenStreetMap une fois le zoom connu.

Contrôles classiques de documentation : la clé deux un trois décode en X égal trois et Y égal cinq au zoom trois, et le chiffre unique un en X égal un et Y égal zéro au zoom un.

Ce que vous envoyez et ce que vous obtenez en retour

Envoyez une chaîne obligatoire sous le champ quadkey. La valeur doit être une séquence non vide des seuls chiffres zéro, un, deux et trois ; les espaces sont rognés aux bords, mais espaces internes et lettres échouent à la validation. Utilisez le formulaire gratuit du navigateur lorsque vous inspectez une clé de cache suspecte d’une URL Bing ou Azure Maps et avez besoin de la tierce XYZ immédiatement.

Appelez le contrat identique depuis des scripts pour migrer un magasin de quadkeys vers un CDN de tuiles XYZ, générer des clés de réponse pour cours SIG ou affirmer qu’un quadkey de repère fixe mappe encore sur la même colonne et ligne après une mise à niveau de bibliothèque. Associez ce décodeur à un encodeur séparé ou un atterrissage lat-lon vers tuile lorsque votre flux a besoin de la direction inverse plutôt que de surcharger un seul formulaire.

Où le décodage de quadkey Bing apparaît dans le travail réel

Les ingénieurs de plateformes cartographiques reçoivent constamment des URL de tuiles Bing ou Azure Maps qui intègrent un segment de chemin quadkey et ont besoin de la colonne et de la ligne équivalentes pour un cache XYZ, une superposition de débogage ou une comparaison avec des tuiles OpenStreetMap de la même cellule de pyramide.

Les services backend qui stockaient historiquement uniquement des quadkeys comme clés primaires compactes ont encore besoin d’une forme fermée de confiance pour joindre des shards de cartes glissantes, chauffer des régions CDN ou exporter des entités GeoJSON indexées par z barre x barre y. Les auteurs de curricula qui enseignent la cartographie web et le SIG veulent que les étudiants voient les étiquettes de quadrant en base quatre produire des indices entiers sans clamp silencieux ni étape de projection flottante.

Les pipelines de logistique et de confidentialité qui gardent des clés de pyramide grossières peuvent décoder un lot de quadkeys en indices de tuile de délimitation pour l’analytique en gardant la conversion pure et hors ligne. Si vous avez plus tard besoin de l’encodage inverse de X Y zoom en quadkey, de lat lon vers indices de tuile slippy ou de points de destination grand cercle, traitez-les comme intentions de recherche et atterrissages séparés plutôt que de surcharger cette page du décodeur de quadkey Bing Maps.

Cas d’usage

Migrer des quadkeys Bing vers des chemins de tuile XYZ

Décodez des clés primaires quadkey Bing ou Azure Maps stockées en z/x/y pour chauffe CDN, caches style OpenStreetMap et comparaisons de tuiles multi-fournisseurs.

Déboguer des URL d’imagerie et des clés de cache

Collez un quadkey d’une URL de tuile de production et récupérez instantanément tuile X, Y et zoom pour ouvrir la cellule de pyramide correspondante dans un autre client cartographique.

Questions fréquentes

Qu’est-ce qu’un quadkey Bing Maps ?

Une chaîne en base quatre de chiffres 0–3 qui encode le chemin de la tuile racine à une feuille dans la pyramide Web Mercator Bing Maps / Azure Maps. Sa longueur est le niveau de zoom.

Que se passe-t-il si le quadkey a un chiffre autre que 0–3 ?

Seuls les chiffres 0, 1, 2 et 3 sont légaux. La validation échouée n’est pas facturée.

Cela convertit-il latitude et longitude en tuile ?

Non. Cet atterrissage ne décode qu’un quadkey existant en X, Y et zoom. Lat/lon vers tuile slippy est une autre intention de recherche et un autre outil.

Quel est le lien entre le niveau de zoom et la longueur du quadkey ?

C'est le même nombre. Une clé de trois chiffres comme 213 est toujours au zoom 3, et une clé de seize chiffres toujours au zoom 16. Une clé peut compter jusqu'à 30 chiffres.

Comment obtenir le chemin z/x/y d'une tuile à partir de son quadkey ?

Le décodeur le fournit avec le résultat : 213 donne 3/3/5, soit le zoom, la colonne puis la ligne. C'est le format des serveurs de tuiles de type OpenStreetMap, une fois le zoom connu.

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

POSThttps://api.kit.forhosting.com/geo/quadkey-decode

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-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)

Exemple de requête

{
  "quadkey": "213"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.quadkey_decode",
  "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

par requête$0.002

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

Chiffres hors de zéro à trois, chaînes vides et clés absurdement longues échouent avec un message invalid_input clair au lieu d’inventer un wrap silencieux.

Comment un quadkey Bing Maps devient tuile X, Y et zoom

Entrée vide et tout caractère hors des quatre chiffres légaux sont rejetés avec invalid_input avant tout calcul d’indice.

Ce que vous envoyez et ce que vous obtenez en retour

Alias courants comme quadKey et qk sont acceptés au parse tandis que la réponse renvoie toujours le nom de champ canonique. La longueur est le niveau de zoom et doit rester au plus trente pour que deux à la puissance du zoom reste un compte de tuiles entier pratique pour Worker et navigateur. En cas de succès la réponse renvoie la chaîne quadkey nettoyée, indices de tuile entiers x et y, zoom et un champ z miroir, la longueur d’axe n égale à deux à la puissance du zoom, une chaîne tile_path en forme z barre x barre y, la balise method bing_maps_quadkey et une chaîne formula compacte pour documentation. Le tarif des appels API réussis est la base publiée de $0.002 par élément ; les échecs de validation comme un chiffre cinq au milieu de la clé ne consomment pas le solde prépayé.

Où le décodage de quadkey Bing apparaît dans le travail réel

Comme cette capacité est un moteur de parse pur, le tarif API est la base publiée de $0.002 par élément réussi et la validation échouée ne consomme pas de solde.

Cas d'intégration

Devoirs SIG et fixtures golden

Générez des tierces X/Y/zoom stables à partir de quadkeys de manuel pour que formateurs, auto-correcteurs et suites de régression partagent une vérité du système de tuiles Bing.

Questions techniques

Comment le zoom se rapporte-t-il à la chaîne ?

Le zoom égale le nombre de caractères. Par exemple, « 213 » est toujours zoom 3 et décode en tuile X=3, Y=5.

Quel est le coût ?

L’outil navigateur est gratuit et s’exécute localement. Les requêtes API utilisent le solde KIT prépayé à $0.002 par élément réussi ; l’entrée invalide n’est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Comment un quadkey Bing Maps devient tuile X, Y et zoom

Ce que vous envoyez et ce que vous obtenez en retour

Où le décodage de quadkey Bing apparaît dans le travail réel

Cas d’usage

Migrer des quadkeys Bing vers des chemins de tuile XYZ

Déboguer des URL d’imagerie et des clés de cache

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Comment un quadkey Bing Maps devient tuile X, Y et zoom

Ce que vous envoyez et ce que vous obtenez en retour

Où le décodage de quadkey Bing apparaît dans le travail réel

Cas d'intégration

Devoirs SIG et fixtures golden

Questions techniques

merci