Scala mappa web
Trasformi zoom, latitudine e DPI dello schermo di una mappa web nella sua scala 1:N: zoom 10 a latitudine 40,7128 su uno schermo da 96 DPI dà 1:437960, il numero per la barra di scala o la legenda. 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 della mappa
- 10
- Latitudine in gradi decimali
- 40,7128
- DPI
- 96
- Raggio terrestre m
- 6.378.137
- Dimensione tile
- 256
- Metri per pixel
- 115,8767977875
- Denominatore di scala
- 437.960
Una calcolatrice di scala mappa web trasforma tre input quotidiani del visualizzatore — livello di zoom, latitudine e DPI dello schermo — nel denominatore di scala cartografica rappresentativa che etichetta una mappa scorrevole come uno-a-N. Le mappe web in Leaflet, OpenLayers, Mapbox, Google Maps e OpenStreetMap condividono il modello di tile Web Mercator (EPSG:3857): i metri di terreno per pixel si riducono al crescere dello zoom e allontanandosi dall'equatore per il coseno della latitudine. Questo strumento applica quella formula chiusa con un raggio terrestre e una dimensione tile dichiarati, poi moltiplica per DPI su metri per pollice così che la scala stampata o a schermo coincida con ciò che i manuali GIS chiamano frazione rappresentativa.
Cosa significa la scala della mappa su un basemap Web Mercator
La scala cartografica è un rapporto tra distanza sulla mappa e distanza al suolo, scritto come la frazione rappresentativa uno-a-N. Sulle mappe cartacee N è fisso per il foglio; sulle mappe web interattive N cambia ogni volta che l'utente fa zoom o pan verso un'altra latitudine. La proiezione Web Mercator usata da quasi ogni basemap consumer avvolge la Terra in un quadrato allo zoom zero con tile di duecentocinquantasei pixel, poi suddivide ogni tile in quattro figli per passo di zoom.
La risoluzione del terreno in metri per pixel all'equatore è quindi due pi volte il raggio equatoriale WGS84 diviso per duecentocinquantasei volte due elevato alla potenza dello zoom. Lontano dall'equatore quella risoluzione è moltiplicata per il coseno della latitudine, quindi lo stesso numero di zoom è un'impronta di terreno maggiore vicino ai poli.
Convertire metri-per-pixel in un denominatore di scala richiede di sapere quanto è grande un pixel dello schermo in metri: lo DPI dello schermo indica punti per pollice, e un pollice internazionale è esattamente zero punto zero due cinque quattro metri, quindi i metri per pixel sul dispositivo equivalgono a zero punto zero due cinque quattro diviso per DPI. Il denominatore di scala N è metri di terreno per pixel divisi per metri dispositivo per pixel — equivalentemente m/px di terreno volte DPI su zero punto zero due cinque quattro.
La latitudine deve restare nell'intervallo chiuso da meno novanta a novanta gradi così che il coseno resti definito in aritmetica reale.
Casi d'uso
Etichette di legenda su basemap interattivi
I team prodotto mappa calcolano 1:N da zoom corrente, latitudine del centro mappa e DPI del dispositivo così il testo della barra di scala resta coerente con la matematica Web Mercator.
Chiavi di risposta per compiti e lab GIS
Gli istruttori verificano i calcoli degli studenti della frazione rappresentativa da zoom, latitudine e risoluzione schermo dichiarati senza aprire un GIS desktop.
Domande frequenti
Come si calcola la scala della mappa web dallo zoom?
Il denominatore di scala è quel valore per DPI diviso per 0.0254 m/pollice.
Perché zoom e DPI devono essere positivi?
Uno zoom zero o negativo invertirebbe o annullerebbe la piramide di tile; un DPI zero o negativo non è una densità fisica dello schermo.
Lo zoom frazionario è supportato?
Sì. Zoom è un numero finito positivo fino a 30, quindi valori come 12.5 corrispondono allo zoom continuo della camera nei moderni motori di mappa web.
La calcolatrice di scala mappa web è gratis?
Lo strumento del browser è gratis e gira in locale.
La latitudine cambia la scala a parità di zoom?
Sì. In Web Mercator i metri di terreno coperti da un pixel diminuiscono allontanandosi dall'equatore, perché vengono moltiplicati per il coseno della latitudine. Per questo lo stesso zoom dà scale diverse a latitudini diverse.
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/map-scale \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"zoom":10,"latitude":40.7128,"dpi":96}'const res = await fetch("https://api.kit.forhosting.com/geo/map-scale", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"zoom": 10,
"latitude": 40.7128,
"dpi": 96
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/map-scale",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"zoom": 10,
"latitude": 40.7128,
"dpi": 96
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/map-scale", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"zoom":10,"latitude":40.7128,"dpi":96}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"zoom":10,"latitude":40.7128,"dpi":96}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/map-scale", 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": 10,
"latitude": 40.7128,
"dpi": 96
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.map_scale",
"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.
Limiti
min_lat | -90 |
max_lat | 90 |
min_zoom | 1e-12 |
max_zoom | 30 |
min_dpi | 1e-12 |
max_dpi | 1000000 |
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
Il percorso è aritmetica puramente deterministica — senza rete, senza semi casuali, senza dipendenza dall'orologio a muro — così l'esecutore gratuito del browser e l'API prepagata restituiscono lo stesso JSON dopo un arrotondamento fisso ogni volta che si chiama.
Cosa significa la scala della mappa su un basemap Web Mercator
Quando zoom o DPI sono zero o negativi la geometria è indefinita per un visualizzatore di mappe, quindi questa capacità rifiuta zoom non positivo e DPI non positivo con invalid_input invece di inventare una scala.
Come chiamare l'API e cosa torna indietro
Zoom deve essere strettamente positivo e al massimo trenta; DPI strettamente positivo e al massimo un milione; latitude tra meno novanta e novanta inclusi. Invii un corpo JSON con tre numeri finiti obbligatori: zoom (alias z e zoom_level), latitude (alias lat e y) e dpi (alias screen_dpi e resolution_dpi). In caso di successo la risposta riecheggia zoom, latitude e dpi arrotondati, pubblica earth_radius_m come sei milioni trecentosettantottomila centotrentasette e tile_size come duecentocinquantasei, restituisce meters_per_pixel come la risoluzione del terreno, scale_denominator come l'N rappresentativo (arrotondato all'intero più vicino quando il valore assoluto è almeno uno), scale_ratio come la stringa uno-due-punti-N, formula come l'espressione chiusa usata, message come un breve riassunto in inglese e steps come una traccia di sostituzione ordinata da mostrare in schede o asserzioni. La validazione fallita — campi mancanti, numeri non finiti, latitude fuori intervallo, zoom oltre il tetto pubblicato, DPI oltre il tetto pubblicato, o zoom o DPI non positivi — restituisce invalid_input e non è mai addebitata. Il prezzo è un $0.002 fisso per richiesta riuscita con unità item e prezzo unitario marginale zero.
Suggerimenti pratici, limiti e ricerche correlate
Preferisca novantasei DPI quando vuole il pixel di riferimento comune CSS / browser; usi settantadue solo per allinearsi a assunzioni di stampa legacy; usi il vero rapporto pixel del dispositivo volte novantasei quando le interessano pannelli fisici di telefono o retina. Lo zoom frazionario è consentito perché i motori mappa moderni interpolano tra livelli di tile interi — passi dieci punto cinque quando la telecamera è a metà tra dieci e undici. Vicino ai poli il fattore coseno collassa metri-per-pixel e quindi N; è corretto per Web Mercator, non un bug, anche se le app reali spesso limitano la latitudine vicino a ottantacinque gradi per la copertura tile. Tenga lo zoom a trenta o meno così che due elevato allo zoom resti finito in doppia precisione IEEE sul Worker e nel browser. Nell'insegnamento, abbini esempi: zoom dieci a New York con novantasei DPI produce un denominatore di scala urbana; lo stesso zoom all'equatore è un N leggermente minore perché il coseno è maggiore; un dpi deliberato di zero o uno zoom di zero dimostra il percorso duro di invalid_input. Questo landing punta a chi cerca una calcolatrice di scala mappa web, zoom a denominatore di scala o scala mappa Mercator online; non è uno strumento di distanza geodetica, né un motore di layout di stampa, né un costruttore di URL di tile. Preferisca questa capacità quando ha già zoom, latitude e DPI e le serve solo uno-a-N; se la fonte è una mappa stampata senza numero di zoom, misuri direttamente le distanze di terreno e di mappa. I task falliti che restituiscono invalid_input non consumano il saldo prepagato, il che tiene economici gli script esplorativi quando gli allievi inviano di proposito DPI non positivo. I controlli andata e ritorno sono facili: ricalcoli cos di latitude in radianti volte la risoluzione iniziale pubblicata divisa per due elevato allo zoom, moltiplichi per DPI su zero punto zero due cinque quattro e confermi che il denominatore intero coincide con scale_denominator pubblicato entro un'unità dell'arrotondamento ordinario.
Casi di integrazione
Test unitari per helper di camera mappa
Gli sviluppatori affermano valori golden di scale_denominator per triple fisse zoom/lat/DPI testando controlli di zoom, anteprima di stampa o metadati di esportazione.
Domande tecniche
La latitudine cambia la scala allo stesso zoom?
Sì. La risoluzione del terreno Web Mercator è moltiplicata per cos(latitude), quindi lo stesso zoom è una scala di terreno più grossolana vicino ai poli che all'equatore.