Échelle carte par mesure

Les distances nulles ou négatives sont rejetées avec une erreur invalid_input explicite au lieu d'inventer une échelle impossible. Le chemin est une mathématique pure et déterministe—sans réseau, sans graines aléatoires, sans dépendance à l'horloge—de sorte que l'exécuteur gratuit du navigateur et l'API prépayée renvoient le même JSON après le même arrondi décimal fixe à chaque appel.

Comment l'échelle en fraction représentative se définit à partir de deux longueurs mesurées

Lorsque vous connaissez déjà les deux longueurs—par exemple deux centimètres sur le papier couvrant un kilomètre sur le terrain—vous convertissez les deux mesures dans un seul système d'unités et formez N égal à ground_length divisé par map_length. La réponse reprend le map_distance et le ground_distance arrondis que vous avez fournis, enregistre map_unit et ground_unit, publie map_distance_m et ground_distance_m, expose scale_denominator et scale_denominator_raw, scale_ratio sous la forme de la chaîne 1:N, representative_fraction sous la forme 1/N, precision, l'étiquette de méthode map_scale_from_measure, formula sous la forme de la chaîne N equals ground_m over map_m, message comme un court résumé en anglais du moteur, et steps comme un journal de substitution ordonné. Le moteur divise deux longueurs en mètres positives et finies dans la plage de magnitude prise en charge, ou rejette l'entrée avec invalid_input. Les cas rejetés incluent map_distance ou ground_distance manquants, des valeurs non finies, des magnitudes hors du plafond publié, des jetons d'unité hors de l'enum, et toute distance nulle ou négative, car une longueur géométrique non positive ne peut pas définir une échelle de rapport.

Contrat d'entrée, forme de la réponse et comportement d'erreur

En cas de succès, la réponse inclut les longueurs converties en mètres, les champs d'échelle listés ci-dessus, formula et message, et steps comme le journal de substitution que vous pouvez affirmer dans des tests ou montrer à côté d'un croquis. Préférez envoyer des nombres plutôt que des chaînes préformatées lorsque vous contrôlez le client ; lorsque vous devez envoyer des chaînes, placez les unités uniquement dans les champs d'unité, non collées aux valeurs de distance. Envoyez un corps JSON avec deux champs obligatoires : map_distance pour la longueur mesurée sur la carte (alias map_dist, map, measured_map, d_map) et ground_distance pour la longueur réelle correspondante (alias ground_dist, ground, real_distance, d_ground, true_distance). Les deux doivent être finis et strictement positifs dans la plage absolue publiée afin que les conversions intermédiaires en mètres et le rapport restent des doubles IEEE finis et positifs. Le map_unit optionnel vaut par défaut des centimètres et ground_unit des kilomètres—le couplage habituel carte papier et barre d'échelle—et chacun accepte l'enum fermé mm, cm, m, km, in, ft, yd, mi afin que le moteur de rendu du formulaire propose un contrôle select plutôt qu'un texte libre. Le precision optionnel (alias decimals, dp) choisit le nombre de décimales à exposer pour les champs numériques non entiers, par défaut douze et plafonné à quinze pour que les goldens JSON restent stables entre runtimes ; lorsque le dénominateur absolu est au moins un, il est arrondi à l'entier pour l'affichage conventionnel de la RF tandis que scale_denominator_raw conserve le quotient non arrondi. Les formes chaînes de nombres sont acceptées lorsqu'elles correspondent à un motif décimal fini strict avec notation scientifique optionnelle ; les espaces intégrés, les suffixes d'unité dans les champs numériques et les jetons non numériques échouent avec un message invalid_input clair nommant le champ. Une validation échouée—champs manquants, nombres non finis, distances nulles ou négatives, unités inconnues ou valeurs hors limites absolues—renvoie invalid_input et n'est jamais facturée. Le tarif est un forfait $0.002 par requête réussie avec l'unité item.

Où l'échelle de carte par mesure s'inscrit dans le terrain, l'étude et le logiciel

Sur cette page le travail s'exécute entièrement dans votre navigateur ; via l'API chaque consultation réussie coûte $0.002, la validation échouée n'est pas facturée, et rien n'est stocké après le renvoi de la réponse. Cette répartition—exploration interactive gratuite et API identique payante—correspond au reste du catalogue KIT de niveau A et vous permet de passer d'une démonstration en classe à un pipeline automatisé sans changer le résultat mathématique.