Decodificatore quadkey Bing
Riporti un quadkey di Bing Maps alla tile che indica: 213 è la colonna 3, riga 5 allo zoom 3, pronta da usare come percorso 3/3/5. Utile per controllare una chiave di cache o spostare tile su un server XYZ. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Chiave quadkey
- 213
- X
- 3
- Y
- 5
- Livello di zoom
- 3
- Z
- 3
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. 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.
Come un quadkey Bing Maps diventa tile X, Y e zoom
Il sistema di tile Microsoft Bing Maps costruisce una piramide quadrata in Web Mercator. Allo zoom uno il mondo si divide in quattro quadranti figli etichettati zero, uno, due e tre; ogni zoom più profondo aggiunge un’altra cifra suddividendo il genitore. Leggere la stringa da sinistra a destra cammina quindi dal bit più grossolano al più fine degli indici di tile.
Lo zoom è uguale alla lunghezza della stringa: una chiave di tre caratteri come due uno tre è sempre zoom tre, e una chiave di sedici caratteri è sempre zoom sedici. Per recuperare X e Y, inizializzi entrambe le coordinate a zero, poi per ogni posizione di bit dalla più significativa alla meno significativa applichi una maschera binaria di uno spostato a sinistra della profondità rimanente. La cifra zero lascia entrambi i bit a zero, uno imposta il bit X, due il bit Y e tre entrambi i bit.
Controlli classici di documentazione includono la chiave due uno tre che decodifica a X uguale a tre e Y uguale a cinque allo zoom tre, e la cifra singola uno a X uguale a uno e Y uguale a zero allo zoom uno.
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. 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. 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.
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.
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.
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.
Cosa succede se il quadkey ha una cifra diversa da 0–3?
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.
Strumenti correlati
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-decode \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"quadkey":"213"}'const res = await fetch("https://api.kit.forhosting.com/geo/quadkey-decode", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"quadkey": "213"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/quadkey-decode",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"quadkey": "213"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/quadkey-decode", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"quadkey":"213"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"quadkey":"213"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/quadkey-decode", 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": "213"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.quadkey_decode",
"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. |
Note tecniche
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.
Come un quadkey Bing Maps diventa tile X, Y e zoom
Dopo aver applicato ogni cifra, X e Y sono interi non negativi nell’intervallo semiaperto da zero a due alla potenza dello zoom meno uno, corrispondente allo schema familiare z barra x barra y dei server stile OpenStreetMap una volta noto lo zoom. Input vuoto e qualsiasi carattere fuori dalle quattro cifre legali sono rifiutati con invalid_input prima che sia calcolato qualsiasi indice.
Cosa invia e cosa ottiene in risposta
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. 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.
Dove la decodifica di quadkey Bing compare nel lavoro reale
Poiché questa capacità è un motore di parse puro, il prezzo API è la base pubblicata di $0.002 per elemento riuscito e la validazione fallita non consuma saldo.
Casi di integrazione
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.