Connecter votre propre service de carte à map.army

map.army est livré avec une liste fixe de fonds de carte. Si votre organisation exploite son propre service cartographique — celui d’une agence nationale de cartographie, d’un service géospatial de défense, ou un serveur de tuiles sur votre propre réseau — vous pouvez faire dessiner celui-ci par l’application à la place, sans aucune installation, en le plaçant dans le lien.

Astuce:

Réponse rapide — utiliser votre propre serveur de cartes

  1. Construisez un lien : https://www.map.army/?mapType= suivi de la description de votre service WMTS ou WMS. Voir Construire le lien.
  2. Ouvrez le lien. Votre service remplace les cartes de base intégrées pour cette session. Ouvrez-le une seconde fois si le premier chargement n’affiche aucune carte.
  3. Transmettez le lien à votre équipe : aucune configuration n’est nécessaire.

Ce que fait un lien mapType

Une adresse map.army peut transporter un paramètre mapType décrivant un service cartographique. Quand l’application le trouve, ce service devient le fond de carte :

map.army affichant un service WMTS OpenStreetMap personnalisé comme fond de carte, chargé depuis un lien mapType

Il remplace la liste intégrée au lieu de s’y ajouter. La ligne Type de carte disparaît complètement d’Options → Paramètres de la carte, car avec un seul service il n’y a plus de choix à proposer :

Menu déroulant Type de carte de map.army déplié, listant Satellite, Terrain, Hybride, Rues, Carte routière et OSM

L’effet ne dure que le temps du lien. Rien n’est enregistré : rouvrez map.army sans le paramètre et les cartes habituelles reviennent. C’est donc un bon moyen de transmettre à quelqu’un une carte fonctionnelle de votre propre zone — envoyez le lien et il n’a besoin d’aucune configuration — mais un mauvais moyen de changer votre propre réglage par défaut, car chaque visite doit reprendre le même lien.

Astuce: Le panneau Options ne propose aucun champ pour une adresse de service cartographique. Dans l’application hébergée, le lien est le seul moyen de faire cela ; l’application hébergée n’a pas de liste permanente de vos propres services — voir Périmètre de l’app hébergée.

Ouvrir le lien deux fois — le premier chargement n’affiche aucune carte

map.army lors d'une première visite sur un lien mapType : barre d'outils fonctionnelle, zone de carte entièrement vide

Lors de la première visite dans un navigateur donné, un lien mapType n’affiche actuellement aucun fond de carte — une barre d’outils fonctionnelle au-dessus d’une zone vide, exactement comme ci-dessus. Rechargez la page et votre service apparaît. Tout le reste du lien fonctionne normalement.

Mesuré le 2026-09-17 sur la build 6.1.1/7489 : le premier chargement n’a fait aucune requête vers le service de tuiles ; un rechargement de la même adresse en a fait 19 et a dessiné la carte.

Astuce: Envoyez le lien avec la consigne « ouvrez-le, puis rechargez une fois ». Un destinataire qui ouvre votre lien, voit une carte vide et ferme l’onglet n’a aucun moyen de savoir que quelque chose n’allait pas — il n’y a aucun message d’erreur. Tant que ce n’est pas corrigé dans l’application, le rechargement est la solution de contournement, et cela vaut la peine de le préciser explicitement à la personne à qui vous envoyez le lien.

WMTS ou WMS — les distinguer

Ce sont deux façons standard pour un serveur de publier de l’imagerie cartographique, et celle dont vous disposez détermine les propriétés dont vous avez besoin. La documentation de votre fournisseur vous le dira, mais l’adresse elle-même est généralement révélatrice.

A gauche : tuiles prédécoupées (WMTS) ; à droite : une image dessinée à la demande (WMS).

Dans le schéma : 1 WMTS, tuiles pré-découpées ; 2 WMS, image dessinée à la demande.

  • Un service WMTS (Web Map Tile Service) sert des tuiles carrées pré-découpées. Son adresse est un modèle avec des espaces réservés pour la position de la tuile — {z} pour le niveau de zoom, {x} et {y} pour la colonne et la ligne, comme dans https://tiles.example.org/{z}/{x}/{y}.png. C’est le plus rapide des deux, car le serveur a fait le travail à l’avance.
  • Un service WMS (Web Map Service) dessine une image à la demande. Son adresse est un simple point de terminaison, et vous devez aussi préciser quelles couches vous voulez et dans quel format d’image, car un point de terminaison WMS en publie généralement plusieurs.

Si on vous donne une URL GetCapabilities, c’est du WMS. Si on vous donne une adresse contenant {z}/{x}/{y}, c’est du WMTS.

Construire le lien

Le JSON

La valeur de mapType est un objet JSON. Le plus court qui fonctionne pour du WMTS n’a besoin que d’un type et d’une adresse :

{"type":"wmts","url":"https://tiles.example.org/{z}/{x}/{y}.png"}

Un objet WMS a besoin de trois éléments, car un simple point de terminaison ne suffit pas pour dessiner quoi que ce soit :

{"type":"wms","url":"https://wms.example.org/?","layers":"topo-colour","format":"image/png"}

Tout le reste est optionnel et décrit plus loin. Si les propriétés requises sont incorrectes, l’application ignore silencieusement tout le paramètre — voir Quand le lien ne fonctionne pas.

L’encoder dans l’adresse

Le JSON contient des caractères qui ne sont pas sûrs dans une URL — guillemets, accolades, virgules — l’objet doit donc être encodé en pourcentage avant d’être placé dans l’adresse. N’importe quelle bibliothèque HTTP ou langage de script fait cela pour vous. Dans une console de navigateur :

const json = JSON.stringify(mapTypeObject);
const query = new URLSearchParams({ mapType: json }).toString();
const link = `https://www.map.army/?${query}`;

Coller du JSON brut dans la barre d’adresse semble parfois fonctionner, car les navigateurs encodent certains caractères à votre place — mais pas tous, et ceux qu’ils oublient échouent silencieusement. Encodez-le correctement.

Exemples concrets

Un service WMTS

Les tuiles standard d’OpenStreetMap, avec sous-domaines et attribution renseignés. C’est le lien utilisé pour les captures d’écran de cette page :

{"type":"wmts","url":"https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png","subdomains":"abc","tileSize":256,"zoomLevel":[0,22],"credits":"OpenStreetMap contributors","creditsUrl":"https://www.openstreetmap.org/copyright"}

Encodé dans un lien :

https://www.map.army/?mapType=%7B%22type%22%3A%22wmts%22%2C%22url%22%3A%22https%3A%2F%2F%7Bs%7D.tile.openstreetmap.org%2F%7Bz%7D%2F%7Bx%7D%2F%7By%7D.png%22%2C%22subdomains%22%3A%22abc%22%2C%22tileSize%22%3A256%2C%22zoomLevel%22%3A%5B0%2C22%5D%2C%22credits%22%3A%22OpenStreetMap+contributors%22%2C%22creditsUrl%22%3A%22https%3A%2F%2Fwww.openstreetmap.org%2Fcopyright%22%7D

Un service WMS

La carte nationale swisstopo au 1:10 000, en tuiles, restreinte à l’étendue que la Suisse occupe réellement afin que la carte ne soit pas vide ailleurs :

{"type":"wms","url":"https://wms.geo.admin.ch/?","layers":"ch.swisstopo.landeskarte-farbe-10","format":"image/jpeg","styles":"default","version":"1.3.0","tiled":true,"extent":[5.5,45.8,11,47.8],"zoomLevel":[7,21],"credits":"Federal Office of Topography swisstopo","creditsUrl":"https://www.geo.admin.ch/"}

Encodé dans un lien :

https://www.map.army/?mapType=%7B%22type%22%3A%22wms%22%2C%22url%22%3A%22https%3A%2F%2Fwms.geo.admin.ch%2F%3F%22%2C%22layers%22%3A%22ch.swisstopo.landeskarte-farbe-10%22%2C%22format%22%3A%22image%2Fjpeg%22%2C%22styles%22%3A%22default%22%2C%22version%22%3A%221.3.0%22%2C%22tiled%22%3Atrue%2C%22extent%22%3A%5B5.5%2C45.8%2C11%2C47.8%5D%2C%22zoomLevel%22%3A%5B7%2C21%5D%2C%22credits%22%3A%22Federal+Office+of+Topography+swisstopo%22%2C%22creditsUrl%22%3A%22https%3A%2F%2Fwww.geo.admin.ch%2F%22%7D
map.army affiche le WMS swisstopo de l'exemple : la carte nationale suisse dans son étendue

Pour aller plus loin

Dernière mise à jour: