Tile a quadkey Bing
Ottenga il quadkey di Bing Maps di qualsiasi tile: la colonna 3, riga 5 allo zoom 3 dà 213, le stesse cifre usate negli indirizzi delle tile e nelle chiavi di cache reali. Accetta livelli di zoom da 1 a 23. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Colonna tile
- 3
- Riga tile
- 5
- Livello di zoom
- 3
- Chiave quadkey
- 213
- Lunghezza
- 3
- Indice massimo
- 7
Bing Maps e molte pipeline di tile Azure Maps identificano ogni quadrato della griglia Web Mercator con una stringa compatta in base 4 chiamata quadkey. Dati la colonna intera di tile X, la riga Y e un livello di zoom di dettaglio, questa capacità costruisce quella stringa con le stesse regole di piegatura di bit pubblicate nella documentazione del sistema di tile Bing Maps di Microsoft, così le cifre che ottiene coincidono con URL di tile di produzione e chiavi di cache. Gli indici di tile fuori intervallo per lo zoom scelto falliscono con un chiaro errore di input non valido invece di inventare un wrap silenzioso.
Cos’è un quadkey Bing Maps e quali X, Y, zoom inviare
Un quadkey è una stringa di cifre da zero a tre la cui lunghezza è uguale al livello di zoom. Ogni cifra codifica un passo di una suddivisione ricorsiva a quadranti del mondo: zero è il figlio nord-ovest, uno il nord-est, due il sud-ovest e tre il sud-est, coincidendo con l’interlacciamento dei bit di tile X e Y dal bit di zoom più significativo al meno significativo.
Invii i campi interi obbligatori x e y per colonna e riga di tile nella griglia Bing Maps, e zoom per il livello di dettaglio tra uno e ventitré. Allo zoom z l’intervallo valido di x e y è l’intervallo chiuso da zero a due alla potenza z meno uno. È lo stesso limite che ogni server di tile conforme impone prima di costruire un percorso URL.
Casi d'uso
Costruttori di URL di tile Bing e Azure
I backend che assemblano percorsi di tile Bing Maps o Azure Maps convertono X/Y/zoom interi in una stringa quadkey allineata a chiavi CDN di produzione e partizioni di cache.
Domande frequenti
Come converto tile X, Y e zoom in un quadkey Bing Maps?
La risposta include la stringa quadkey (213 per quell’esempio classico).
Cosa succede se l’indice di tile è fuori dall’intervallo valido?
Per lo zoom z, x e y devono stare in [0, 2^z − 1]. Gli indici fuori intervallo sono rifiutati e non addebitati.
Quali livelli di zoom sono supportati?
La lunghezza del quadkey è sempre uguale allo zoom.
Lo strumento tile a quadkey Bing Maps è gratis?
Lo strumento browser gira gratis sul Suo dispositivo.
Corrisponde al TileXYToQuadKey di Microsoft?
Sì. La codifica segue le regole di piegatura di bit del sistema di tile Bing Maps: per ogni bit di zoom, aggiunga 1 se X ha il bit e 2 se Y ha il bit.
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-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)Esempio di richiesta
{
"x": 3,
"y": 5,
"zoom": 3
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.quadkey_encode",
"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
Studenti, ingegneri GIS e servizi backend possono fissare il JSON deterministico nei test senza incorporare un SDK cartografico completo.
Cos’è un quadkey Bing Maps e quali X, Y, zoom inviare
Sono accettati gli alias tile_x, tileX e col per x; tile_y, tileY e row per y; e z, level, level_of_detail o lod per zoom quando il Suo client usa già quei nomi. Campi mancanti, non interi, zoom fuori da uno a ventitré e indici di tile negativi o eccessivi falliscono con invalid_input così correttori di compiti e pipeline non accettano mai una coordinata tagliata in silenzio. Input identici producono sempre JSON identico perché il percorso è pura aritmetica di bit senza rete, seme casuale né orologio di sistema.
Come leggere la risposta quadkey e validare i limiti di tile
Preferisca i campi strutturati all’analisi del quadkey a mano quando serve solo metadati di limiti; conservi la stringa quando deve costruire percorsi di tile Bing o Azure che incorporano la chiave direttamente. In caso di successo la risposta ripete x, y e zoom normalizzati, restituisce la stringa quadkey, imposta length uguale a zoom così i client possono asserire il conteggio cifre senza contare i caratteri a mano, e include max_index uguale a due alla potenza zoom meno uno come limite superiore inclusivo applicato in validazione. L’etichetta method è sempre bing_maps_tile_xy_to_quadkey così il codice a valle può ramificare senza sniffare le forme quando mescola questo encoder con geohash o altre chiavi spaziali. Quando una richiesta fallisce perché x o y cade fuori da zero a max_index, il messaggio di errore nomina l’asse errato e l’intervallo valido per quello zoom, facilitando il debug di errori di uno in convertitori lat-lon a tile.
Uso dell’API, prezzi, flussi mappa e limiti pratici
Invii un corpo JSON con gli interi obbligatori x, y e zoom. Chiami lo strumento gratuito nel browser da tile a quadkey Bing per demo in aula, controlli mentali rapidi di coordinate TMS e verifica locale senza installare un SDK mappe. Usi l’API prepagata quando una cache di tile, un purgatore CDN, un job ETL GIS, un impacchettatore offline mobile o una piattaforma educativa necessitano di un contratto stabile sotto saldo KIT a $0.002 per elemento riuscito; i fallimenti di validazione non consumano mai saldo dopo il rifiuto del motore. Lo zoom è limitato a ventitré per coprire livelli di dettaglio mappa pratici tenendo il loop di bit limitato su un Worker. Autori che distribuiscono SDK possono mappare il campo quadkey direttamente in modelli URL della forma percorso barra quadkey punto formato immagine usati dagli endpoint classici di tile Bing.
Casi di integrazione
Fixture di pipeline GIS e oracoli CI
I team fissano tile noti come x=3, y=5, zoom=3 → 213 affinché i refactor di proiezione e TMS non cambino in silenzio l’indirizzamento spaziale.
Insegnare il sistema di tile Bing Maps
Istruttori e studenti codificano a mano piccoli livelli di zoom, confrontano con l’API e imparano come i bit di X e Y si piegano in cifre in base 4.