Metros por píxel en Web Mercator
Sepa cuántos metros de terreno cubre un píxel en un mapa Web Mercator: con zoom 12 en el ecuador son 38,2185141426 m, la mitad con cada nivel de zoom más y menos hacia los polos. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Nivel de zoom
- 12
- Latitud en grados decimales
- 0
- Metros por píxel
- 38,2185141426
- Metros por tesela
- 9 783,9396205
- Circunferencia a la latitud en m
- 40 075 016,6856
- Circunferencia ecuatorial en m
- 40 075 016,6856
La resolución del terreno en Web Mercator responde a una pregunta práctica de la cartografía: con este nivel de zoom y esta latitud, ¿cuántos metros del suelo representa un píxel del mapa? En el ecuador y con zoom cero se recupera la conocida constante de unos ciento cincuenta y seis mil quinientos cuarenta y tres metros por píxel; cada paso de zoom la reduce a la mitad y las latitudes mayores la achican según cos(latitud). El zoom negativo y la latitud fuera del rango geográfico se rechazan con un error de validación claro en lugar de inventar una resolución falsa.
Cómo se calculan los metros por píxel en Web Mercator
Se parte del radio ecuatorial que emplean Web Mercator y casi todas las pilas comerciales de teselas XYZ: R equivale a seis millones trescientos setenta y ocho mil ciento treinta y siete metros. La circunferencia ecuatorial completa es dos pi R.
Las teselas slippy-map miden doscientos cincuenta y seis píxeles de lado y, en el zoom z, el mundo queda cubierto por dos elevado a z teselas a lo largo de cada eje, de modo que el ecuador se representa con doscientos cincuenta y seis por dos elevado a z píxeles de oeste a este. La resolución del terreno en el ecuador es, por tanto, la circunferencia dividida entre ese número de píxeles.
Lejos del ecuador, los meridianos conservan su longitud en las matemáticas de la proyección, pero los círculos paralelos se encogen con el coseno de la latitud geodésica, así que se multiplica por cos(phi) medido en radianes. El zoom debe ser un entero no negativo dentro de un rango slippy práctico; el zoom negativo carece de sentido en una pirámide discreta y se rechaza.
Los polos están permitidos y llevan correctamente el coseno hacia cero, de modo que los metros por píxel colapsan, lo que concuerda con el hecho geométrico de que un píxel este-oeste cubre una distancia terrestre desvaneciente cerca de los polos en este modelo.
Qué envía usted y qué recibe de vuelta
Envíe dos números: el zoom como nivel entero no negativo de slippy-map y la latitud como valor finito en grados decimales con el norte positivo. Ambos campos son obligatorios. El zoom negativo falla con un mensaje que indica que el zoom debe ser no negativo; la latitud fuera del intervalo de noventa negativo a noventa positivo falla con un mensaje out-of-range, de modo que los clientes puedan corregir fallos de GPS o del geocodificador en lugar de adivinar.
Las comprobaciones clásicas incluyen zoom doce en el ecuador para unos treinta y ocho metros por píxel, zoom cero con latitud cero para la constante de resolución inicial completa, y un zoom urbano de latitud media como doce cerca de los cincuenta y un grados, que da un valor de metros por píxel visiblemente menor que en el ecuador.
Dónde aparecen las calculadoras de metros por píxel en el trabajo real
Los equipos de producto con mapas necesitan barras de escala y textos del tipo «unos N metros a lo ancho de esta vista» que sigan siendo honestos cuando los usuarios se desplazan hacia el norte o el sur; fijar una constante ecuatorial en latitudes altas engaña a conductores y trabajadores de campo. Las canalizaciones de datos geoespaciales convierten tolerancias en píxeles procedentes de visión por computador o analítica ráster en distancias del terreno antes de aplicar búferes a las geometrías o decidir si dos detecciones son el mismo objeto.
Los paquetes sin conexión para móvil y los algoritmos de agrupación eligen radios en metros que deben corresponderse con píxeles de tesela a un zoom objetivo sin importar una pesada pila de proyecciones en cada worker. Los ejercicios académicos y de entrevistas suelen pedir la fórmula de resolución de OSM; un único oráculo fiable que devuelva los metros por píxel junto con utilidades de circunferencia acelera la corrección y la preparación de demostraciones.
Si más adelante necesita índices de tesela X/Y a partir de lat/lon, decodificación de quadkey de Bing, distancia de círculo máximo o puntos de destino a lo largo de un rumbo, trátelos como intenciones de búsqueda y páginas de destino independientes en lugar de sobrecargar esta página de resolución del terreno: la intención SEO aquí es específicamente los metros por píxel de Web Mercator a partir del zoom y la latitud.
Qué puede hacer con ella
Barras de escala y etiquetas de «metros a lo ancho de la vista»
Convierta el zoom actual y la latitud del centro del mapa en metros por píxel para que las barras de escala y las fichas de distancia sigan siendo precisas cuando los usuarios se acerquen a los polos.
De tolerancias en píxeles a búferes del terreno
Transforme umbrales en píxeles de visión por computador o de radios de clic en metros para aplicar búferes a geometrías y deduplicar detecciones a un zoom de tesela elegido.
Radios de agrupación y paquetes de teselas sin conexión
Elija radios de agrupación y búsqueda en metros que se correspondan con un zoom slippy objetivo sin enviar una biblioteca completa de proyecciones a cada worker de borde.
Preguntas frecuentes
¿Qué ocurre si el zoom es negativo?
El zoom negativo no está definido en las pirámides slippy-map; el zoom debe ser un entero no negativo (en la práctica, de 0 a 30).
¿Qué rango de latitud se acepta?
La latitud debe estar en el intervalo cerrado [-90, 90] grados. Los valores fuera de ese rango se rechazan como fuera de rango. Cerca de los polos, cos(φ) lleva los metros por píxel hacia cero.
¿Por qué el radio de la Tierra es 6378137 metros?
Es el radio ecuatorial de WGS84 que usa Web Mercator (EPSG:3857). La constante clásica de ~156543.0339 m/px en zoom 0 sobre el ecuador supone este radio y teselas de 256 px.
¿Cuánto cuesta?
La herramienta del navegador es gratuita y se ejecuta localmente.
¿Cuánto cambia el resultado con cada nivel de zoom?
Cada nivel de zoom más divide entre dos los metros por píxel. En el ecuador, con zoom 0, un píxel cubre unos 156 543 metros; con zoom 12 baja a 38,2185141426 metros.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su 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)Ejemplo de solicitud
{
"zoom": 12,
"latitude": 0
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.meters_per_pixel",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Los servidores de teselas, los SDK móviles y los cuadernos de SIG necesitan esa cifra para dimensionar búferes, dibujar barras de escala, elegir radios de agrupación razonables y convertir distancias en pantalla en distancias geográficas sin pasar por una biblioteca completa de proyecciones. La fórmula clásica multiplica la circunferencia ecuatorial de la esfera WGS84 que usa EPSG:3857 por el coseno de la latitud y la divide entre el número de píxeles que abarca el mundo a ese zoom: doscientos cincuenta y seis por dos elevado al nivel de zoom. Esta capacidad devuelve los metros por píxel junto con utilidades como los metros por borde de tesela y la circunferencia a esa latitud, para que usted alimente la interfaz de escala, los umbrales de ajuste y las cargas de la API desde una única ruta de parse determinista.
Cómo se calculan los metros por píxel en Web Mercator
Al juntar las piezas se obtiene que meters_per_pixel es igual a cos(phi) por dos pi R dividido entre tile_size por dos elevado a z, o, de forma equivalente, la constante de resolución inicial publicada por cos(phi) entre dos elevado a z. El resultado es aritmética de punto flotante determinista: sin semillas aleatorias, sin marcas de tiempo, sin llamadas de red y sin deriva de modelos, de modo que el mismo zoom y la misma latitud producen siempre el mismo JSON. La latitud debe situarse en el intervalo geográfico cerrado de noventa grados negativos a noventa positivos; los valores fuera de ese rango no son latitudes terrestres válidas y fallan con invalid_input.
Qué envía usted y qué recibe de vuelta
Los campos ausentes, las cadenas no numéricas, NaN e Infinity fallan con invalid_input y no se cobran. En caso de éxito, la respuesta devuelve el zoom y la latitud depurados, el valor principal meters_per_pixel, meters_per_tile como ese valor por doscientos cincuenta y seis, circumference_at_latitude_m para los cálculos de la barra de escala, equatorial_circumference_m como referencia, initial_resolution_m_per_px en el zoom cero sobre el ecuador, earth_radius_m, tile_size_px, una etiqueta de método y una cadena compacta con la fórmula. El precio de las llamadas API correctas es la base publicada de $0.002 por elemento; los fallos de validación no consumen saldo prepagado.
Dónde aparecen las calculadoras de metros por píxel en el trabajo real
Como esta capacidad es un motor de parse puro, el precio de la API es la base publicada de $0.002 por elemento correcto y la validación fallida no consume saldo.
Preguntas técnicas
¿Qué fórmula usa esta calculadora de metros por píxel?
La resolución del terreno de Web Mercator: mpp = cos(φ) · 2πR / (tile_size · 2^z) con R = 6378137 m y tile_size = 256, siguiendo las convenciones de EPSG:3857 / OSM / Mapbox.