onizuka_4qpx8ph6h599vb1m_333.py

📄 Template de Fiche Descriptive — Script Python

🔷 INFORMATIONS GÉNÉRALES

Champ Détail

Nom du script onizuka_4qpx8ph6h599vb1m_333.py

Version 1.0.0

Date de création 25/03/2026

Auteur / Demandeur IA Généré

Objectif principal Calculer la distance orthodromique entre deux points géographiques à l’aide de la formule de Haversine.

🎯 DESCRIPTION FONCTIONNELLE

📌 Que fait ce script ?

Le script prend en entrée les coordonnées (latitude et longitude) de deux points sur Terre et calcule la distance la plus courte qui les sépare en mètres, en suivant la courbure de la planète.

📌 Problème résolu

Il permet d’obtenir une estimation précise de la distance « à vol d’oiseau » entre deux villes ou positions GPS sans passer par des services d’API externes coûteux ou complexes.

⚙️ SPÉCIFICATIONS TECHNIQUES

🐍 Environnement

Élément Valeur

Version Python 3.x

OS cible Tous (Windows / Linux / MacOS)

Mode d’exécution CLI / Module

📦 Dépendances / Librairies

# Librairies standard (built-in)

math : Utilisé pour les fonctions trigonométriques et les conversions de radians.

# Librairies externes (pip install)

Aucune.

📥 ENTRÉES (INPUTS)

# Nom Type Obligatoire Description Exemple

1 lat1 float ✅ Oui Latitude du point de départ 48.8566

2 lon1 float ✅ Oui Longitude du point de départ 2.3522

3 lat2 float ✅ Oui Latitude du point d’arrivée 40.7128

4 lon2 float ✅ Oui Longitude du point d’arrivée -74.0060

📤 SORTIES (OUTPUTS)

# Nom Type Description Exemple

1 distance float Distance calculée en mètres 5837240.54…

🧱 STRUCTURE DU SCRIPT

onizuka_4qpx8ph6h599vb1m_333.py

│

├── 📌 IMPORTS (math)

├── 📌 FONCTIONS

│ └── haversine() → Calcul mathématique de la distance

└── 📌 MAIN (Exemple d’utilisation Paris -> NYC)

🔧 Détail des fonctions principales

Fonction Paramètres Retour Rôle

haversine(lat1, lon1, lat2, lon2) lat/lon (floats) float Calcule la distance en mètres via la formule de Haversine.

🔄 LOGIQUE / ALGORITHME

Étape 1 : Conversion des degrés décimaux en radians pour les 4 coordonnées.

Étape 2 : Calcul des deltas (Δlat et Δlon).

Étape 3 : Application de la formule de Haversine :

a=sin2(2Δlat​)+cos(lat1)⋅cos(lat2)⋅sin2(2Δlon​)

c=2⋅arcsin(a​)

Étape 4 : Multiplication par le rayon moyen de la Terre (R=6,371,000 mètres).

Étape 5 : Retour du résultat final.

🚨 GESTION DES ERREURS

Cas d’erreur Type d’exception Comportement attendu

Type d’entrée non numérique TypeError Arrêt du script (non géré explicitement dans le code actuel)

Valeur hors limites (ex: lat > 90) ValueError Le calcul mathématique peut échouer ou être erroné

✅ CONTRAINTES & RÈGLES MÉTIER

Règle 1 : Le rayon de la Terre (R) est fixé à 6 371 000 mètres (modèle sphérique moyen).

Règle 2 : Les coordonnées d’entrée doivent être fournies en degrés décimaux.

🧪 TESTS ATTENDUS

# Cas de test Entrée Résultat attendu Statut

1 Cas nominal Paris -> NYC ~5,837,240 m ⬜ À tester

2 Point identique (48.8, 2.3) -> (48.8, 2.3) 0.0 m ⬜ À tester

3 Traversée méridien (0, 179) -> (0, -179) ~222,390 m ⬜ À tester

📝 EXEMPLE D’UTILISATION

▶️ Lancement en ligne de commande

Bash

python onizuka_4qpx8ph6h599vb1m_333.py

💻 Exemple d’appel en tant que module

Python

from onizuka_4qpx8ph6h599vb1m_333 import haversine

dist = haversine(48.8566, 2.3522, 40.7128, -74.0060)

print(f »Distance : {dist/1000:.2f} km »)

📌 NOTES COMPLÉMENTAIRES

⚠️ Améliorations suggérées :

Ajouter des Type Hints (lat1: float) pour plus de clarté.

Gérer les exceptions pour les entrées non valides.

Utiliser un rayon terrestre plus précis (WGS-84) si une précision millimétrique est requise.