ForHosting KIT · Entwickler-Tools

Quadkey in XYZ-Kachel umwandeln: X, Y und Zoom

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.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

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. Dieses Werkzeug nimmt diesen String und liefert die ganzzahlige Kachel X, Y und die Zoomstufe, die er darstellt, plus die Achsenlänge zwei hoch Zoom und einen fertigen z-Schrägstrich-x-Schrägstrich-y-Pfad für URLs und Regressions-Fixtures. Ziffern außerhalb null bis drei, leere Strings und absurd lange Schlüssel scheitern mit einer klaren invalid_input-Meldung statt eines stillen Wrap. Das kostenlose Browser-Widget und die bezahlte API teilen eine reine isomorphe Funktion, sodass Debug-Sitzungen, Prüfungsschlüssel und Batch-Skripte beim selben Quadkey nie auseinanderlaufen.

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

Geben Sie Ihre Werte in das Formular oben ein. Das Werkzeug prüft sie vor der Berechnung und zeigt das Ergebnis auf derselben Seite.

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. Die Länge ist die Zoomstufe und muss höchstens dreißig bleiben, damit zwei hoch Zoom eine praktische ganzzahlige Kachelzahl für Worker und Browser bleibt. Bei Erfolg liefert die Antwort den bereinigten Quadkey-String, ganzzahlige Kachelindizes x und y, zoom und ein gespiegeltes z-Feld, die Achsenlänge n gleich zwei hoch Zoom, einen tile_path-String in z-Schrägstrich-x-Schrägstrich-y-Form, das Method-Tag bing_maps_quadkey und einen kompakten formula-String zur Dokumentation. 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. Der Preis erfolgreicher API-Aufrufe ist die veröffentlichte Basis von $0.002 pro Element; Validierungsfehler wie eine Ziffer fünf mitten im Schlüssel verbrauchen kein Prepaid-Guthaben. 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. QA-Teams, die Referenztests für Bildprodukte schreiben, prüfen, dass ein bekannter Landmark-Quadkey über Releases hinweg immer zur selben Zoom-X-Y-Dreifach expandiert, ohne ein volles Microsoft-SDK in der CI. 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. Weil diese Fähigkeit eine reine Parse-Engine ist, ist der API-Preis die veröffentlichte Basis von dem veröffentlichten Basistarif pro erfolgreichem Element und fehlgeschlagene Validierung wird nicht berechnet. 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.

Bing-Quadkeys zu XYZ-Kachelpfaden migrieren

Dekodieren Sie gespeicherte Bing- oder Azure-Maps-Quadkey-Primärschlüssel in z/x/y für CDN-Warm-up, OpenStreetMap-artige Caches und anbieterübergreifende Kachelvergleiche.

Bild-URLs und Cache-Schlüssel debuggen

Fügen Sie einen Quadkey aus einer Produktions-Kachel-URL ein und gewinnen Sie sofort Kachel X, Y und Zoom, um die passende Pyramidenzelle in einem anderen Kartenclient zu öffnen.

GIS-Hausaufgaben und golden Fixtures

Erzeugen Sie stabile X/Y/Zoom-Dreifache aus Lehrbuch-Quadkeys, damit Lehrende, Autograder und Regressionssuiten eine gemeinsame Bing-Tile-System-Wahrheit teilen.

Was ist ein Bing-Maps-Quadkey?

Ein Basis-Vier-String aus Ziffern 0–3, der den Pfad von der Wurzelkachel zu einem Blatt in der Bing-Maps-/Azure-Maps-Web-Mercator-Pyramide kodiert. Seine Länge ist die Zoomstufe.

Wie hängt Zoom mit dem String zusammen?

Zoom entspricht der Zeichenanzahl. Zum Beispiel ist „213“ immer Zoom 3 und dekodiert zu Kachel X=3, Y=5.

Was geschieht, wenn der Quadkey eine Ziffer außer 0–3 hat?

Die Anfrage schlägt mit invalid_input fehl und benennt das schlechte Zeichen und den Index. Nur Ziffern 0, 1, 2 und 3 sind legal. Fehlgeschlagene Validierung wird nicht berechnet.

Wandelt dies Breite und Länge in eine Kachel um?

Nein. Dieses Landing dekodiert nur einen vorhandenen Quadkey in X, Y und Zoom. Lat/Lon zu Slippy-Kachel ist eine andere Suchabsicht und ein anderes Werkzeug.

Was kostet es?

Das Browser-Werkzeug ist kostenlos und läuft lokal. API-Anfragen nutzen Prepaid-KIT-Guthaben zu dem veröffentlichten Basistarif pro erfolgreichem Element; ungültige Eingabe wird nicht berechnet.

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

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

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

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"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →