namespace TrajetKmTracker.Api.Services;

/// <summary>
/// Résultat d'un calcul de distance orchestré par <see cref="DistanceCalculatorService"/>.
/// Porte les coordonnées résolues des adresses de départ et d'arrivée, la distance
/// éventuellement calculée (routière via ORS ou orthodromique via Haversine), la
/// géométrie GeoJSON de l'itinéraire lorsqu'elle est disponible, et un éventuel
/// avertissement lorsque la distance n'a pas pu être calculée.
/// </summary>
/// <param name="DepartLatitude">Latitude résolue du point de départ (null si non résoluble).</param>
/// <param name="DepartLongitude">Longitude résolue du point de départ (null si non résoluble).</param>
/// <param name="ArriveeLatitude">Latitude résolue du point d'arrivée (null si non résoluble).</param>
/// <param name="ArriveeLongitude">Longitude résolue du point d'arrivée (null si non résoluble).</param>
/// <param name="DistanceKm">
/// Distance en kilomètres, arrondie à 2 décimales et bornée entre 0,01 et 99 999,99 km ;
/// <c>null</c> lorsque la distance n'a pas pu être calculée (aucune coordonnée résoluble).
/// </param>
/// <param name="GeometrieJson">
/// Géométrie GeoJSON de l'itinéraire routier (fournie par ORS) ; <c>null</c> en cas de
/// fallback Haversine ou d'absence de calcul.
/// </param>
/// <param name="Avertissement">
/// Vrai lorsque la distance n'a pas pu être calculée faute de coordonnées résolubles ;
/// dans ce cas l'appelant stocke une distance nulle avec un avertissement.
/// </param>
/// <param name="Message">Message d'avertissement associé, ou <c>null</c>.</param>
public record DistanceCalculationResult(
    double? DepartLatitude,
    double? DepartLongitude,
    double? ArriveeLatitude,
    double? ArriveeLongitude,
    decimal? DistanceKm,
    string? GeometrieJson,
    bool Avertissement,
    string? Message);