Metri per pixel Web Mercator
Scopra quanti metri di terreno copre un pixel su una mappa Web Mercator: a zoom 12 sull'equatore sono 38,2185141426 m, la metà a ogni livello di zoom in più e meno verso i poli. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Livello di zoom
- 12
- Latitudine in gradi decimali
- 0
- Metri per pixel
- 38,2185141426
- Metri per tile
- 9783,9396205
- Circonferenza alla latitudine in m
- 40.075.016,6856
- Circonferenza equatoriale in m
- 40.075.016,6856
La risoluzione al suolo in Web Mercator risponde a una domanda cartografica molto pratica: a questo livello di zoom e a questa latitudine, quanti metri di terreno rappresenta un pixel della mappa? All’equatore e con zoom zero si ritrova la nota costante di circa centocinquantaseimilacinquecentoquarantatré metri per pixel; ogni passo di zoom dimezza quel valore e le latitudini più alte lo riducono secondo cos(latitudine). Lo zoom negativo e la latitudine fuori dall’intervallo geografico vengono rifiutati con un chiaro errore di validazione invece di inventare una risoluzione fasulla.
Come vengono calcolati i metri per pixel in Web Mercator
Si parte dal raggio equatoriale usato da Web Mercator e da quasi tutti gli stack commerciali di tile XYZ: R equivale a sei milioni trecentosettantottomilacentotrentasette metri. La circonferenza equatoriale completa è due pi greco R. I tile slippy-map misurano duecentocinquantasei pixel di lato e, allo zoom z, il mondo è coperto da due elevato alla z tile lungo ciascun asse, quindi l’equatore è rappresentato da duecentocinquantasei volte due elevato alla z pixel da ovest a est.
La risoluzione al suolo sull’equatore è dunque la circonferenza divisa per quel numero di pixel. Lontano dall’equatore, i meridiani mantengono la stessa lunghezza nella matematica della proiezione, ma i cerchi paralleli si restringono con il coseno della latitudine geodetica, quindi si moltiplica per cos(phi) misurato in radianti. Lo zoom deve essere un intero non negativo in un intervallo slippy pratico; lo zoom negativo non ha senso in una piramide discreta e viene rifiutato.
I poli sono ammessi e portano correttamente il coseno verso lo zero, così i metri per pixel collassano, in linea con il fatto geometrico che un pixel est-ovest copre una distanza al suolo che svanisce vicino ai poli in questo modello.
Cosa invia e cosa riceve in risposta
Invii due numeri: lo zoom come livello intero non negativo di slippy-map e la latitudine come valore finito in gradi decimali con il nord positivo. Entrambi i campi sono obbligatori. Lo zoom negativo fallisce con un messaggio che indica che lo zoom deve essere non negativo; la latitudine al di fuori dell’intervallo da meno novanta a più novanta fallisce con un messaggio out-of-range, così i client possono correggere errori del GPS o del geocodificatore invece di tirare a indovinare.
I controlli classici includono lo zoom dodici all’equatore per circa trentotto metri per pixel, lo zoom zero a latitudine zero per la costante di risoluzione iniziale completa e uno zoom urbano di latitudine media come dodici vicino a cinquantuno gradi, che dà un valore di metri per pixel visibilmente inferiore rispetto all’equatore.
Dove compaiono i calcolatori di metri per pixel nel lavoro reale
I team di prodotto che lavorano sulle mappe hanno bisogno di barre di scala e di testi del tipo «circa N metri in questa vista» che restino onesti mentre gli utenti si spostano verso nord o verso sud; fissare una costante equatoriale alle alte latitudini trae in inganno autisti e operatori sul campo. Le pipeline di dati geospaziali convertono le tolleranze in pixel provenienti da visione artificiale o analisi raster in distanze al suolo prima di applicare buffer alle feature o decidere se due rilevamenti sono lo stesso oggetto.
I pacchetti offline per dispositivi mobili e gli algoritmi di aggregazione scelgono raggi in metri che devono corrispondere a pixel di tile a uno zoom obiettivo, senza importare un pesante stack di proiezioni in ogni worker. Gli esercizi didattici e i colloqui tecnici chiedono spesso la formula di risoluzione di OSM; un unico oracolo affidabile che restituisce i metri per pixel insieme a utilità di circonferenza accelera la valutazione e la preparazione delle demo.
Se in seguito Le serviranno indici di tile X/Y da lat/lon, decodifica di quadkey Bing, distanza di cerchio massimo o punti di destinazione lungo una rotta, li tratti come intenti di ricerca e pagine di destinazione separati invece di sovraccaricare questa pagina sulla risoluzione al suolo — l’intento SEO qui è specificamente i metri per pixel Web Mercator da zoom e latitudine.
Casi d'uso
Barre di scala ed etichette «metri in questa vista»
Converta lo zoom attuale e la latitudine del centro della mappa in metri per pixel, così le barre di scala e i badge di distanza restano accurati quando gli utenti si avvicinano ai poli.
Dalle tolleranze in pixel ai buffer al suolo
Trasformi soglie in pixel di visione artificiale o di raggio di clic in metri per applicare buffer alle feature e deduplicare i rilevamenti a uno zoom di tile scelto.
Raggi di aggregazione e pacchetti di tile offline
Scelga raggi di aggregazione e di ricerca in metri che corrispondano a uno zoom slippy obiettivo, senza distribuire una libreria di proiezioni completa a ogni worker perimetrale.
Domande frequenti
Cosa succede se lo zoom è negativo?
Lo zoom negativo non è definito per le piramidi slippy-map; lo zoom deve essere un intero non negativo (in pratica da 0 a 30).
Quale intervallo di latitudine è accettato?
La latitudine deve trovarsi nell’intervallo chiuso [-90, 90] gradi. I valori al di fuori vengono rifiutati come fuori intervallo. Vicino ai poli, cos(φ) porta i metri per pixel verso lo zero.
Perché il raggio terrestre è 6378137 metri?
È il raggio equatoriale WGS84 usato da Web Mercator (EPSG:3857). La costante classica di ~156543.0339 m/px allo zoom 0 sull’equatore presuppone questo raggio e tile da 256 px.
Quanto costa?
Lo strumento nel browser è gratuito e funziona in locale.
Quanto cambia il risultato a ogni livello di zoom?
Ogni livello di zoom in più dimezza i metri per pixel. All'equatore, a zoom 0, un pixel copre circa 156.543 metri; a zoom 12 scende a 38,2185141426 metri.
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/meters-per-pixel \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"zoom":12,"latitude":0}'const res = await fetch("https://api.kit.forhosting.com/geo/meters-per-pixel", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"zoom": 12,
"latitude": 0
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/meters-per-pixel",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"zoom": 12,
"latitude": 0
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/meters-per-pixel", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"zoom":12,"latitude":0}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"zoom":12,"latitude":0}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/meters-per-pixel", 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
{
"zoom": 12,
"latitude": 0
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.meters_per_pixel",
"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
I server di tile, gli SDK mobili e i notebook GIS hanno tutti bisogno di quel numero per dimensionare i buffer, disegnare le barre di scala, scegliere raggi di aggregazione sensati e convertire le distanze sullo schermo in distanze geografiche senza passare per una libreria di proiezioni completa. La formula classica moltiplica la circonferenza equatoriale della sfera WGS84 usata da EPSG:3857 per il coseno della latitudine e la divide per il numero di pixel che coprono il mondo a quel zoom: duecentocinquantasei volte due elevato al livello di zoom. Questa capacità restituisce i metri per pixel insieme a utilità come i metri per bordo del tile e la circonferenza alla latitudine, così Lei può alimentare l’interfaccia di scala, le soglie di aggancio e i payload dell’API da un unico percorso di parse deterministico.
Come vengono calcolati i metri per pixel in Web Mercator
Mettendo insieme i pezzi si ottiene che meters_per_pixel è uguale a cos(phi) per due pi greco R diviso per tile_size per due elevato alla z — o, in modo equivalente, la costante di risoluzione iniziale pubblicata per cos(phi) fratto due elevato alla z. Il risultato è aritmetica in virgola mobile deterministica: nessun seme casuale, nessun timestamp, nessuna chiamata di rete e nessuna deriva del modello, quindi zoom e latitudine identici producono sempre un JSON identico. La latitudine deve trovarsi nell’intervallo geografico chiuso da meno novanta a più novanta gradi; i valori al di fuori non sono latitudini terrestri valide e falliscono con invalid_input.
Cosa invia e cosa riceve in risposta
Campi mancanti, stringhe non numeriche, NaN e Infinity falliscono con invalid_input e non vengono addebitati. In caso di successo, la risposta riporta zoom e latitudine ripuliti, il valore principale meters_per_pixel, meters_per_tile come quel valore per duecentocinquantasei, circumference_at_latitude_m per i calcoli della barra di scala, equatorial_circumference_m come riferimento, initial_resolution_m_per_px allo zoom zero sull’equatore, earth_radius_m, tile_size_px, un’etichetta del metodo e una stringa compatta con la formula. Il prezzo delle chiamate API riuscite è la base pubblicata di $0.002 per elemento; i fallimenti di validazione non consumano saldo prepagato.
Dove compaiono i calcolatori di metri per pixel nel lavoro reale
Poiché questa capacità è un motore di parse puro, il prezzo dell’API è la base pubblicata di $0.002 per elemento riuscito e la validazione fallita non consuma saldo.
Domande tecniche
Quale formula usa questo calcolatore di metri per pixel?
La risoluzione al suolo Web Mercator: mpp = cos(φ) · 2πR / (tile_size · 2^z) con R = 6378137 m e tile_size = 256, secondo le convenzioni EPSG:3857 / OSM / Mapbox.