ForHosting KIT · Outils pour développeurs

Convertisseur quadkey vers tuile XYZ : X, Y et zoom

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.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

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. Cet outil prend cette chaîne et renvoie la tuile entière X, Y et le niveau de zoom qu’elle représente, plus la longueur d’axe deux à la puissance du zoom et un chemin prêt z barre x barre y pour URL et fixtures de régression. Chiffres hors de zéro à trois, chaînes vides et clés absurde­ment longues échouent avec un message invalid_input clair au lieu d’inventer un wrap silencieux. Le widget gratuit du navigateur et l’API payante partagent une seule fonction isomorphe pure, de sorte que sessions de débogage, clés d’examen et scripts par lots ne divergent jamais sur le même quadkey.

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

Saisissez vos données dans le formulaire ci-dessus. L’outil les vérifie avant le calcul et affiche le résultat sur la même page.

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. 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. 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. 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é. 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 équipes QA qui écrivent des tests golden pour produits d’imagerie affirment qu’un quadkey de repère connu s’étend toujours à la même tierce zoom, X et Y d’une version à l’autre sans dépendre d’un SDK Microsoft complet en intégration continue. 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. Comme cette capacité est un moteur de parse pur, le tarif API est la base publiée de le tarif de base publié par élément réussi et la validation échouée ne consomme pas de solde. 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.

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.

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.

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.

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.

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

La requête échoue avec invalid_input nommant le mauvais caractère et l’index. 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 coût ?

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

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.

POSThttps://api.kit.forhosting.com/geo/quadkey-to-tile

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é.

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"}'
{
  "quadkey": "1203"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.quadkey_to_tile",
  "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.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →