Cap loxodromique

Les coordonnées hors de la plage de latitude valide de moins quatre-vingt-dix à plus quatre-vingt-dix ou de longitude de moins cent quatre-vingts à plus cent quatre-vingts produisent une erreur invalid_input claire et ne sont jamais facturées. Le chemin est une pure arithmétique sphérique déterministe — pas de réseau, pas de graines aléatoires, pas de dépendance à l’horloge murale — de sorte que l’exécuteur gratuit du navigateur et l’API prépayée renvoient le même JSON après un arrondi décimal fixe à chaque appel.

Ce qu’est un cap loxodromique et en quoi il diffère du grand cercle

Lorsque départ et arrivée coïncident, le cap géométrique est indéfini ; cette API rapporte conventionnellement zéro degrés et l’indique dans le champ message pour que les tests automatisés restent déterministes.

Comment appeler l’API et ce qui revient

Les latitudes aux pôles géographiques sont aussi rejetées car la formule de latitude isométrique n’y est pas finie. Envoyez un corps JSON avec quatre nombres finis obligatoires : lat1 (alias start_lat, latitude1, from_lat), lon1 (alias start_lon, longitude1, from_lon, lng1), lat2 (alias end_lat, latitude2, to_lat) et lon2 (alias end_lon, longitude2, to_lon, lng2). La latitude doit se situer dans l’intervalle fermé de moins quatre-vingt-dix à plus quatre-vingt-dix degrés et la longitude dans celui de moins cent quatre-vingts à plus cent quatre-vingts ; toute valeur hors de ces plages renvoie invalid_input avec un message explicite hors de sa plage valide. En cas de succès la réponse renvoie lat1, lon1, lat2 et lon2 arrondis ; fixe bearing_deg au cap constant en degrés de zéro inclus à trois cent soixante exclu ; bearing_rad au même angle en radians ; compass à une étiquette à seize points telle que N, NE ou WSW ; formula à l’expression atan2 et delta-psi ; units pour degrés et radians ; message à un court résumé en anglais ; et steps à un tableau ordonné de lignes de substitution que vous pouvez affirmer dans les tests. La validation échouée — champs manquants, nombres non finis, coordonnées hors plage ou latitudes polaires — renvoie invalid_input et n’est jamais facturée. Le tarif est un $0.002 forfaitaire par requête réussie avec unité item et prix unitaire marginal zéro.

Conseils pratiques, limites et recherches liées

Cet atterrissage cible ceux qui cherchent un calculateur de cap loxodromique, un cap constant de loxodromie ou un cap de boussole constant entre deux coordonnées ; ce n’est pas un calculateur de distance loxodromique, ni un outil de destination depuis un cap, ni un solveur géodésique ellipsoïdal. Préférez cette capacité lorsque vous avez déjà deux points et n’avez besoin que du cap constant ; si votre source est un plan de vol de grand cercle, convertissez ou rééchantillonnez avec un outil orthodromique. Gardez les deux latitudes strictement à l’intérieur de la bande polaire ouverte si vous planifiez de longues jambes nord–sud près des hautes latitudes ; l’API rejette déjà les vrais pôles, mais des valeurs à quelques microdegrés de quatre-vingt-dix peuvent encore stresser tan de pi sur quatre plus phi sur deux en flottant sur d’autres systèmes. Préférez envoyer un JSON numérique plutôt que des chaînes préformatées lorsque vous contrôlez le client ; les nombres en chaîne ne sont acceptés que s’ils correspondent à un motif numérique fini strict. En enseignement, associez des exemples : une jambe classique de la zone de Douvres vers cinquante et un virgule un deux sept nord, un virgule trois trois huit est à cinquante virgule neuf six quatre nord, un virgule huit cinq trois est produit un cap constant vers le sud-est ; une jambe pure est le long d’un parallèle produit quatre-vingt-dix degrés ; une jambe pure sud le long d’un méridien produit cent quatre-vingts degrés ; et latitude quatre-vingt-onze ou longitude deux cents démontre le chemin dur invalid_input. Les tâches échouées qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient les scripts exploratoires peu chers lorsque les apprenants envoient délibérément des longitudes hors plage. Les contrôles aller-retour sont faciles : recalculez delta-psi et atan2 à la main pour une courte jambe est–ouest ou nord–sud et confirmez que bearing_deg correspond dans le même arrondi à six décimales, et confirmez qu’échanger départ et arrivée fait tourner le cap d’environ cent quatre-vingts degrés sur un simple segment méridien.