Trouveur de quadrant

Elle suit la convention mathématique standard : le quadrant I est celui où les deux coordonnées sont positives, et la numérotation progresse dans le sens inverse des aiguilles d'une montre. Une coordonnée nulle n'est jamais forcée dans un quadrant : les points situés sur un axe sont signalés comme des points d'axe, ce qui est précisément la distinction que la plupart des implémentations rapides ratent. Les deux coordonnées doivent être des nombres finis ; toute autre valeur renvoie une erreur d'entrée invalide explicite.

Ce que signifie le quadrant d'un point

Le plan cartésien est divisé par l'axe des x et l'axe des y en quatre régions appelées quadrants. Le quadrant I contient tout point dont x et y sont tous deux positifs ; en progressant dans le sens inverse des aiguilles d'une montre, le quadrant II a un x négatif et un y positif, le quadrant III a ses deux coordonnées négatives et le quadrant IV a un x positif et un y négatif. Connaître le quadrant d'un point est plus qu'un exercice scolaire : cela révèle le schéma de signes des coordonnées sans inspecter chaque valeur séparément, ce qui est exactement la base sur laquelle s'appuient la trigonométrie, les simulations physiques et les moteurs de jeu pour interpréter angles et vecteurs. Un chercheur de quadrant condense tout ce raisonnement en un seul appel de classification. Vous envoyez deux nombres et recevez un numéro de quadrant entre un et quatre, ou une localisation explicite d'axe ou d'origine lorsqu'une coordonnée vaut zéro — car les points situés sur un axe n'appartiennent à aucun quadrant, et les confondre avec l'un d'eux est l'erreur classique de la géométrie des coordonnées.

Comment la classification est décidée

La règle est un test de signes strict, appliqué dans un ordre fixe afin que le résultat soit toujours sans ambiguïté. Le endpoint vérifie d'abord si les deux coordonnées sont nulles, auquel cas le point est l'origine. Il vérifie ensuite si y vaut zéro, ce qui place le point sur l'axe des x, et si x vaut zéro, ce qui le place sur l'axe des y. Ce n'est que lorsque les deux coordonnées sont non nulles que le signe de chacune décide du quadrant : positif-positif donne I, négatif-positif donne II, négatif-négatif donne III et positif-négatif donne IV. Cet ordre compte parce qu'un point comme (0, 5) se trouve sur l'axe des y, et non dans le quadrant I ou II, et que (0, 0) est l'origine plutôt qu'un axe arbitraire. La validation de l'entrée est tout aussi stricte : chaque coordonnée doit être un nombre fini, de sorte que NaN, Infinity, les champs manquants et les valeurs non numériques sont rejetés avec une erreur d'entrée invalide au lieu de produire une classification silencieusement fausse.

Où elle s'inscrit dans le travail réel

Les outils éducatifs utilisent le endpoint pour corriger instantanément et de façon cohérente les réponses des élèves sur le plan de coordonnées. Les développeurs de jeux utilisent la logique des quadrants pour décider de l'orientation des sprites, du placement sur la minicarte et des régions de collision, et cette API permet à la validation côté serveur de concorder avec le client. Les pipelines de visualisation de données l'utilisent pour regrouper les points en régions avant de colorer et d'annoter un nuage de points. Comme le même code déterministe s'exécute gratuitement dans votre navigateur sur cette page et sur notre edge pour les appels API, vous pouvez prototyper une classification de manière interactive puis l'automatiser avec la certitude que les réponses concorderont exactement. L'appel est sans état, ne stocke rien et coûte $0.002 par requête lorsqu'il passe par l'API. Pour le travail en volume, envoyez une requête par point et agrégez les localisations côté client ; il n'existe pas de variante par lots, ce qui rend le contrat — et son tarif — trivialement prévisible.