# Carte d’aperçu Kòkòlò

## Contours géographiques

- Source primaire : [API Découpage administratif de l’État](https://geo.api.gouv.fr/decoupage-administratif/communes).
- Requête exacte : <https://geo.api.gouv.fr/departements/971/communes?fields=nom,code&format=geojson&geometry=contour>.
- Téléchargement : 4 octobre 2026 ; 32 communes de Guadeloupe.
- Source amont et licence : [Contours administratifs, data.gouv.fr](https://www.data.gouv.fr/datasets/contours-administratifs). Cette fiche désigne Admin Express de l’IGN comme source pour les DROM et publie la base agrégée sous [Open Database License 1.0 (ODbL)](https://opendatacommons.org/licenses/odbl/1-0/). L’extrait est redistribué ici sous cette même licence.
- Attribution : **IGN / geo.api.gouv.fr — ODbL**.
- Extrait adapté disponible : [guadeloupe-communes.geojson](./guadeloupe-communes.geojson).
- Transformations : simplification des anneaux avec Douglas–Peucker (tolérance 0,00015 degré), arrondi à cinq décimales ; projection Mercator pour le SVG, arrondi graphique à 0,1 pixel. Aucune côte n’a été dessinée à la main ou générée par IA.
- Régénération : `python3 apps/web/public/map/generate.py` (bibliothèque standard Python, téléchargement depuis l’API ci-dessus).

Les trois marqueurs sont des points fictifs placés pour illustrer l’interface. Ils ne représentent pas des lieux vérifiés, accessibles ou disponibles. Les textes des îles sont des légendes géographiques positionnées pour la lisibilité ; la carte ne fournit ni itinéraire ni précision de navigation.

## Mapbox

Le composant `MapPreview` affiche ce SVG local sans jeton et n’importe pas le SDK dans ce cas. Avec `VITE_MAPBOX_ACCESS_TOKEN`, le SDK Mapbox GL JS est chargé après montage côté client. Un jeton public destiné à ce projet, limité aux domaines concernés, doit être configuré ; aucun jeton d’un autre projet n’est réutilisé.

`VITE_MAPBOX_STYLE_URL` accepte l’URL d’un style Mapbox Studio. Sans cette valeur, un style code utilise les mêmes contours locaux et la palette Kòkòlò : eau `#D7E6E6`, terre `#D6DCC3`, marqueurs `#B72C36`. Ce premier style ne contient pas de routes ni de données de spots.

Le logo et le contrôle d’attribution de Mapbox restent activés. Une erreur SDK, une absence de WebGL, une erreur de jeton ou un chargement non terminé après 15 secondes conserve l’aperçu local. L’instance et l’observateur de taille sont libérés au démontage.

Documentation officielle consultée :

- [Initialiser une carte avec React](https://docs.mapbox.com/mapbox-gl-js/example/simple-map/).
- [Options de carte, attribution, style, cycle de vie](https://docs.mapbox.com/mapbox-gl-js/api/map/).

Le rendu Mapbox avec un vrai jeton et un style distant nécessite encore une vérification avec le compte de ce projet. Le SVG local reste utilisable indépendamment de ce service.
