Sur cette page
Référence des liens mapType : propriétés et limites
Cette page est la référence des liens mapType de map.army : chaque propriété, les projections qui fonctionnent, l’attribution et ce qu’un lien ne peut pas faire. Pour construire votre premier lien, commencez par Connecter votre propre service de carte à map.army.
Chaque propriété en détail
La propriété extent (voir le tableau ci-dessous) limite la zone où le service est dessiné : dans le cadre (1) la carte est visible, à l’extérieur (2) elle reste vide.
Propriétés communes aux deux types de service
| Propriété | Signification | Obligatoire |
|---|---|---|
type | wmts ou wms. Toute autre valeur et le paramètre est ignoré. | Oui |
url | L’adresse du service. Pour WMTS, un modèle XYZ contenant {z}, {x} et {y}, plus {s} si vous utilisez des sous-domaines. Pour WMS, le point de terminaison. | Oui |
extent | La zone réellement couverte par le service, sous la forme [xmin, ymin, xmax, ymax] en degrés WGS84 — longitude d’abord. Elle rogne la couche : en dehors, la carte est vide. Par défaut, le monde entier. | Non |
epsg | Le système de coordonnées dans lequel le service publie, sous forme de code EPSG. Par défaut 3857. Voir Quelles projections fonctionnent avant d’utiliser autre chose. | Non |
epsgExtent | Une limite exprimée dans les unités d’epsg plutôt qu’en degrés. Celle-ci définit la grille de tuiles, pas le rognage de la couche, et n’a de sens que pour WMTS ou pour un WMS avec tiled: true — un WMS simple non tuilé n’a pas de grille de tuiles et l’ignore. | Non |
zoomLevel | Les niveaux de zoom minimum et maximum pris en charge par le service, sous la forme [min, max]. Demander un zoom que le serveur n’a pas produit des tuiles vides. | Non |
credits | Le texte d’attribution. Voir Attribution et mentions de source — il ne prend effet qu’avec creditsUrl. | Non |
creditsUrl | Le lien derrière ce texte d’attribution. | Non |
WMTS uniquement
| Propriété | Signification | Obligatoire |
|---|---|---|
subdomains | Les lettres à faire tourner dans l’espace réservé {s}, écrites comme une seule chaîne sans séparateur — abc signifie a, b et c. Les fournisseurs les proposent pour qu’un navigateur puisse récupérer des tuiles depuis plusieurs noms d’hôte à la fois. Omettez-le si votre url ne contient pas de {s}. | Non |
tileSize | Le côté de la tuile en pixels. Par défaut 256, ce qu’utilisent presque tous les services ; certains plus récents servent du 512. | Non |
WMS uniquement
| Propriété | Signification | Obligatoire |
|---|---|---|
layers | Les noms des couches à demander, exactement comme le service les nomme. Plusieurs valeurs sont séparées par des virgules. | Oui |
format | Le type d’image sous forme de type MIME — image/jpeg pour de l’imagerie photographique, image/png quand vous avez besoin de transparence. | Oui |
styles | Le style de la couche, vide par défaut. Notez le pluriel : une clé style est ignorée, ce qui est facile à manquer car la requête réussit quand même et utilise simplement le style par défaut du serveur. | Non |
version | La version de la spécification WMS. Par défaut 1.3.0. Les serveurs plus anciens peuvent nécessiter 1.1.1, qui diffère dans l’ordre des coordonnées. | Non |
tiled | true demande la carte sous forme de nombreuses petites tuiles, false sous forme d’une seule grande image par vue. Le mode en tuiles est généralement plus rapide et plus léger pour le serveur ; certains services ne prennent en charge que l’un ou l’autre. | Non |
Quelles projections fonctionnent
La vue de la carte elle-même est toujours en Web Mercator. Votre epsg indique à l’application dans quel système le service publie, et la carte reprojette à partir de là — mais seulement pour les systèmes de coordonnées qu’elle connaît.
3857(Web Mercator) et4326(WGS84 lon/lat) fonctionnent toujours. Ils sont intégrés.- Tout le reste n’est pas pris en charge, sauf si vous l’avez testé. Les autres codes dépendent de l’enregistrement d’une définition de projection avant la construction de la carte, ce qui ne se produit pas de façon fiable. Un service suisse LV95 (
2056) peut fonctionner ; un service ETRS89/UTM tel que25832a très peu de chances d’y parvenir.
Si votre service ne publie que dans une grille nationale, la solution fiable consiste à demander à votre fournisseur s’il sert aussi 3857 ou 4326 — c’est le cas de la plupart — plutôt que de transmettre le code national en espérant que cela fonctionne.
Attribution et mentions de source
credits et creditsUrl sont optionnels pour l’application, mais généralement pas pour votre licence. La plupart des services cartographiques, y compris OpenStreetMap et chaque agence nationale de cartographie, exigent que leur attribution apparaisse partout où leur imagerie est affichée.
Renseignés, ils apparaissent à deux endroits :
- Dans l’application, sous forme de lien dans le panneau d’information — le bouton i en bas à droite — affichant
© Map Data:suivi de votre textecredits, pointant vers votrecreditsUrl. Vérifié le 2026-09-17 : un lien portant l’attribution d’OpenStreetMap y a produit© Map Data: OpenStreetMap contributors, exactement comme les cartes intégrées produisent© Map Data: Google. - Dans le pied de page de chaque export et impression, celui qui compte généralement pour une licence.
Notez que le crédit dans l’application est derrière ce bouton, et non dessiné sur la carte. Si votre licence exige que l’attribution soit visible sans clic, c’est sur le pied de page de l’export que vous pouvez compter.
credits sans creditsUrl ne produit rien du tout — aucun lien dans le panneau et un pied de page d’export vide, sans avertissement dans un cas comme dans l’autre. Si l’attribution compte pour votre licence, définissez les deux et vérifiez un export avant d’en publier un.La vue 3D
Les cartes personnalisées chargées avec le paramètre d’URL mapType ne sont pas prises en charge dans la vue 3D. La vue 3D utilise à la place une carte de remplacement : votre service n’y apparaît donc pas ; utilisez la carte 2D pour le voir.
Combiner avec d’autres paramètres
mapType est lu indépendamment des autres paramètres d’URL, si bien qu’un même lien peut transporter votre service cartographique et précharger un calque avec layer=. Les paramètres fonctionnent dans une intégration iframe exactement comme dans un lien normal.
mapType et un partage cesse d’être le lien que vous avez envoyé. Quand l’application ouvre un partage, elle réécrit la barre d’adresse avec l’adresse propre du partage et ne conserve que les paramètres du partage — mapType disparaît donc de l’URL. La carte continue de fonctionner pour cette session, mais l’adresse n’est plus copiable, ajoutable aux favoris ni rechargeable en tant que lien combiné. Conservez l’original quelque part si vous en avez besoin à nouveau, et n’oubliez pas que le rechargement au premier chargement en a besoin.Partager une carte chargée de cette façon
Si vous ouvrez map.army avec un lien mapType puis créez un partage, la personne qui ouvre votre partage n’obtient pas votre service cartographique. Elle reçoit son propre fond de carte par défaut, avec votre superposition par-dessus.
Dans le schéma : 1 votre écran, avec votre fond de carte et votre calque ; 2 le destinataire, avec son fond par défaut et votre calque par-dessus.
C’est le malentendu le plus probable sur cette page, car rien à l’écran ne le laisse deviner : votre partage vous semble correct. Le partage enregistre quel fond de carte était sélectionné, mais pas sa définition, et votre service n’a jamais fait partie de la liste du destinataire, si bien que son application revient à son propre réglage par défaut.
Pour transmettre à quelqu’un votre fond de carte en plus de votre calque, envoyez-lui le lien mapType lui-même — avec le paramètre layer= si vous voulez que le calque l’accompagne — plutôt qu’un partage.
Quand le lien ne fonctionne pas
Il existe trois échecs distincts, et ils se manifestent différemment à l’écran.
Une carte vide au premier chargement. Normal, pour l’instant — rechargez la page. Voir Ouvrir le lien deux fois.
Votre service est ignoré et les cartes normales apparaissent. Le JSON était lisible mais ne décrivait pas un service utilisable — un type qui n’est ni wmts ni wms, une url manquante, ou un WMS sans layers ni format. L’application revient à sa liste intégrée. Vérifiez les propriétés requises pour votre type de service.
Aucune carte du tout, même après un rechargement. Soit le JSON n’a pas pu être lu — une virgule en trop, une accolade non fermée, un caractère non encodé — soit le service n’est pas accessible d’une manière que l’application puisse utiliser. Pour le JSON, collez-le dans n’importe quel validateur avant de l’encoder. Pour le service, vérifiez trois points, dans cet ordre :
- Accès cross-origin. map.army dessine chaque tuile via un canvas, afin de pouvoir appliquer la luminosité, la teinte et la chrominance, et afin que la carte puisse être intégrée à un export. Cela signifie que votre service doit envoyer un en-tête
Access-Control-Allow-Originautorisant l’origine de l’application. Un service qui ne le fait pas n’affichera rien du tout, même si la même URL de tuile s’ouvre parfaitement dans un onglet de navigateur. C’est la cause la plus fréquente d’un service qui semble correct mais qui n’apparaît jamais, et la plus difficile à deviner. - HTTPS. Un navigateur bloque l’imagerie en HTTP simple à l’intérieur d’une page HTTPS.
- Accessibilité. Vérifiez que le service répond depuis la machine qui exécute le navigateur, et pas seulement depuis l’intérieur de votre réseau.
Si votre service ne peut pas être configuré pour envoyer des en-têtes cross-origin, la solution habituelle consiste à placer devant lui un proxy qui le peut, sur votre propre infrastructure.
Ce qu’un lien ne peut pas faire
- Un seul service par lien. Il n’y a aucun moyen de transmettre une liste, ni d’ajouter le vôtre à côté des cartes intégrées.
- Ce n’est pas mémorisé. Chaque visite doit reprendre le lien.
- Cela n’apparaît pas dans le panneau Options comme une nouvelle entrée — cela prend la place de toute la liste, et la ligne Type de carte disparaît.
- Cela ne se transmet pas dans un partage. Voir ci-dessus.
epsg,epsgExtentettileSizesont respectés ici, mais pas dans le fichier de configuration propre à un déploiement, si bien qu’un lien peut décrire un service plus précisément qu’un déploiement installé ne le peut.
Pour une liste permanente de vos propres services, sélectionnable comme n’importe quelle autre carte et partagée par tous ceux qui utilisent ce déploiement, voir Gratuit vs Pro.
Dernière mise à jour: