Guide complet — Territory Maker

Rendez-vous sur console.cloud.google.com et connectez-vous avec votre compte Google.

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

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, cliquez sur Facturation et associez un compte de facturation à votre projet
2. Cliquez sur APIs et services → Bibliothèque
3. Recherchez Maps JavaScript API, cliquez dessus, puis cliquez sur Activer
4. Revenez à la bibliothèque, recherchez Directions API, cliquez dessus, puis cliquez sur Activer

Créer la clé :

1. Dans le menu, cliquez sur APIs et services → Identifiants
2. Cliquez sur + Créer des identifiants → Clé API
3. Une clé est générée immédiatement au format AIzaSy… — copiez-la

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

1. Sur la page Identifiants, cliquez sur le nom de votre clé
2. Sous Restrictions d'application, sélectionnez Référents HTTP (sites web)
3. Ajoutez vos domaines :
   https://votre-site.pages.dev/*
http://localhost:4321/*
4. Cliquez sur Enregistrer

1. Ouvrez Territory Maker dans votre navigateur
2. Cliquez sur l'icône ⚙️ en haut de la barre latérale pour ouvrir les paramètres
3. Collez votre clé dans le champ Clé Google Maps API
4. Appuyez sur Entrée — la carte se charge automatiquement

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

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, revenez sur le premier point posé.

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

En mode Route, vous pouvez 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.

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

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

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

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

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

Cliquez sur ⬆ Importer dans l'en-tête du panneau Polygones et sélectionnez un fichier .kml. Tous les polygones du fichier sont regroupés dans un dossier portant le nom du fichier.

Un fichier KML est un document XML structuré. Territory Maker l'analyse de façon sécurisée et n'exécute aucun code qu'il pourrait contenir. Cependant, un fichier malveillant conçu pour saturer la mémoire pourrait ralentir ou bloquer votre onglet.

• N'importez que des fichiers provenant de sources que vous contrôlez ou en lesquelles vous avez confiance
• Méfiez-vous des fichiers KML reçus par e-mail ou téléchargés sur des sites inconnus
• En cas de doute, ouvrez d'abord le fichier dans un éditeur de texte pour vérifier son contenu

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

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

Accessible depuis le panneau ⚙️ :

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

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

L'outil Split permet de couper un polygone fermé en deux en traçant une ligne de découpe à l'intérieur.

1. Sélectionnez un polygone fermé — le bouton ✂ apparaît dans la barre d'outils à droite
2. Cliquez sur ✂ pour entrer en mode découpe. Le curseur devient une croix et l'aimant s'active automatiquement
3. Cliquez un premier point sur le contour du polygone — un marqueur rouge indique le point de départ
4. Cliquez des points intermédiaires à l'intérieur pour guider la découpe (optionnel)
5. Cliquez un deuxième point sur le contour pour valider — deux nouveaux polygones sont créés automatiquement

Résultat :

• Le polygone original est supprimé et remplacé par deux nouveaux polygones nommés NomOriginal-1 et NomOriginal-2
• Les deux polygones sont placés dans un dossier "territoires enfants" (créé automatiquement s'il n'existe pas encore)

L'outil Merge fusionne deux polygones adjacents ou se chevauchant en un seul.

1. Cliquez sur un premier polygone pour le sélectionner
2. Ctrl+Clic sur un second polygone — les deux sont surlignés en ambre et le bouton ⊕ apparaît dans la barre d'outils
3. Cliquez sur ⊕ pour fusionner — un seul polygone nommé Polygone1 - Polygone2 est créé

Si les deux polygones sélectionnés ne se touchent pas et ne se chevauchent pas (même avec la tolérance de 5 m), un message d'erreur s'affiche et aucune modification n'est effectuée.

Chaque opération Split et Merge est annulable.

• Appuyez sur Ctrl+Z (ou Cmd+Z sur Mac) — l'annulation de Split/Merge est prioritaire sur l'annulation de waypoint
• Ou cliquez le bouton ↩ dans la barre d'outils à droite (visible uniquement quand des opérations sont dans l'historique)