Retour à l'app |
Territory Maker
Documentation

Guide complet — Territory Maker

De la configuration de la clé API jusqu'à l'export de tes territoires en KML.

1

Démarrage

1.1 Prérequis

ℹ️

Un compte Google et une carte bancaire valide sont nécessaires pour activer la facturation Google Cloud. Google offre 200 $ de crédits gratuits par mois — l'utilisation normale de Territory Maker reste largement dans cette limite.

1.2 Créer un projet Google Cloud

Rends-toi sur console.cloud.google.com et connecte-toi avec ton compte Google.

  1. Clique sur le sélecteur de projet en haut à gauche (à côté du logo Google Cloud)
  2. Clique sur Nouveau projet
  3. Donne un nom (ex : territory-maker) et clique sur Créer
  4. Attends quelques secondes que le projet soit créé, puis sélectionne-le

1.3 Activer les deux APIs

Territory Maker utilise précisément deux APIs Google Maps. Commence par activer la facturation, puis active chaque API.

  1. Dans le menu latéral, clique sur Facturation et associe un compte de facturation à ton projet
  2. Clique sur APIs et servicesBibliothèque
  3. Recherche Maps JavaScript API, clique dessus, puis clique sur Activer
  4. Reviens à la bibliothèque, recherche Directions API, clique dessus, puis clique sur Activer
Maps JavaScript API
Directions API
💡 La Directions API coûte ~0,005 $ par requête — il faudrait 40 000 trajets calculés pour atteindre les 200 $ de crédits gratuits.

1.4 Générer et restreindre la clé API

Créer la clé :

  1. Dans le menu, clique sur APIs et servicesIdentifiants
  2. Clique sur + Créer des identifiantsClé API
  3. Une clé est générée immédiatement au format AIzaSy… — copie-la
!

Restreindre la clé à ton domaine Fortement recommandé

Sans restriction, n'importe qui qui trouve ta clé peut l'utiliser à tes frais.

  1. Sur la page Identifiants, clique sur le nom de ta clé
  2. Sous Restrictions d'application, sélectionne Référents HTTP (sites web)
  3. Ajoute tes domaines :
    https://ton-site.pages.dev/*
    http://localhost:4321/*
  4. Clique sur Enregistrer
⚠️ Les restrictions peuvent prendre quelques minutes pour prendre effet. Si la carte ne charge pas immédiatement, attends 5 minutes et réessaie.
2

Première utilisation

2.1 Saisir sa clé API

  1. Ouvre Territory Maker dans ton navigateur
  2. Clique sur l'icône ⚙️ en haut de la barre latérale pour ouvrir les paramètres
  3. Colle ta clé dans le champ Clé Google Maps API
  4. Appuie sur Entrée — la carte se charge automatiquement
💡 La clé est retenue entre les sessions : tu n'as pas à la ressaisir à chaque visite.

2.2 Sécurité : comment la clé est stockée

  • La clé est chiffrée en AES-GCM 256 bits avant d'être sauvegardée dans le localStorage de ton navigateur
  • Elle n'est jamais envoyée à un serveur — tout reste sur ton appareil
  • Pour l'effacer, clique sur le bouton Oublier la clé dans les paramètres
3

Dessiner un territoire

3.1 Poser des points sur la carte

Chaque clic sur la carte ajoute un point de passage (waypoint). Les segments entre les points se tracent automatiquement selon le mode actif.

Pour fermer un territoire, reviens sur le premier point posé.

3.2 Mode Route vs Ligne droite

Le toggle en haut de la carte permet de basculer entre deux modes de tracé :

  • Route — chaque segment suit le réseau routier réel via la Directions API
  • Ligne droite — les points sont reliés en ligne directe (vol d'oiseau), sans appel API
💡 Utilise le mode Ligne droite pour les zones sans routes (champs, forêts) ou pour économiser des requêtes API.

3.3 Choisir le mode de transport

En mode Route, tu peux choisir le réseau emprunté :

  • 🚗 Voiture — routes et autoroutes
  • 🚶 Marche à pied — chemins piétons, trottoirs
  • 🚲 Vélo — pistes cyclables et voies adaptées

Ce réglage n'a aucun effet en mode Ligne droite.

3.4 L'outil Snap

Le bouton Snap (aimant) active le magnétisme : les nouveaux points se collent automatiquement aux tracés existants.

  • Utile pour raccorder deux territoires bord à bord sans espace ni chevauchement
  • Fonctionne avec tous les calques visibles

3.5 Annuler et effacer

  • Annuler — supprime le dernier point posé (raccourci : Ctrl + Z)
  • Effacer tout — supprime tous les points du calque actif
4

Gérer ses calques

4.1 Créer et nommer un calque

Chaque calque représente un territoire indépendant (un polygone).

  1. Clique sur + dans la liste des calques pour en créer un nouveau
  2. Clique sur le nom du calque pour le renommer

4.2 Passer d'un calque à l'autre

Clique sur un calque dans la liste pour le rendre actif. Tous les clics suivants sur la carte s'appliquent au calque sélectionné.

💡 Tu peux dessiner plusieurs territoires distincts en parallèle en changeant de calque actif à tout moment.
5

Exporter

5.1 Format KML

Territory Maker exporte en KML (Keyhole Markup Language), le format standard pour les données géographiques.

  • Compatible avec Google My Maps, Google Earth, QGIS, et la plupart des SIG
  • Chaque calque est exporté comme un polygone distinct

5.2 Copier ou télécharger

  1. Clique sur Exporter KML dans la barre latérale pour ouvrir le panneau d'export
  2. Choisis entre Copier (colle dans un autre outil) ou Télécharger (sauvegarde un fichier .kml)
6

Personnalisation

6.1 Thème de l'interface

Accessible depuis le panneau ⚙️ :

  • Sombre — interface noire (défaut)
  • Clair — interface blanche
  • Système — suit les préférences de ton OS

6.2 Thème de la carte

Le fond de carte peut être changé indépendamment de l'interface :

  • Sombre — carte en niveaux de gris sombres
  • Clair — carte classique Google Maps
  • Satellite — vue aérienne
  • Relief — topographie et terrain

Prêt à commencer ? Retourne sur l'application.

Utiliser Territory Maker →