Convertitore da quadkey a tile XYZ: X, Y e zoom
Un quadkey Bing Maps è un indirizzo compatto in base quattro di un quadrato nella piramide globale di tile Web Mercator usata da Bing Maps, Azure Maps e molte cache di tile compatibili.
Esegui gratis nel browser
Invece di tre interi separati per zoom, colonna e riga, una sola stringa di cifre da zero a tre codifica il percorso completo dalla tile radice a una foglia. Questo strumento prende quella stringa e restituisce la tile intera X, Y e il livello di zoom che rappresenta, più la lunghezza dell’asse due alla potenza dello zoom e un percorso pronto z barra x barra y per URL e fixture di regressione. Cifre fuori da zero a tre, stringhe vuote e chiavi assurdamente lunghe falliscono con un messaggio invalid_input chiaro invece di inventare un wrap silenzioso. Il widget gratuito del browser e l’API a pagamento condividono una sola funzione isomorfa pura, così sessioni di debug, chiavi d’esame e script batch non divergono mai sullo stesso quadkey.
Come un quadkey Bing Maps diventa tile X, Y e zoom
Inserisci i dati nel modulo qui sopra. Lo strumento li controlla prima del calcolo e mostra il risultato nella stessa pagina.
Cosa invia e cosa ottiene in risposta
Invii una stringa obbligatoria sotto il campo quadkey. Il valore deve essere una sequenza non vuota delle sole cifre zero, uno, due e tre; gli spazi sono ritagliati ai bordi, ma spazi interni e lettere falliscono la validazione. Alias comuni come quadKey e qk sono accettati al parse mentre la risposta eco sempre il nome di campo canonico. La lunghezza è il livello di zoom e deve restare al massimo trenta affinché due alla potenza dello zoom resti un conteggio di tile intero pratico per Worker e browser. In caso di successo la risposta restituisce la stringa quadkey pulita, indici di tile interi x e y, zoom e un campo z specchio, la lunghezza dell’asse n uguale a due alla potenza dello zoom, una stringa tile_path in forma z barra x barra y, il tag method bing_maps_quadkey e una stringa formula compatta per documentazione. Usi il modulo gratuito del browser quando ispeziona una chiave di cache sospetta da un URL Bing o Azure Maps e serve la terna XYZ subito. Chiami lo stesso contratto da script quando migra un archivio di quadkey a un CDN di tile XYZ, genera chiavi di risposta per corsi GIS o asserisce che un quadkey di monumento fisso mappa ancora sulla stessa colonna e riga dopo un aggiornamento di libreria. Il prezzo delle chiamate API riuscite è la base pubblicata di $0.002 per elemento; i fallimenti di validazione come una cifra cinque in mezzo alla chiave non consumano saldo prepagato. Abbini questo decodificatore a un encoder separato o a un landing lat-lon a tile quando il flusso richiede la direzione inversa anziché sovraccaricare un unico modulo.
Dove la decodifica di quadkey Bing compare nel lavoro reale
Gli ingegneri di piattaforme mappe ricevono costantemente URL di tile Bing o Azure Maps che incorporano un segmento di percorso quadkey e necessitano della colonna e riga equivalenti per una cache XYZ, una sovrapposizione di debug o un confronto con tile OpenStreetMap della stessa cella di piramide. I servizi backend che storicamente memorizzavano solo quadkey come chiavi primarie compatte hanno ancora bisogno di una forma chiusa affidabile per unirsi a shard di mappe scorrevoli, riscaldare regioni CDN o esportare entità GeoJSON indicizzate per z barra x barra y. I team QA che scrivono test golden per prodotti di immagini affermano che un quadkey di monumento noto si espande sempre alla stessa terna zoom, X e Y tra le release senza dipendere da un SDK Microsoft completo in integrazione continua. Gli autori di curriculum che insegnano mappatura web e GIS vogliono che gli studenti vedano etichette di quadrante in base quattro produrre indici interi senza un clamp silenzioso né un passo di proiezione in virgola mobile. Pipeline di logistica e privacy che conservano chiavi di piramide grossolane possono decodificare un lotto di quadkey in indici di tile di confine per analytics mantenendo la conversione pura e offline. Poiché questa capacità è un motore di parse puro, il prezzo API è la base pubblicata di la tariffa base pubblicata per elemento riuscito e la validazione fallita non consuma saldo. Se in seguito Le serve la codifica inversa di X Y zoom in un quadkey, lat lon a indici di tile slippy o punti di destinazione di grande cerchio, li tratti come intenti di ricerca e landing separati anziché sovraccaricare questa pagina del decodificatore di quadkey Bing Maps.
Casi d'uso
Migrare quadkey Bing a percorsi tile XYZ
Decodifichi chiavi primarie quadkey Bing o Azure Maps memorizzate in z/x/y per riscaldamento CDN, cache stile OpenStreetMap e confronti di tile multi-fornitore.
Debug di URL di immagini e chiavi di cache
Incolli un quadkey da un URL di tile di produzione e recuperi all’istante tile X, Y e zoom per aprire la cella di piramide corrispondente in un altro client mappa.
Compiti GIS e fixture golden
Generi terne X/Y/zoom stabili da quadkey da manuale affinché istruttori, auto-valutatori e suite di regressione condividano una verità del sistema di tile Bing.
Domande frequenti
Cos’è un quadkey Bing Maps?
Una stringa in base quattro di cifre 0–3 che codifica il percorso dalla tile radice a una foglia nella piramide Web Mercator Bing Maps / Azure Maps. La sua lunghezza è il livello di zoom.
Come si relaziona lo zoom alla stringa?
Lo zoom è uguale al numero di caratteri. Ad esempio, "213" è sempre zoom 3 e decodifica in tile X=3, Y=5.
Cosa succede se il quadkey ha una cifra diversa da 0–3?
La richiesta fallisce con invalid_input che nomina il carattere errato e l’indice. Sono legali solo le cifre 0, 1, 2 e 3. La validazione fallita non viene addebitata.
Questo converte latitudine e longitudine in una tile?
No. Questo landing decodifica solo un quadkey esistente in X, Y e zoom. Lat/lon a tile slippy è un altro intento di ricerca e strumento.
Quanto costa?
Lo strumento browser è gratis e gira in locale. Le richieste API usano saldo KIT prepagato a la tariffa base pubblicata per elemento riuscito; l’input non valido non viene addebitato.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
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"}'const res = await fetch("https://api.kit.forhosting.com/geo/quadkey-to-tile", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"quadkey": "1203"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/quadkey-to-tile",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"quadkey": "1203"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/quadkey-to-tile", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"quadkey":"1203"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"quadkey":"1203"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/quadkey-to-tile", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"quadkey": "1203"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.quadkey_to_tile",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |