ForHosting KIT · Reisen und Geografie

Kachel zu Bing-Quadkey

Ermitteln Sie den Bing-Maps-Quadkey jeder Kachel: Spalte 3, Zeile 5 bei Zoom 3 ergibt 213, dieselben Ziffern wie in echten Kacheladressen und Cache-Schlüsseln. Zoomstufen von 1 bis 23 sind möglich. Kostenlos in Ihrem Browser.

Kostenlos
Läuft in Ihrem Browser
Ohne Anmeldung
Ihre Daten bleiben auf Ihrem Gerät

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Rechenbeispiel

Wenn Sie eingeben

Kachelspalte: 3
Kachelzeile: 5
Zoomstufe: 3

Erhalten Sie

Quadkey-Schlüssel: 213
Länge: 3
Maximalindex: 7

Bing Maps und viele Azure-Maps-Kachel-Pipelines kennzeichnen jedes Quadrat auf dem Web-Mercator-Gitter mit einem kompakten Basis-4-String namens Quadkey. Bei ganzzahliger Kachelspalte X, Kachelzeile Y und einer Zoom-Detailstufe baut diese Fähigkeit diesen String mit denselben Bit-Faltungsregeln aus Microsofts Bing-Maps-Tile-System-Dokumentation, sodass die Ziffern mit Produktions-Kachel-URLs und Cache-Schlüsseln übereinstimmen. Außerhalb des gültigen Bereichs liegende Kachelindizes für den gewählten Zoom scheitern mit einem klaren Fehler für ungültige Eingabe statt eines stillen Wrap.

Wie ein Quadkey X und Y in eine Zeichenfolge packt

Ein Quadkey ist eine kurze Folge der Ziffern 0 bis 3, die ein Quadrat im Web-Mercator-Kachelraster von Bing Maps und Azure Maps bezeichnet. Stellen Sie sich vor, die Welt wird in vier Viertel geteilt und jedes Viertel pro Zoomstufe erneut in vier. Jede Ziffer hält fest, welches Viertel auf dieser Stufe gewählt wurde: 0 für Nordwesten, 1 für Nordosten, 2 für Südwesten und 3 für Südosten. Dafür werden die Bits von Spalte und Zeile von der höchsten zur niedrigsten Stufe gelesen und je ein Bit beider Werte zu einer Ziffer verbunden. Deshalb hat der Schlüssel immer so viele Ziffern wie die Zoomstufe: Spalte 3, Zeile 5 bei Zoom 3 wird zu 213.

Wann Sie ihn brauchen und welche Fehler er abfängt

Sie brauchen ihn, wenn Sie Kacheladressen für Bing oder Azure Maps bauen, denselben Schlüssel wie ein Kachel-Cache benötigen oder Übungsaufgaben zu Kachelsystemen prüfen. Der häufigste Fehler ist eine Spalte oder Zeile, die es auf der gewählten Stufe nicht gibt: Bei Zoom 3 müssen beide zwischen 0 und 7 liegen, größere Werte werden abgelehnt statt still umgebrochen. Auch negative Zahlen und Werte mit Nachkommastellen werden zurückgewiesen, und die Zoomstufe muss eine ganze Zahl von 1 bis 23 sein.

Was ein Bing-Maps-Quadkey ist und welche X, Y, Zoom Sie senden

Ein Quadkey ist ein String aus Ziffern null bis drei, dessen Länge der Zoomstufe entspricht. Jede Ziffer kodiert einen Schritt einer rekursiven Quadranten-Teilung der Welt: null ist das nordwestliche Kind, eins das nordöstliche, zwei das südwestliche und drei das südöstliche, passend zur Verschränkung der Kachel-X- und Y-Bits vom höchstwertigen Zoom-Bit zum niederwertigsten. Senden Sie die Pflicht-Ganzzahlfelder x und y für Kachelspalte und -zeile im Bing-Maps-Gitter sowie zoom für die Detailstufe zwischen eins und dreiundzwanzig.

Bei Zoom z ist der gültige Bereich für x und y das geschlossene Intervall von null bis zwei hoch z minus eins. Das ist dieselbe Schranke, die jeder konforme Kachelserver vor dem Bau eines URL-Pfads erzwingt.

Anwendungsfälle

Bing- und Azure-Kachel-URL-Builder

Backends, die Bing-Maps- oder Azure-Maps-Kachelpfade zusammenbauen, wandeln ganzzahlige X/Y/Zoom in einen Quadkey-String um, der zu Produktions-CDN-Schlüsseln und Cache-Partitionen passt.

Häufige Fragen

Wie wandle ich Kachel X, Y und Zoom in einen Bing-Maps-Quadkey um?

Die Antwort enthält den Quadkey-String (213 für dieses klassische Beispiel).

Was geschieht, wenn der Kachelindex außerhalb des gültigen Bereichs liegt?

Für Zoom z müssen x und y in [0, 2^z − 1] liegen. Außerhalb liegende Indizes werden abgelehnt und nicht berechnet.

Stimmt das mit Microsofts TileXYToQuadKey überein?

Ja. Die Kodierung folgt den Bit-Faltungsregeln des Bing Maps Tile System: für jedes Zoom-Bit addieren Sie 1, wenn X das Bit hat, und 2, wenn Y das Bit hat.

Welche Zoomstufen kann ich verwenden?

Jede ganze Zahl von 1 bis 23. Bei jeder Zoomstufe müssen X und Y zwischen 0 und 2 hoch Zoom minus 1 liegen, bei Zoom 3 ist der größte erlaubte Index also 7.

Was bedeutet jede Ziffer des erzeugten Quadkeys?

Jede Ziffer nennt das gewählte Viertel auf einer Zoomstufe: 0 steht für Nordwesten, 1 für Nordosten, 2 für Südwesten und 3 für Südosten. Die erste Ziffer ist die gröbste Teilung, die letzte die feinste.

Für Entwickler — API-Zugang

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.

Endpunkt

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

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

Aufruf aus Ihrem 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)

Beispiel-Anfrage

{
  "x": 3,
  "y": 5,
  "zoom": 3
}

Beispiel-Antwort

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

Preis

pro Anfrage$0.002

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

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Technische Hinweise

Studierende, GIS-Ingenieure und Backend-Dienste können das deterministische JSON in Tests festnageln, ohne ein volles Mapping-SDK einzubetten.

Was ein Bing-Maps-Quadkey ist und welche X, Y, Zoom Sie senden

Aliasse tile_x, tileX und col werden für x akzeptiert; tile_y, tileY und row für y; und z, level, level_of_detail oder lod für zoom, wenn Ihr Client diese Namen bereits nutzt. Fehlende Felder, Nicht-Ganzzahlen, Zoom außerhalb eins bis dreiundzwanzig und negative oder überdimensionierte Kachelindizes scheitern mit invalid_input, damit Hausaufgaben-Checker und Pipelines nie eine still abgeschnittene Koordinate akzeptieren. Identische Eingaben erzeugen immer identisches JSON, weil der Pfad reine Bitarithmetik ohne Netzwerk, Zufallsseed und Wanduhr ist.

Quadkey-Antwort lesen und Kachelgrenzen prüfen

Bevorzugen Sie die strukturierten Felder statt den Quadkey selbst zu parsen, wenn Sie nur Grenz-Metadaten brauchen; behalten Sie den String, wenn Sie Bing- oder Azure-Kachelpfade bauen müssen, die den Schlüssel direkt einbetten. Bei Erfolg spiegelt die Antwort normalisierte x, y und zoom wider, liefert den Quadkey-String, setzt length gleich zoom, damit Clients die Ziffernzahl ohne manuelles Zeichenzählen prüfen können, und enthält max_index gleich zwei hoch Zoom minus eins als inklusive Obergrenze der Validierung. Die Methodenbezeichnung ist stets bing_maps_tile_xy_to_quadkey, damit nachgelagerter Code verzweigen kann, ohne Formen zu erschnüffeln, wenn Sie diesen Encoder mit Geohash oder anderen Raumschlüsseln mischen. Wenn eine Anfrage scheitert, weil x oder y außerhalb null bis max_index liegt, nennt die Fehlermeldung die schlechte Achse und den gültigen Bereich für diesen Zoom, was Off-by-one-Fehler in Lat-Lon-zu-Kachel-Konvertern erleichtert.

API-Nutzung, Preise, Kartenabläufe und praktische Grenzen

Autoren, die SDKs ausliefern, können das Quadkey-Feld direkt in URL-Vorlagen der Form Pfad Schrägstrich Quadkey Punkt Bildformat abbilden, die klassische Bing-Kachel-Endpunkte nutzen. Senden Sie einen JSON-Body mit den Pflicht-Ganzzahlen x, y und zoom. Rufen Sie das kostenlose Browser-Werkzeug Kachel zu Bing-Quadkey für Kursdemos, schnelle mentale Checks von TMS-Koordinaten und lokale Prüfung ohne Maps-SDK auf. Nutzen Sie die Prepaid-API, wenn ein Kachel-Cache, ein CDN-Purger, ein GIS-ETL-Job, ein mobiles Offline-Packager oder eine Bildungsplattform einen stabilen Vertrag unter KIT-Guthaben zu $0.002 pro erfolgreichem Element braucht; Validierungsfehler verbrauchen nie Guthaben nach Ablehnung durch die Engine. Zoom ist auf dreiundzwanzig begrenzt, um praktische Kartendetailstufen abzudecken und die Bit-Schleife auf einem Worker begrenzt zu halten.

Integrationsbeispiele

GIS-Pipeline-Fixtures und CI-Orakel

Teams pinnen bekannte Kacheln wie x=3, y=5, zoom=3 → 213, damit Projektions- und TMS-Refactors die räumliche Adressierung nicht still ändern.

Das Bing Maps Tile System lehren

Lehrende und Studierende kodieren kleine Zoomstufen von Hand, vergleichen mit der API und lernen, wie X- und Y-Bits in Basis-4-Ziffern falten.

Technische Fragen

Welche Zoomstufen werden unterstützt?

Zoom (Aliasse z, level, level_of_detail, lod) muss eine Ganzzahl von 1 bis 23 sein. Die Quadkey-Länge entspricht stets dem Zoom.

Ist das Werkzeug Kachel zu Bing-Maps-Quadkey kostenlos?

Das Browser-Werkzeug läuft kostenlos auf Ihrem Gerät. API-Aufrufe nutzen Prepaid-KIT-Guthaben zu $0.002 pro erfolgreichem Element; Validierungsfehler werden nicht berechnet.

Vollständige KIT-Dokumentation lesen →

Kachel zu Bing-Quadkey

Im Browser ausführen – kostenlos

Rechenbeispiel

Wie ein Quadkey X und Y in eine Zeichenfolge packt

Wann Sie ihn brauchen und welche Fehler er abfängt

Was ein Bing-Maps-Quadkey ist und welche X, Y, Zoom Sie senden

Anwendungsfälle

Bing- und Azure-Kachel-URL-Builder

Häufige Fragen

Verwandte Tools

Für Entwickler — API-Zugang

Endpunkt

Aufruf aus Ihrem Stack

Beispiel-Anfrage

Beispiel-Antwort

Preis

Fehler

Technische Hinweise

Was ein Bing-Maps-Quadkey ist und welche X, Y, Zoom Sie senden

Quadkey-Antwort lesen und Kachelgrenzen prüfen

API-Nutzung, Preise, Kartenabläufe und praktische Grenzen

Integrationsbeispiele

GIS-Pipeline-Fixtures und CI-Orakel

Das Bing Maps Tile System lehren

Technische Fragen

danke