Escala de mapa web

La ruta es aritmética determinista pura —sin red, sin semillas aleatorias, sin dependencia del reloj del sistema— de modo que el ejecutor gratuito del navegador y la API prepago devuelven el mismo JSON tras un redondeo fijo cada vez que se llama.

Qué significa la escala del mapa en un basemap Web Mercator

Cuando zoom o DPI son cero o negativos la geometría es indefinida para un visor de mapas, así que esta capacidad rechaza zoom no positivo y DPI no positivo con invalid_input en lugar de inventar una escala.

Cómo llamar a la API y qué devuelve

Zoom debe ser estrictamente positivo y como máximo treinta; DPI estrictamente positivo y como máximo un millón; latitude entre menos noventa y noventa inclusive. Envíe un cuerpo JSON con tres números finitos obligatorios: zoom (alias z y zoom_level), latitude (alias lat e y) y dpi (alias screen_dpi y resolution_dpi). En éxito la respuesta repite zoom, latitude y dpi redondeados, publica earth_radius_m como seis millones trescientos setenta y ocho mil ciento treinta y siete y tile_size como doscientos cincuenta y seis, devuelve meters_per_pixel como la resolución de terreno, scale_denominator como el N representativo (redondeado al entero más cercano cuando el valor absoluto es al menos uno), scale_ratio como la cadena uno dos puntos N, formula como la expresión cerrada usada, message como un resumen corto en inglés y steps como una traza de sustitución ordenada que puede mostrar en hojas de trabajo o aserciones. La validación fallida —campos faltantes, números no finitos, latitude fuera de rango, zoom por encima del tope publicado, DPI por encima del tope publicado, o zoom o DPI no positivos— devuelve invalid_input y nunca se cobra. El precio es un $0.002 fijo por solicitud exitosa con unidad item y precio unitario marginal cero.

Consejos prácticos, límites y búsquedas relacionadas

Prefiera noventa y seis DPI cuando quiera el píxel de referencia habitual de CSS / navegador; use setenta y dos solo al igualar supuestos de impresión heredados; use la verdadera razón de píxeles del dispositivo por noventa y seis cuando le importen paneles físicos de teléfono o retina. Se permite zoom fraccionario porque los motores de mapa modernos interpolan entre niveles enteros de tesela —pase diez punto cinco cuando la cámara esté a mitad entre diez y once. Cerca de los polos el factor coseno colapsa metros por píxel y por tanto N; eso es correcto para Web Mercator, no un error, aunque las apps reales a menudo limitan la latitud cerca de ochenta y cinco grados por cobertura de teselas. Este aterrizaje apunta a quien busca una calculadora de escala de mapa web, zoom a denominador de escala o escala de mapa Mercator en línea; no es una herramienta de distancia geodésica, ni un motor de maquetación de impresión, ni un constructor de URL de teselas. Mantenga el zoom en treinta o menos para que dos elevado al zoom siga finito en precisión doble IEEE en el Worker y en el navegador. Al enseñar, empareje ejemplos: zoom diez en Nueva York con noventa y seis DPI produce un denominador de escala urbana; el mismo zoom en el ecuador es un N ligeramente menor porque el coseno es mayor; un dpi deliberado de cero o zoom de cero demuestra la vía dura de invalid_input. Prefiera esta capacidad cuando ya tiene zoom, latitude y DPI y solo necesita uno a N; si su fuente es un mapa impreso sin número de zoom, mida distancias de terreno y de mapa directamente. Las tareas fallidas que devuelven invalid_input no consumen saldo prepago, lo que mantiene baratos los scripts exploratorios cuando los alumnos envían DPI no positivo a propósito. Las comprobaciones de ida y vuelta son fáciles: recalcule cos de latitude en radianes por la resolución inicial publicada dividida por dos elevado al zoom, multiplique por DPI sobre cero punto cero dos cinco cuatro y confirme que el denominador entero coincide con scale_denominator publicado dentro de una unidad del redondeo ordinario.