Convertisseur d'angle

Les noms d'unité inconnus échouent avec une erreur invalid_input explicite au lieu d'inventer des facteurs faux et silencieux.

Quelles unités d'angle plan sont prises en charge et comment fonctionne la conversion

Les alias courants sont acceptés sans tenir compte de la casse : degree et degrees pour deg, radian et radians pour rad, gon grade et gradians pour grad, arc minute et minute of arc pour arcmin, arc second et second of arc pour arcsec, et rev revolution cycle ou full circle pour turn. Si le nom ne figure pas sur cette liste, le solveur rejette la requête avec invalid_input en nommant le champ fautif et en listant les unités prises en charge, de sorte que les clients ne devinent jamais si une faute de frappe a produit un mauvais nombre. Les angles négatifs sont autorisés pour les contextes d'orientation dirigée ; la valeur absolue doit rester dans la limite publiée d'un billion pour que les produits intermédiaires demeurent finis en double précision IEEE, sur le Worker comme dans le navigateur.

Comment appeler l'API et lire la réponse

Branchez-la sur des tableaux de bord, des clients mobiles, des assistants de CAO ou des traitements par lots qui détiennent déjà un angle et n'ont besoin que d'une seconde unité pour l'affichage, la conformité aux normes ou la comparaison multi-unités, sans embarquer de tables de conversion flottantes dans chaque binaire applicatif. Envoyez un corps JSON avec trois champs obligatoires : value (alias angle, amount et n), from (alias from_unit, unit_from et source) et to (alias to_unit, unit_to et target). value doit être un nombre fini ou une chaîne strictement numérique dans les limites absolues d'un billion. from et to doivent se ramener à des noms d'unité pris en charge après normalisation des alias. En cas de succès, la réponse renvoie la valeur d'entrée arrondie, les libellés canoniques from et to, result et converted fixés à la même grandeur cible arrondie, value_rad comme intermédiaire en radians, unit comme libellé cible, factor comme multiplicateur from-to, formula comme courte équation, message comme résumé en anglais, steps comme lignes de substitution ordonnées et supported_units comme les six identifiants canoniques. Une validation échouée — champs manquants, nombres non finis, valeurs hors limites absolues ou nom d'unité inconnu — renvoie invalid_input et n'est jamais facturée. La tarification est un forfait de $0.002 par requête réussie, avec une unité par article et un prix marginal nul.

Conseils pratiques, limites et quand utiliser cette page

Préférez envoyer des nombres bruts pour value quand vous maîtrisez le client ; les nombres en chaîne ne sont acceptés que s'ils respectent un motif numérique fini strict, sans symbole de degré collé aux chiffres — mettez plutôt l'unité dans le champ from. Normalisez les libellés d'affichage de votre côté si vous avez besoin de graphies propres à une langue ; cette API renvoie toujours les jetons canoniques courts deg, rad, grad, arcmin, arcsec et turn, pour que les tests automatisés restent stables. Les tâches échouées qui renvoient invalid_input ne consomment pas de solde prépayé, ce qui maintient à bas coût les scripts exploratoires quand les clients sondent délibérément des noms d'unité inconnus.