ForHosting KIT · Strumenti per sviluppatori

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.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

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.

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.

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.

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.

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

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

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

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →