Ce guide d'installation se concentre sur l'utilisation de Carte Facile avec MapLibre GL JS, qui est la bibliothèque recommandée pour tirer pleinement parti des fonctionnalités de Carte facile.


Méthode 1 : Installation via npm (recommandé) #

Prérequis : avoir Node.js installé sur votre ordinateur (npm est inclus avec Node.js).

Cette méthode est recommandée pour les projets professionnels ou les applications complexes. Lancez cette commande dans le terminal de votre projet pour installer les librairies Carte Facile et MapLibre :

npm install carte-facile maplibre-gl

Puis passez à l'étape suivante.

Si vous n'utilisez pas de bundler (outil qui gère les imports entre fichiers JavaScript), utilisez plutôt la méthode d'installation via CDN.



Méthode 2 : Installation via CDN #

Cette méthode est adaptée pour les projets simples, les prototypes ou les tests rapides. Elle ne nécessite pas Node.js.

Ajoutez ces lignes dans le <head> de votre page HTML :

  <!-- Importation des styles CSS -->
  <link href="https://unpkg.com/maplibre-gl@^6.9.0/dist/maplibre-gl.css" rel="stylesheet" />
  <link href="https://unpkg.com/carte-facile@^0.10.0/dist/carte-facile.css" rel="stylesheet" />

  <!-- Import map : indique au navigateur où trouver les bibliothèques -->
  <script type="importmap">
  {
    "imports": {
      "maplibre-gl": "https://unpkg.com/maplibre-gl@^6.9.0/dist/maplibre-gl.mjs",
      "carte-facile": "https://unpkg.com/carte-facile@^0.10.0/dist/carte-facile.esm.js"
    }
  }
  </script>

Un exemple de code prêt à l'emploi est disponible ici : Carte simple


Prochaine étape #

Ajouter une carte

Paramètres d'affichage

Choisissez un thème pour personnaliser l’apparence du site.