Resolução do terreno Web Mercator
No equador e com ampliação 0, um pixel de um mapa web padrão cobre 156.543,033928 m e um bloco inteiro de 256 pixels, 40.075.016,6856 m. Cada nível de ampliação corta esse valor pela metade, e as regiões mais próximas dos polos o reduzem ainda mais. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Latitude
- 0
- Nível de zoom
- 0
- Metros por pixel
- 156.543,033928
- Metros por bloco
- 40.075.016,6856
- Tamanho do bloco (px)
- 256
- Raio da Terra (m)
- 6.378.137
Ela usa a esfera padrão EPSG:3857, blocos de 256 pixels e a pirâmide XYZ comum. O resultado ajuda você a converter distâncias da tela, dimensionar símbolos, criar barras de escala e selecionar imagens com o detalhe desejado. O cálculo é determinístico, não acessa a rede e também retorna a largura no terreno de um bloco completo.
Entenda o que a resolução do terreno mede
A resolução do terreno expressa a distância real aproximada coberta por um pixel do mapa, normalmente em metros por pixel. Ela não mede a resolução do monitor, a precisão do GPS nem o detalhe nativo de uma imagem aérea. Sua função é relacionar a grade digital do Web Mercator à distância no solo em uma latitude específica.
No zoom zero, o mundo projetado cabe em um bloco de 256 pixels. Cada aumento do zoom dobra o número de blocos em cada direção e reduz pela metade a distância por pixel. A latitude importa porque o Web Mercator amplia a escala perto dos polos.
Portanto, no mesmo zoom, um pixel representa menos distância leste-oeste longe do equador.
Como funciona a fórmula do Web Mercator
A calculadora usa o raio equatorial 6,378,137 metros adotado pelo EPSG:3857. Primeiro calcula a circunferência esférica como duas vezes pi vezes o raio. Dividir por 256 fornece a resolução inicial no equador e no zoom zero.
A resposta considera o bloco lógico padrão de 256 pixels. Se o seu renderizador fornecer imagens de 512 pixels, confira as convenções de bloco e zoom. Essa validação evita tratar como válida uma posição fora do mundo finito do mapa deslizante.
Use o resultado sem exagerar a precisão
Use a resolução como conversão de escala, e não como garantia de que os dados tenham a mesma exatidão. Um resultado de dois metros por pixel indica que uma linha de dez pixels cobre cerca de vinte metros naquela latitude, mas a geometria, a imagem ou a localização podem ter incerteza maior. A escala também varia na tela conforme muda a latitude; o centro costuma bastar em mapas interativos, enquanto exportações regionais altas podem exigir várias amostras.
O valor é útil para escolher raios de agrupamento, converter tolerâncias de clique, estimar a área de uma exportação raster e rotular barras de escala. Cada nível inteiro de zoom reduz os metros por pixel pela metade. No mesmo zoom, latitudes absolutas maiores geram valores menores pelo ajuste do cosseno.
Casos de uso
Criar uma barra de escala precisa
Converta uma largura em pixels na latitude central em uma distância aproximada para o rótulo.
Planejar exportações raster
Estime a largura no terreno de blocos ou pixels antes de solicitar ou processar imagens cartográficas.
Perguntas frequentes
Por que a resolução muda com a latitude?
O Web Mercator amplia a escala rumo aos polos; assim, um pixel projetado representa menos terreno em latitudes altas.
Qual tamanho de bloco é considerado?
O cálculo considera o tamanho lógico convencional de 256 pixels para blocos de mapas deslizantes.
Posso usar um nível de zoom fracionário?
Não. Esta capacidade aceita níveis inteiros da pirâmide de blocos, de 0 a 30.
Como transformo uma distância na tela em metros no terreno?
Multiplique os metros por pixel pela largura em pixels que você mediu no mapa. O valor vale perto da latitude informada, então recalcule se você se deslocar muito para o norte ou para o sul.
Por que a latitude fica limitada a 85,05112878 graus?
Porque esse é o limite prático do Web Mercator, que estica o mapa cada vez mais perto dos polos. Valores fora dele são recusados para que um número plausível não pareça uma posição válida no mapa.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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)Exemplo de requisição
{
"latitude": 40.7128,
"zoom": 12
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.web_mercator_ground_resolution",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Esta calculadora de resolução do terreno Web Mercator informa quantos metros reais um pixel representa em determinada latitude e nível de zoom.
Entenda o que a resolução do terreno mede
Use meters_per_pixel para estimativas próximas à latitude informada e multiplique-o por uma largura em pixels. meters_per_tile aplica a mesma resolução à largura inteira de um bloco XYZ.
Como funciona a fórmula do Web Mercator
Em seguida, divide por dois elevado ao zoom e multiplica pelo cosseno da latitude em radianos. De forma compacta, a resolução é cos(latitude) vezes 2πR, dividida por 256 vezes 2^zoom. A entrada aceita somente zoom inteiro de zero a trinta e latitude dentro do limite prático do Web Mercator, aproximadamente ±85.05112878 graus.
Use o resultado sem exagerar a precisão
A API custa US$ 0,002 por item bem-sucedido e executa o mesmo cálculo determinístico do navegador.
Casos de integração
Escolher raios de agrupamento e clique
Transforme limites da interface medidos em pixels em metros para um zoom e uma latitude.
Perguntas técnicas
Qual fórmula esta calculadora usa?
Ela usa cos(latitude) × 2π × 6378137 dividido por 256 × 2^zoom. A latitude é convertida em radianos.
Quanto custa uma chamada API?
Cada item processado com sucesso custa US$ 0,002. Uma entrada inválida retorna o erro invalid_input.