MadJax
0e6a97ca61
- Backend : projets, solution, namespaces et références TrajetKmTracker.Api/.Tests -> SchotzIadKmTracker.Api/.Tests (dossiers, .csproj, .sln, .http, namespaces C#). GUID UserSecretsId préservé. - Specs : dossier .kiro/specs/trajet-km-tracker -> schotziad-km-tracker et mise à jour des références internes (chemins, tags de propriétés). - Frontend : projet Angular trajet-km-tracker -> schotziad-km-tracker (package.json, angular.json, chemin dist, Dockerfile), titre applicatif 'SchotzIAD KM Tracker'. - Docker et scripts (backend/Dockerfile, frontend/Dockerfile, run-dev.sh) mis à jour. - Suppression du fichier résiduel package.json.bak. Backend (solution) et frontend (build production) compilent sans erreur.
23 lines
1008 B
C#
23 lines
1008 B
C#
using SchotzIadKmTracker.Api.Models.DTOs;
|
|
|
|
namespace SchotzIadKmTracker.Api.Services;
|
|
|
|
/// <summary>
|
|
/// Client de l'API BAN (Base Adresses Nationale) pour l'autocomplétion
|
|
/// et le géocodage des adresses françaises.
|
|
/// </summary>
|
|
public interface IBANClient
|
|
{
|
|
/// <summary>
|
|
/// Recherche des adresses correspondant à <paramref name="query"/> via l'endpoint
|
|
/// <c>/search/</c> de la BAN (limité à 5 résultats).
|
|
/// </summary>
|
|
/// <param name="query">Texte de recherche (adresse partielle ou complète).</param>
|
|
/// <param name="cancellationToken">Jeton d'annulation.</param>
|
|
/// <returns>La liste des adresses trouvées, mappées en <see cref="BANAdresseDto"/>.</returns>
|
|
/// <exception cref="Exceptions.BANIndisponibleException">
|
|
/// Levée en cas d'échec réseau, de réponse non réussie ou de dépassement du délai.
|
|
/// </exception>
|
|
Task<IReadOnlyList<BANAdresseDto>> RechercherAsync(string query, CancellationToken cancellationToken = default);
|
|
}
|