Risoluzione al suolo Web Mercator
All'equatore e con zoom 0, un pixel di una mappa web standard copre 156.543,033928 m e un tassello completo da 256 pixel 40.075.016,6856 m. Ogni livello di zoom dimezza il valore e le latitudini elevate lo riducono ancora. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Latitudine
- 0
- Livello di zoom
- 0
- Metri per pixel
- 156.543,033928
- Metri per tessera
- 40.075.016,6856
- Dimensione della tessera (px)
- 256
- Raggio terrestre (m)
- 6.378.137
Questo calcolatore indica quanti metri reali rappresenta un pixel Web Mercator a una data latitudine e livello di zoom. Usa la sfera EPSG:3857, tasselli da 256 pixel e la comune piramide XYZ. Il risultato consente di convertire distanze sullo schermo, dimensionare simboli, creare barre di scala e scegliere immagini con il dettaglio desiderato. Il calcolo è deterministico, non usa la rete e restituisce anche la larghezza al suolo di un tassello completo.
Comprenda che cosa misura la risoluzione al suolo
La risoluzione al suolo esprime la distanza reale approssimativa coperta da un pixel della mappa, di solito in metri per pixel. Non è la risoluzione del monitor, la precisione GPS o il dettaglio nativo di una foto aerea. Collega invece la griglia digitale Web Mercator alla distanza terrestre a una latitudine specifica.
Allo zoom zero il mondo proiettato occupa un tassello da 256 pixel. Ogni aumento dello zoom raddoppia i tasselli in entrambe le direzioni e dimezza la distanza per pixel. La latitudine conta perché Web Mercator dilata la scala vicino ai poli: allo stesso zoom un pixel copre meno terreno est-ovest lontano dall’equatore.
Come funziona la formula Web Mercator
Il calcolatore usa il raggio equatoriale 6,378,137 metri adottato da EPSG:3857. Calcola prima la circonferenza sferica come due per pi per il raggio. Dividendola per 256 ottiene la risoluzione iniziale all’equatore e allo zoom zero.
Poi divide per due elevato allo zoom e moltiplica per il coseno della latitudine in radianti. In breve, la risoluzione è cos(latitudine) per 2πR, diviso 256 per 2^zoom. La risposta presuppone tasselli logici standard da 256 pixel.
Con immagini da 512 pixel, Lei deve verificare le convenzioni di tassello e zoom. Sono ammessi solo zoom interi da zero a trenta e latitudini entro il limite pratico Web Mercator di circa ±85.05112878 gradi. Il controllo evita di presentare come valida una posizione esterna al mondo finito della mappa.
Usi il risultato senza sovrastimarne la precisione
Tratti la risoluzione come conversione di scala, non come garanzia sull’accuratezza dei dati. Due metri per pixel indicano che una linea di dieci pixel copre circa venti metri vicino alla latitudine scelta, ma strada, immagine o posizione possono avere un’incertezza maggiore. Anche la scala varia nella vista con la latitudine: il centro basta normalmente per una mappa interattiva, mentre un’esportazione regionale alta può richiedere più campioni.
Il valore aiuta a scegliere raggi di raggruppamento, convertire tolleranze di clic, stimare l’impronta raster ed etichettare barre di scala. Ogni livello intero dimezza i metri per pixel. A parità di zoom, latitudini assolute maggiori producono valori minori per l’effetto del coseno.
Casi d'uso
Creare una barra di scala accurata
Converta una larghezza in pixel alla latitudine centrale in una distanza approssimativa da mostrare.
Scegliere raggi di raggruppamento e selezione
Trasformi soglie dell’interfaccia in pixel in metri per uno zoom e una latitudine.
Pianificare esportazioni raster
Stimi la larghezza al suolo di tasselli o pixel prima di richiedere o elaborare immagini cartografiche.
Domande frequenti
Quale formula usa il calcolatore?
Usa cos(latitudine) × 2π × 6378137 diviso 256 × 2^zoom, convertendo prima la latitudine in radianti.
Perché la risoluzione cambia con la latitudine?
Web Mercator dilata la scala verso i poli, quindi un pixel proiettato rappresenta meno terreno alle alte latitudini.
Quale dimensione del tassello viene usata?
Il calcolo presuppone la dimensione logica convenzionale di 256 pixel per i tasselli slippy map.
Posso usare uno zoom frazionario?
No. Questa capacità accetta livelli interi della piramide di tasselli da 0 a 30.
Come trasformo una distanza sullo schermo in metri sul terreno?
Moltiplichi i metri per pixel per la larghezza in pixel misurata sulla mappa. Il valore vale vicino alla latitudine indicata, quindi lo ricalcoli se si sposta molto verso nord o verso sud.
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/web-mercator-ground-resolution \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":40.7128,"zoom":12}'const res = await fetch("https://api.kit.forhosting.com/geo/web-mercator-ground-resolution", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"latitude": 40.7128,
"zoom": 12
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/web-mercator-ground-resolution",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"latitude": 40.7128,
"zoom": 12
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/web-mercator-ground-resolution", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"latitude":40.7128,"zoom":12}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"latitude":40.7128,"zoom":12}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/web-mercator-ground-resolution", 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
{
"latitude": 40.7128,
"zoom": 12
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.web_mercator_ground_resolution",
"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
Comprenda che cosa misura la risoluzione al suolo
Lei può usare meters_per_pixel per stime vicine alla latitudine fornita e moltiplicarlo per una larghezza in pixel. meters_per_tile applica la stessa risoluzione all’intero tassello XYZ.
Usi il risultato senza sovrastimarne la precisione
L’API costa $0.002 per elemento riuscito ed esegue lo stesso calcolo deterministico del browser.
Domande tecniche
Quanto costa una richiesta API?
Ogni elemento elaborato correttamente costa $0.002. Un input non valido restituisce invalid_input.