Bing-Quadkey-Decoder

Ein Bing-Maps-Quadkey ist eine kompakte Basis-Vier-Adresse für ein Quadrat in der globalen Web-Mercator-Kachelpyramide von Bing Maps, Azure Maps und vielen kompatiblen Kachel-Caches. Statt dreier getrennter Ganzzahlen für Zoom, Spalte und Zeile kodiert ein einzelner String aus Ziffern null bis drei den vollständigen Pfad von der Wurzelkachel bis zu einem Blatt.

Wie ein Bing-Maps-Quadkey zu Kachel X, Y und Zoom wird

Das Microsoft Bing Maps Tile System baut eine quadratische Pyramide in Web Mercator. Bei Zoom eins teilt sich die Welt in vier Kindquadranten mit den Bezeichnungen null, eins, zwei und drei; jeder tiefere Zoom hängt eine weitere Ziffer an, indem das Elternteil unterteilt wird. Das Lesen des Strings von links nach rechts wandert daher vom gröbsten Bit zum feinsten Bit der Kachelindizes.

Zoom entspricht der Stringlänge: ein dreizeichiger Schlüssel wie zwei eins drei ist immer Zoom drei, und ein sechzehnzeichiger Schlüssel ist immer Zoom sechzehn. Um X und Y zu gewinnen, initialisieren Sie beide Koordinaten auf null und wenden Sie für jede Bitposition vom höchstwertigen zum niederwertigsten Bit eine binäre Maske von eins, nach links um die verbleibende Tiefe verschoben, an. Ziffer null lässt beide Bits klar, eins setzt das X-Bit, zwei das Y-Bit und drei beide Bits.

Klassische Dokumentationschecks umfassen den Schlüssel zwei eins drei, der zu X gleich drei und Y gleich fünf bei Zoom drei dekodiert, und die einzelne Ziffer eins zu X gleich eins und Y gleich null bei Zoom eins.

Was Sie senden und was Sie zurückerhalten

Senden Sie einen Pflichtstring unter dem Feld quadkey. Der Wert muss eine nicht leere Folge nur der Ziffern null, eins, zwei und drei sein; Leerzeichen an den Rändern werden getrimmt, aber innere Leerzeichen und Buchstaben scheitern an der Validierung. Gängige Aliasse wie quadKey und qk werden beim Parse akzeptiert, während die Antwort stets den kanonischen Feldnamen spiegelt.

Nutzen Sie das kostenlose Browserformular, wenn Sie einen verdächtigen Cache-Schlüssel aus einer Bing- oder Azure-Maps-URL prüfen und die XYZ-Dreifach sofort brauchen. Rufen Sie denselben Vertrag aus Skripten auf, wenn Sie einen Quadkey-Store zu einem XYZ-Kachel-CDN migrieren, Antwortschlüssel für GIS-Kurse erzeugen oder prüfen, dass ein fester Landmark-Quadkey nach einem Bibliotheks-Upgrade noch auf dieselbe Spalte und Zeile mappt. Kombinieren Sie diesen Decoder mit einem separaten Encoder oder einem Lat-Lon-zu-Kachel-Landing, wenn Ihr Ablauf die umgekehrte Richtung braucht, statt ein einzelnes Formular zu überladen.

Wo Bing-Quadkey-Dekodierung in der Praxis vorkommt

Kartenplattform-Ingenieure erhalten ständig Bing- oder Azure-Maps-Kachel-URLs mit einem Quadkey-Pfadsegment und brauchen die äquivalente Spalte und Zeile für einen XYZ-Cache, ein Debug-Overlay oder einen Vergleich mit OpenStreetMap-Kacheln derselben Pyramidenzelle. Backend-Dienste, die historisch nur Quadkeys als kompakte Primärschlüssel speicherten, brauchen weiterhin eine vertrauenswürdige geschlossene Form, um gegen Slippy-Map-Shards zu joinen, CDN-Regionen zu wärmen oder GeoJSON-Features nach z-Schrägstrich-x-Schrägstrich-y zu exportieren. Curriculum-Autoren, die Webmapping und GIS lehren, wollen, dass Studierende sehen, wie Basis-Vier-Quadrantenbezeichnungen ganzzahlige Indizes erzeugen ohne stilles Clamp oder Gleitkomma-Projektionsschritt.

Logistik- und Privacy-Pipelines, die grobe Pyramidenschlüssel behalten, können eine Charge Quadkeys in begrenzende Kachelindizes für Analytics dekodieren und die Umwandlung rein und offline halten. Wenn Sie später die inverse Kodierung von X Y Zoom in einen Quadkey, Lat Lon zu Slippy-Kachelindizes oder Großkreis-Zielpunkte brauchen, behandeln Sie diese als getrennte Suchabsichten und Landings statt diese Bing-Maps-Quadkey-Decoderseite zu überladen.