h3ymvnu/togo-geo-spring-boot-starter

# Togo Geo — Spring Boot Starter Toute la **carte administrative officielle du Togo** (régions, préfectures, communes, cantons), prête à l'emploi dans ton projet Spring Boot. Tu ajoutes la dépendance, et c'est tout : **pas de base de données, pas de configuration, pas d'API externe à appeler.** Les données sont chargées en mémoire au démarrage. ## Ce que ça contient | Niveau | Nombre | Coordonnées GPS | |--------|--------|-----------------| | Région | 5 | Oui | | Préfecture | 39 | Oui | | Commune | 117 | Non (à venir) | | Canton | 393 | Non (à venir) | ## Étape 1 : Ajouter la dépendance Dans ton fichier `pom.xml`, à l'intérieur de ` ` : ```xml io.github.emanou02 togo-geo-spring-boot-starter 0.2.0 ``` *(Gradle : `implementation 'io.github.emanou02:togo-geo-spring-boot-starter:0.2.0'`)* Recharge Maven, et c'est prêt. ## Étape 2 : L'utiliser Il y a **deux façons**. Choisis celle qui te convient. ### Façon A — L'API REST toute prête (la plus simple) Si ton projet est une **application web** (tu as `spring-boot-starter-web`), tu n'as **rien à coder**. Lance ton appli, puis ouvre dans ton navigateur : | Adresse | Ce que ça renvoie | |---------|-------------------| | `/api/togo/regions` | Les 5 régions | | `/api/togo/prefectures` | Les 39 préfectures | | `/api/togo/communes` | Les 117 communes | | `/api/togo/cantons` | Les 393 cantons | | `/api/togo/search?q=kara` | Tout ce qui contient « kara » | | `/api/togo/nearby?lat=6.13&lng=1.22&radiusKm=10` | Ce qui est proche d'un point | Exemple de réponse (`/api/togo/regions`) : ```json [ { "level": "REGION", "nom": "Maritime", "slug": "maritime", "latitude": 6.501957, "longitude": 1.280051, "path": "Maritime" } ] ``` Tu ne veux pas ces routes automatiques ? Désactive-les dans `application.properties` : ```properties togo.geo.web.enabled=false ``` ### Façon B — Dans ton propre code Java Tu veux écrire ta propre logique ? Demande à Spring de te donner l'objet `TogoGeoService` (on dit « l'injecter »), puis u …