Clé API IGN (BYOK)

import { Aside } from ‘@astrojs/starlight/components’;

Couloir utilise les fonds de carte IGN Géoplateforme pour afficher les cartes topographiques officielles françaises. L’accès à ces données nécessite une clé API personnelle — c’est le principe du BYOK (Bring Your Own Key).

Pourquoi une clé personnelle ?

Les données IGN sont soumises à des quotas d’utilisation. En fournissant votre propre clé, vous bénéficiez de votre quota individuel et Couloir n’a pas à gérer une clé partagée entre tous les utilisateurs.

Valeur par défaut

Couloir est préconfiguré avec une clé de transition publique IGN utilisable en développement et pour une utilisation personnelle limitée. Cette clé peut être soumise à des restrictions de débit ou expirer. Il est recommandé de créer et configurer votre propre clé pour une utilisation régulière.

La clé par défaut est fonctionnelle dès l’installation, vous pouvez utiliser l’application sans aucune configuration initiale.

Créer votre clé IGN

1. Rendez-vous sur geoplateforme.ign.fr
2. Créez un compte ou connectez-vous
3. Dans votre espace, créez un nouveau projet et générez une clé API
4. Notez la valeur de la clé

Configurer la clé dans Couloir

1. Ouvrez les Réglages (icône en haut à droite)
2. Dans la section Clé API IGN, collez votre clé dans le champ prévu
3. La carte se recharge automatiquement avec votre clé

Si la carte affiche des tuiles grises ou un message d'erreur après avoir saisi votre clé, vérifiez que vous avez bien activé les services **WMTS** et **TMS** dans les paramètres de votre clé IGN.