Escala de mapa por medición

Las distancias nulas o negativas se rechazan con un error invalid_input claro en lugar de inventar una escala imposible. 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 se define la escala de fracción representativa a partir de dos longitudes medidas

Cuando usted ya conoce ambas longitudes—por ejemplo dos centímetros en papel que abarcan un kilómetro en el campo—convierte ambas mediciones a un único sistema de unidades y forma N igual a ground_length dividido por map_length. La respuesta repite el map_distance y ground_distance redondeados que usted envió, registra map_unit y ground_unit, publica map_distance_m y ground_distance_m, expone scale_denominator y scale_denominator_raw, scale_ratio como la cadena 1:N, representative_fraction como 1/N, precision, la etiqueta de método map_scale_from_measure, formula como la cadena N equals ground_m over map_m, message como un resumen breve en inglés del motor y steps como un registro de sustitución ordenado. El motor divide dos longitudes en metros positivas y finitas dentro del rango de magnitud admitido o rechaza la entrada con invalid_input. Los casos rechazados incluyen map_distance o ground_distance ausentes, valores no finitos, magnitudes fuera del techo publicado, tokens de unidad fuera del enum y cualquier distancia nula o negativa, porque una longitud geométrica no positiva no puede definir una escala de razón.

Contrato de entrada, forma de la respuesta y comportamiento ante errores

En caso de éxito la respuesta incluye las longitudes convertidas a metros, los campos de escala listados arriba, formula y message, y steps como el registro de sustitución que usted puede afirmar en pruebas o mostrar junto a un croquis. Prefiera enviar números en lugar de cadenas preformateadas cuando controle el cliente; si debe enviar cadenas, ponga las unidades solo en los campos de unidad, no pegadas a los valores de distancia. Envíe un cuerpo JSON con dos campos obligatorios: map_distance para la longitud medida en el mapa (alias map_dist, map, measured_map, d_map) y ground_distance para la longitud real correspondiente (alias ground_dist, ground, real_distance, d_ground, true_distance). Ambos deben ser finitos y estrictamente positivos dentro del rango absoluto publicado para que las conversiones intermedias a metros y la razón sigan siendo dobles IEEE finitos y positivos. El map_unit opcional por defecto es centímetros y ground_unit por defecto es kilómetros—el emparejamiento habitual de mapa en papel y barra de escala—y cada uno acepta el enum cerrado mm, cm, m, km, in, ft, yd, mi de modo que el renderizador del formulario pueda ofrecer un control select en lugar de texto libre. El precision opcional (alias decimals, dp) elige cuántas cifras decimales exponer en campos numéricos no enteros, con valor por defecto doce y tope quince para que los goldens JSON se mantengan estables entre runtimes; cuando el denominador absoluto es al menos uno se redondea a entero para la presentación convencional de RF mientras scale_denominator_raw conserva el cociente sin redondear. Se aceptan formas en cadena de números si coinciden con un patrón decimal finito estricto con notación científica opcional; espacios embebidos, sufijos de unidad dentro de los campos numéricos y tokens no numéricos fallan con un mensaje invalid_input claro que nombra el campo. La validación fallida—campos ausentes, números no finitos, distancias nulas o negativas, unidades desconocidas o valores fuera de límites absolutos—devuelve invalid_input y nunca se cobra. El precio es un importe fijo $0.002 por petición exitosa con unidad item.

Dónde encaja la escala de mapa por medición en campo, estudio y software

En esta página el trabajo se ejecuta por completo en su navegador; a través de la API cada consulta exitosa cuesta $0.002, la validación fallida no se cobra y no se almacena nada tras devolver la respuesta. Esa división—exploración interactiva gratuita y una API idéntica de pago—coincide con el resto del catálogo KIT de nivel A y le permite pasar de una demo de aula a un pipeline automatizado sin cambiar el resultado matemático.