Calculadora de escala de mapa web

Uma calculadora de escala de mapa web transforma três dados comuns de qualquer visualizador de mapas — nível de zoom, latitude e DPI da tela — no denominador de escala cartográfica representativa que rotula um mapa deslizante como um-para-N. Os mapas web do Leaflet, OpenLayers, Mapbox, Google Maps e OpenStreetMap compartilham o modelo de tiles do Web Mercator (EPSG:3857): os metros terrestres por pixel diminuem à medida que o zoom aumenta e que você se afasta do equador, por causa do cosseno da latitude. O caminho é aritmética pura e determinística — sem rede, sem sementes aleatórias, sem dependência de relógio —, então o executor gratuito do navegador e a API pré-paga retornam o mesmo JSON após um arredondamento fixo em cada chamada.

O que significa a escala em um mapa base Web Mercator

Nos mapas de papel, N é fixo para cada folha; nos mapas web interativos, N muda toda vez que o usuário dá zoom ou desloca a vista para outra latitude. Longe do equador, essa resolução é multiplicada pelo cosseno da latitude, de modo que o mesmo número de zoom cobre uma área maior perto dos polos. Quando o zoom ou os DPI são zero ou negativos, a geometria não está definida para um visualizador de mapas, por isso esta capacidade rejeita zoom e DPI não positivos com invalid_input em vez de inventar uma escala.

Como chamar a API e o que ela devolve

Envie um corpo JSON com três números finitos obrigatórios: zoom (aliases z e zoom_level), latitude (aliases lat e y) e dpi (aliases screen_dpi e resolution_dpi). O zoom deve ser estritamente positivo e no máximo trinta; os DPI devem ser estritamente positivos e no máximo um milhão; a latitude deve estar entre menos noventa e noventa, inclusive. Em caso de sucesso, a resposta ecoa zoom, latitude e dpi arredondados, publica earth_radius_m como seis milhões trezentos e setenta e oito mil cento e trinta e sete e tile_size como duzentos e cinquenta e seis, retorna meters_per_pixel como a resolução terrestre, scale_denominator como o N representativo (arredondado para o inteiro mais próximo quando o valor absoluto é pelo menos um), scale_ratio como a string um-dois pontos-N, formula como a expressão fechada utilizada, message como um breve resumo em inglês e steps como um rastro ordenado de substituição que você pode mostrar em planilhas de exercícios ou asserções. Uma validação malsucedida — campos ausentes, números não finitos, latitude fora do intervalo, zoom acima do teto publicado, DPI acima do teto publicado ou zoom ou DPI não positivos — retorna invalid_input e nunca é cobrada. O preço é uma taxa fixa de US$ 0,002 por requisição bem-sucedida, com unidade item e preço marginal por unidade zero.

Dicas práticas, limites e buscas relacionadas

Prefira noventa e seis DPI quando quiser o pixel de referência comum de CSS e dos navegadores; use setenta e dois apenas quando precisar reproduzir premissas antigas de impressão; use a proporção real de pixels do dispositivo vezes noventa e seis quando as telas físicas de celulares ou painéis retina importarem. O zoom fracionário é permitido porque os motores de mapas modernos interpolam entre níveis inteiros de tiles — passe dez vírgula cinco quando a câmera estiver a meio caminho entre dez e onze. Perto dos polos, o fator cosseno reduz os metros por pixel e, portanto, N; isso é correto no Web Mercator, não um bug, embora aplicativos reais costumem limitar a latitude perto de oitenta e cinco graus por causa da cobertura de tiles. Esta página mira quem procura uma calculadora de escala de mapa web, conversão de zoom para denominador de escala ou escala de mapa Mercator online; não é uma ferramenta de distância geodésica, nem um motor de layout de impressão, nem um gerador de URL de tiles. Mantenha o zoom em trinta ou menos para que dois elevado ao zoom continue finito em precisão dupla IEEE tanto no Worker quanto no navegador. Ao ensinar, combine exemplos: zoom dez em Nova York com noventa e seis DPI produz um denominador de escala urbana; o mesmo zoom no equador dá um N um pouco menor porque o cosseno é maior; e um dpi de zero ou um zoom de zero propositais demonstram o caminho duro do invalid_input. Prefira esta capacidade quando você já tem zoom, latitude e DPI e só precisa do um-para-N; se sua fonte é um mapa impresso sem número de zoom, meça diretamente as distâncias no terreno e no mapa. Tarefas que falham com invalid_input não consomem saldo pré-pago, o que mantém baratos os scripts exploratórios quando estudantes enviam DPI não positivos de propósito. Verificações de ida e volta são fáceis: recalcule o cosseno da latitude em radianos vezes a resolução inicial publicada dividido por dois elevado ao zoom, multiplique pelos DPI sobre zero vírgula zero dois cinco quatro e confirme que o denominador inteiro bate com o scale_denominator publicado dentro de uma unidade de arredondamento comum.