Escala de mapa por medición
Esta calculadora de escala de mapa a partir de mediciones convierte la longitud que usted mide sobre un mapa impreso o en pantalla y la distancia real conocida en terreno en una escala de fracción representativa, para rotular planos, comprobar barras de escala y corregir ejercicios de cartografía sin hoja de cálculo.
Ejecutar — gratis
Introduzca la distancia en el mapa, su unidad, la distancia en el terreno y su unidad; la herramienta convierte ambas longitudes a metros con factores SI e imperiales fijos, divide los metros de terreno entre los del mapa para obtener el denominador adimensional N y devuelve la razón 1:N, el cociente bruto antes del redondeo entero, los valores intermedios en metros, una cadena de fórmula breve y pasos de sustitución ordenados que puede pegar en un cuaderno de laboratorio o en una prueba unitaria. Las distancias nulas o negativas se rechazan con un error invalid_input claro en lugar de inventar una escala imposible. Topógrafos y estudiantes de GIS que recuperan la RF desde una barra o dos puntos conocidos, arquitectos que contrastan un plano de emplazamiento con estacas de campo y desarrolladores que escriben fixtures deterministas para software cartográfico necesitan la misma aritmética N igual a terreno entre mapa sin un stack GIS completo. La ruta es matemática pura y determinista—sin red, sin semillas aleatorias, sin dependencia del reloj—así que el ejecutor gratuito del navegador y la API de prepago devuelven el mismo JSON tras el redondeo decimal fijo cada vez que usted la invoca.
Cómo usarla
Ingrese sus datos en el formulario de arriba. La herramienta los revisa antes de calcular y muestra el resultado en la misma página.
Revise sus datos
Use las etiquetas y unidades indicadas en cada campo. Si falta algo o un valor está fuera del rango permitido, la página señala qué debe corregir.
Repita el cálculo o automatícelo
Use la herramienta web para comprobaciones individuales y la API cuando necesite integrar la misma capacidad en un flujo automatizado.
Qué puede hacer con ella
Obtenga una respuesta ahora
Ingrese un conjunto de valores y vea el resultado sin preparar una hoja de cálculo ni un script.
Compare escenarios
Cambie un valor a la vez y repita el cálculo para entender qué modifica el resultado.
Automatice el trabajo repetido
Use la API cuando necesite ejecutar el mismo cálculo dentro de su producto o flujo.
Preguntas frecuentes
¿Cuánto cuesta la calculadora de escala de mapa por medición?
Es gratuita en su navegador en esta página. A través de la API una petición exitosa cuesta $0.002; las entradas no válidas no se cobran.
¿Cómo se define la fracción representativa?
Ambas longitudes se convierten a metros y entonces N = ground_m / map_m. La escala se escribe 1:N (o RF 1/N). Mantenga las mediciones de mapa y terreno del mismo elemento.
¿Qué ocurre si map_distance o ground_distance es cero o negativo?
La entrada se rechaza con invalid_input. Una longitud geométrica no puede ser cero ni negativa al definir una escala de razón.
¿Qué unidades de longitud se admiten?
map_unit y ground_unit aceptan mm, cm, m, km, in, ft, yd y mi. Los valores por defecto son cm para la medición en el mapa y km para la distancia en el terreno.
¿Es lo mismo que una escala de mapa web por zoom y DPI?
No. Esta herramienta solo usa la distancia medida en el mapa y la distancia conocida en el terreno. La escala Web Mercator a partir de zoom, latitud y DPI es otra calculadora.
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/eng/map-scale-from-measure \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"map_distance":2,"ground_distance":1}'const res = await fetch("https://api.kit.forhosting.com/eng/map-scale-from-measure", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"map_distance": 2,
"ground_distance": 1
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/eng/map-scale-from-measure",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"map_distance": 2,
"ground_distance": 1
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/eng/map-scale-from-measure", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"map_distance":2,"ground_distance":1}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"map_distance":2,"ground_distance":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/eng/map-scale-from-measure", 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
{
"map_distance": 2,
"ground_distance": 1
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "eng.map_scale_from_measure",
"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. |