MadJax
e3f946f7d4
Application complète de saisie et de suivi des trajets kilométriques avec calcul de distance routière (OpenRouteService), barème kilométrique, résumés et régularisation annuelle. Backend (ASP.NET Core .NET 8, EF Core, SQLite) : - Trajets (CRUD, réordonnancement, insertion), calcul de distance ORS avec fallback Haversine, géométrie d'itinéraire stockée par trajet, recalcul en masse. - Profil, véhicules (avec dénomination), carnet d'adresses nommées, cache d'adresses. - Barème kilométrique : tranches multiples par puissance fiscale, borne max exclusive avec 'illimité' (KmMax nullable), coefficient à 3 décimales, recopie du dernier barème connu. - Résumés mensuel/annuel, montants réglés, régularisation, export PDF. Frontend (Angular 22, zoneless + signals) : - Consultation par jour, navigation temporelle synchronisée, carte Leaflet, formulaire de trajet (adresses nommées, domicile, autocomplétion BAN). - Détection de changement zoneless (indépendante de zone.js). Hébergement : Docker Compose (nginx + backend), scripts run-dev.sh / run-docker.sh.
35 lines
1.6 KiB
C#
35 lines
1.6 KiB
C#
namespace TrajetKmTracker.Api.Services;
|
|
|
|
/// <summary>
|
|
/// Client de l'API OpenRouteService (ORS) — calcul d'itinéraire routier uniquement.
|
|
/// ORS n'est jamais appelé pour du géocodage ni avec des coordonnées nulles :
|
|
/// les coordonnées de départ et d'arrivée doivent être connues (non-null).
|
|
/// </summary>
|
|
public interface IORSClient
|
|
{
|
|
/// <summary>
|
|
/// Calcule l'itinéraire routier entre deux points géographiques connus via
|
|
/// <c>POST /v2/directions/driving-car</c> et retourne la distance (km) et la
|
|
/// géométrie GeoJSON de l'itinéraire.
|
|
/// </summary>
|
|
/// <param name="lat1">Latitude du point de départ.</param>
|
|
/// <param name="lon1">Longitude du point de départ.</param>
|
|
/// <param name="lat2">Latitude du point d'arrivée.</param>
|
|
/// <param name="lon2">Longitude du point d'arrivée.</param>
|
|
/// <param name="cancellationToken">Jeton d'annulation.</param>
|
|
/// <returns>Un <see cref="RouteResult"/> (distance en km + géométrie GeoJSON).</returns>
|
|
/// <exception cref="ORSTimeoutException">
|
|
/// Levée si l'appel dépasse le délai imparti (voir <c>ORSOptions.TimeoutSeconds</c>),
|
|
/// afin que l'appelant applique le fallback orthodromique (Haversine).
|
|
/// </exception>
|
|
/// <exception cref="ORSException">
|
|
/// Levée en cas d'échec général (erreur réseau, réponse invalide, corps illisible).
|
|
/// </exception>
|
|
Task<RouteResult> CalculateRouteAsync(
|
|
double lat1,
|
|
double lon1,
|
|
double lat2,
|
|
double lon2,
|
|
CancellationToken cancellationToken = default);
|
|
}
|