Eigenen Kartendienst mit map.army verbinden

map.army liefert eine feste Liste von Basiskarten mit. Betreibt Ihre Organisation einen eigenen Kartendienst — den einer nationalen Vermessungsbehörde, eines militärischen Geodienstes oder einen Tile-Server im eigenen Netzwerk —, können Sie die App stattdessen diesen zeichnen lassen, ganz ohne Installation, indem Sie ihn in den Link aufnehmen.

Hinweis:

Kurzantwort — den eigenen Kartenserver verwenden

  1. Bauen Sie einen Link: https://www.map.army/?mapType= gefolgt von der Beschreibung Ihres WMTS- oder WMS-Dienstes. Siehe Den Link erstellen.
  2. Öffnen Sie den Link. Ihr Dienst ersetzt für diese Sitzung die eingebauten Basiskarten. Öffnen Sie ihn ein zweites Mal, wenn der erste Ladevorgang keine Karte zeigt.
  3. Geben Sie den Link an Ihr Team weiter: Es braucht keine Einrichtung.

Eine map.army-Adresse kann einen mapType-Parameter tragen, der einen Kartendienst beschreibt. Findet die App ihn, wird dieser Dienst zur Basiskarte:

map.army zeichnet einen eigenen OpenStreetMap-WMTS-Dienst als Basiskarte, geladen über einen mapType-Link

Er ersetzt die eingebaute Liste, statt sich ihr anzuschliessen. Die Zeile Kartentyp verschwindet vollständig aus Options → Karteneinstellungen, weil bei nur einem Dienst keine Auswahl mehr anzubieten ist:

Aufgeklapptes Kartentyp-Dropdown von map.army mit Satellit, Gelände, Hybrid, Strassen, Roadmap und OSM

Die Wirkung hält nur so lange wie der Link an. Es wird nichts gespeichert: Öffnen Sie map.army erneut ohne den Parameter, sind die gewohnten Karten wieder da. Das macht ihn zu einem guten Mittel, um jemandem eine funktionierende Karte Ihres eigenen Gebiets in die Hand zu geben — Link senden, kein Setup nötig —, aber zu einem schlechten Mittel, um Ihre eigene Vorgabe dauerhaft zu ändern, weil jeder Besuch denselben Link braucht.

Hinweis: Im Options-Panel gibt es kein Feld für eine Kartendienst-Adresse. In der gehosteten App ist der Link der einzige Weg dafür; die gehostete App hat keine dauerhafte Liste Ihrer eigenen Dienste — siehe Umfang der gehosteten App.
map.army beim ersten Besuch eines mapType-Links: Werkzeugleiste funktioniert, Kartenfläche bleibt vollständig leer

Beim ersten Besuch in einem gegebenen Browser zeigt ein mapType-Link derzeit überhaupt keine Hintergrundkarte — eine funktionierende Werkzeugleiste über einer leeren Fläche, genau wie oben. Laden Sie die Seite neu, und Ihr Dienst erscheint. Alles andere am Link funktioniert normal.

Gemessen am 2026-09-17 gegen Build 6.1.1/7489: Der erste Ladevorgang löste null Anfragen an den Kacheldienst aus; ein Neuladen derselben Adresse löste 19 aus und zeichnete die Karte.

Hinweis: Senden Sie den Link mit dem Hinweis „öffnen, dann einmal neu laden“. Ein Empfänger, der Ihren Link öffnet, eine leere Karte sieht und den Tab schliesst, hat keine Möglichkeit zu erkennen, dass etwas schiefgelaufen ist — es erscheint keine Fehlermeldung. Bis dies in der App behoben ist, ist das Neuladen die Abhilfe, und es lohnt sich, das demjenigen, dem Sie den Link senden, ausdrücklich zu sagen.

WMTS oder WMS — sie auseinanderhalten

Beide sind Standardwege, mit denen ein Server Kartenbilder veröffentlicht, und welchen Sie vor sich haben, entscheidet, welche Eigenschaften Sie brauchen. Die Dokumentation Ihres Anbieters nennt es, doch meist verrät es schon die Adresse selbst.

Links: Kartenkacheln im Raster (WMTS) gegenüber einem auf Anfrage gezeichneten Einzelbild (WMS).

Im Diagramm: 1 WMTS, vorgeschnittene Kacheln; 2 WMS, ein auf Anfrage gezeichnetes Bild.

  • Ein WMTS-Dienst (Web Map Tile Service) liefert vorgeschnittene quadratische Kacheln. Seine Adresse ist eine Vorlage mit Platzhaltern für die Position der Kachel — {z} für die Zoomstufe, {x} und {y} für Spalte und Zeile, etwa in https://tiles.example.org/{z}/{x}/{y}.png. Er ist der schnellere der beiden, weil der Server die Arbeit bereits im Voraus erledigt hat.
  • Ein WMS-Dienst (Web Map Service) zeichnet ein Bild auf Anfrage. Seine Adresse ist ein einfacher Endpunkt, und Sie müssen zusätzlich angeben, welche Layer Sie wollen und in welchem Bildformat, weil ein WMS-Endpunkt üblicherweise mehrere Layer veröffentlicht.

Erhalten Sie eine GetCapabilities-URL, handelt es sich um WMS. Erhalten Sie eine Adresse mit {z}/{x}/{y} darin, handelt es sich um WMTS.

Das JSON

Der Wert von mapType ist ein JSON-Objekt. Das kürzeste brauchbare WMTS-Objekt braucht nur einen Typ und eine Adresse:

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

Ein WMS-Objekt braucht drei Dinge, weil ein blosser Endpunkt allein nicht ausreicht, um etwas zu zeichnen:

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

Alles Weitere ist optional und wird unten beschrieben. Stimmen die erforderlichen Eigenschaften nicht, ignoriert die App den gesamten Parameter stillschweigend — siehe Wenn der Link nicht funktioniert.

Es in die Adresse codieren

JSON enthält Zeichen, die in einer URL nicht sicher sind — Anführungszeichen, geschweifte Klammern, Kommas —, weshalb das Objekt vor der Aufnahme in die Adresse Prozent-codiert werden muss. Jede HTTP-Bibliothek oder Skriptsprache erledigt das für Sie. In der Browser-Konsole:

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

Rohes JSON direkt in die Adressleiste einzufügen scheint manchmal zu funktionieren, weil Browser einige Zeichen automatisch codieren — aber nicht alle, und die übersehenen scheitern lautlos. Codieren Sie es richtig.

Durchgerechnete Beispiele

Ein WMTS-Dienst

Die Standardkacheln von OpenStreetMap, mit ausgefüllten Subdomains und Quellenangabe. Dies ist der Link, der für die Screenshots auf dieser Seite verwendet wurde:

{"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"}

Codiert in einen Link:

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

Ein WMS-Dienst

Die 1:10 000-Landeskarte von swisstopo, gekachelt, beschränkt auf das Gebiet, das die Schweiz tatsächlich einnimmt, damit die Karte anderswo nicht leer bleibt:

{"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/"}

Codiert in einen Link:

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 zeigt den swisstopo-WMS aus dem Beispiel: die Landeskarte der Schweiz innerhalb des Extent-Ausschnitts

Wie es weitergeht

Zuletzt aktualisiert: