Auf dieser Seite
mapType-Link-Referenz: Eigenschaften und Grenzen
Diese Seite ist die Referenz zu map.army-mapType-Links: jede Eigenschaft, die funktionierenden Projektionen, die Quellenangabe und was ein Link nicht kann. Den ersten Link bauen Sie mit Eigenen Kartendienst mit map.army verbinden.
Jede Eigenschaft im Detail
Die Eigenschaft extent (siehe Tabelle unten) begrenzt, wo der Dienst gezeichnet wird: Im Rahmen (1) ist die Karte sichtbar, ausserhalb (2) bleibt sie leer.
Eigenschaften, die beide Diensttypen unterstützen
| Eigenschaft | Bedeutung | Erforderlich |
|---|---|---|
type | wmts oder wms. Alles andere, und der Parameter wird ignoriert. | Ja |
url | Die Dienstadresse. Für WMTS eine XYZ-Vorlage mit {z}, {x} und {y}, plus {s}, falls Sie Subdomains verwenden. Für WMS der Endpunkt. | Ja |
extent | Das Gebiet, das der Dienst tatsächlich abdeckt, als [xmin, ymin, xmax, ymax] in WGS84-Grad, Länge zuerst. Es schneidet den Layer zu, sodass die Karte ausserhalb davon leer bleibt. Standardmässig die ganze Welt. | Nein |
epsg | Das Koordinatensystem, in dem der Dienst veröffentlicht, als EPSG-Code. Standardmässig 3857. Siehe Welche Projektionen funktionieren, bevor Sie etwas anderes verwenden. | Nein |
epsgExtent | Eine Abdeckungsgrenze in den Einheiten von epsg statt in Grad. Sie definiert das Kachelraster, nicht die Ausschnittsbegrenzung des Layers, und ist nur für WMTS oder für WMS mit tiled: true von Bedeutung — ein einfacher, ungekachelter WMS-Dienst hat kein Kachelraster und ignoriert sie. | Nein |
zoomLevel | Die niedrigste und höchste Zoomstufe, die der Dienst unterstützt, als [min, max]. Eine Zoomstufe anzufordern, die der Server nicht hat, ergibt leere Kacheln. | Nein |
credits | Der Quellenangabetext. Siehe Quellenangabe und Credits — wirkt nur zusammen mit creditsUrl. | Nein |
creditsUrl | Der Link hinter diesem Quellenangabetext. | Nein |
Nur WMTS
| Eigenschaft | Bedeutung | Erforderlich |
|---|---|---|
subdomains | Die Buchstaben, die reihum für den Platzhalter {s} eingesetzt werden, als eine Zeichenfolge ohne Trennzeichen — abc bedeutet a, b und c. Anbieter stellen dies bereit, damit ein Browser Kacheln gleichzeitig von mehreren Hostnamen abrufen kann. Weglassen, wenn Ihre url kein {s} enthält. | Nein |
tileSize | Die Kachelkante in Pixeln. Standardmässig 256, was fast jeder Dienst verwendet; manche neueren liefern 512. | Nein |
Nur WMS
| Eigenschaft | Bedeutung | Erforderlich |
|---|---|---|
layers | Die anzufordernden Layer-Namen, genau wie sie der Dienst benennt. Mehrere werden mit Komma getrennt. | Ja |
format | Der Bildtyp als MIME-Type — image/jpeg für fotografische Bilder, image/png wenn Sie Transparenz brauchen. | Ja |
styles | Der Layer-Stil, standardmässig leer. Beachten Sie den Plural: Ein Schlüssel style wird ignoriert, was leicht zu übersehen ist, weil die Anfrage trotzdem gelingt und einfach den Standard-Stil des Servers verwendet. | Nein |
version | Die WMS-Spezifikationsversion. Standardmässig 1.3.0. Ältere Server benötigen unter Umständen 1.1.1, das sich in der Reihenfolge der Koordinaten unterscheidet. | Nein |
tiled | true fordert die Karte als viele kleine Kacheln an, false als ein grosses Bild pro Ansicht. Tiled ist meist schneller und schont den Server; manche Dienste unterstützen nur eines von beidem. | Nein |
Welche Projektionen funktionieren
Die Kartenansicht selbst ist immer Web Mercator. Ihr epsg teilt der App mit, in welcher Projektion der Dienst veröffentlicht, und die Karte reprojiziert davon ausgehend — aber nur für Koordinatensysteme, die sie kennt.
3857(Web Mercator) und4326(WGS84 Länge/Breite) funktionieren immer. Sie sind eingebaut.- Alles andere ist nicht unterstützt, sofern Sie es nicht getestet haben. Andere Codes setzen voraus, dass eine Projektionsdefinition registriert ist, bevor die Karte aufgebaut wird, und das geschieht nicht zuverlässig. Ein Schweizer LV95-Dienst (
2056) mag funktionieren; bei einem ETRS89/UTM-Dienst wie25832ist das sehr unwahrscheinlich.
Veröffentlicht Ihr Dienst nur in einem nationalen Gitter, ist der verlässliche Weg, Ihren Anbieter zu fragen, ob er auch 3857 oder 4326 bedient — die meisten tun das —, statt den nationalen Code zu übergeben und zu hoffen.
Quellenangabe und Credits
credits und creditsUrl sind für die App optional, für Ihre Lizenz meist nicht. Die meisten Kartendienste, darunter OpenStreetMap und jede nationale Vermessungsbehörde, verlangen, dass ihre Quellenangabe überall erscheint, wo ihr Bildmaterial gezeigt wird.
Sind sie ausgefüllt, erscheinen sie an zwei Stellen:
- In der App, als Link im Panel Information — der Schaltfläche i in der unteren rechten Ecke — mit dem Text
© Map Data:gefolgt von Ihremcredits-Text, der auf IhrecreditsUrlverweist. Verifiziert am 2026-09-17: Ein Link mit der Quellenangabe von OpenStreetMap erzeugte dort© Map Data: OpenStreetMap contributors, genau wie die eingebauten Karten© Map Data: Googleerzeugen. - In der Fusszeile jedes Exports und Ausdrucks, was meist die für eine Lizenz massgebliche Stelle ist.
Beachten Sie, dass die Quellenangabe in der App hinter dieser Schaltfläche verborgen ist und nicht auf der Karte eingezeichnet wird. Verlangt Ihre Lizenz eine ohne Klick sichtbare Quellenangabe, ist die Fusszeile des Exports die Stelle, auf die Sie sich verlassen können.
credits ohne creditsUrl angegeben, erscheint gar nichts — kein Link im Panel und eine leere Export-Fusszeile, ohne jede Warnung. Ist die Quellenangabe für Ihre Lizenz wichtig, setzen Sie beide und prüfen Sie einen Export, bevor Sie ihn veröffentlichen.Die 3D-Ansicht
Eigene Karten, die über den URL-Parameter mapType geladen werden, werden in der 3D-Ansicht nicht unterstützt. Die 3D-Ansicht verwendet stattdessen eine Ersatzkarte, Ihr Dienst erscheint dort also nicht; sehen Sie ihn in der 2D-Karte.
Kombination mit anderen Parametern
mapType wird unabhängig von den übrigen URL-Parametern gelesen, sodass ein einzelner Link Ihren Kartendienst und einen vorgeladenen Layer mit layer= tragen kann. In einem iFrame-Embed funktionieren die Parameter genauso wie in einem normalen Link.
mapType als auch eine Freigabe trägt, hört auf, der Link zu sein, den Sie gesendet haben. Wenn die App eine Freigabe öffnet, schreibt sie die Adressleiste auf die eigene Adresse der Freigabe um und behält nur deren Parameter — mapType verschwindet damit aus der URL. Die Karte funktioniert für diese Sitzung weiterhin, aber die Adresse ist nicht mehr als kombinierter Link kopierbar, als Lesezeichen speicherbar oder neu ladbar. Bewahren Sie das Original irgendwo auf, falls Sie es erneut brauchen, und denken Sie daran, dass auch das Neuladen beim ersten Laden diesen Link braucht.Eine so geladene Karte teilen
Öffnen Sie map.army mit einem mapType-Link und erstellen dann eine Freigabe, erhält die Person, die Ihre Freigabe öffnet, nicht Ihren Kartendienst. Sie erhält ihren eigenen Standard-Hintergrund mit Ihrem Layer darüber.
Im Diagramm: 1 Ihr Bildschirm, mit Ihrer eigenen Hintergrundkarte und Ihrem Layer; 2 die empfangende Person, mit ihrem Standard-Hintergrund und Ihrem Layer darüber.
Das ist das wahrscheinlichste Missverständnis auf dieser Seite, weil nichts auf Ihrem Bildschirm darauf hindeutet: Ihre Freigabe sieht für Sie richtig aus. Die Freigabe speichert, welche Basiskarte ausgewählt war, aber nicht deren Definition, und Ihr Dienst war nie Teil der Liste der empfangenden Person, sodass deren App auf ihren eigenen Standard zurückfällt.
Um jemandem sowohl Ihre Basiskarte als auch Ihren Layer zu geben, senden Sie stattdessen den mapType-Link selbst — mit dem Parameter layer=, falls der Layer mitkommen soll — statt einer Freigabe.
Wenn der Link nicht funktioniert
Es gibt drei unterschiedliche Fehlerfälle, und sie sehen auf dem Bildschirm unterschiedlich aus.
Eine leere Karte beim ersten Laden. Vorerst zu erwarten — laden Sie die Seite neu. Siehe Den Link zweimal öffnen.
Ihr Dienst wird ignoriert, und die normalen Karten erscheinen. Das JSON war lesbar, beschrieb aber keinen brauchbaren Dienst — ein type, der nicht wmts oder wms ist, eine fehlende url, oder ein WMS ohne layers oder format. Die App greift auf ihre eingebaute Liste zurück. Prüfen Sie die erforderlichen Eigenschaften für Ihren Diensttyp.
Gar keine Karten, auch nach einem Neuladen nicht. Entweder konnte das JSON nicht gelesen werden — ein überzähliges Komma, eine nicht geschlossene Klammer, ein nicht codiertes Zeichen — oder der Dienst ist nicht auf eine Weise erreichbar, die die App nutzen kann. Fügen Sie das JSON vor dem Codieren in einen beliebigen Validator ein. Prüfen Sie beim Dienst diese drei Dinge in dieser Reihenfolge:
- Cross-Origin-Zugriff. map.army zeichnet jede Kachel über ein Canvas, damit Helligkeit, Farbton und Sättigung angepasst werden können und die Karte in einen Export eingehen kann. Das bedeutet, Ihr Dienst muss einen
Access-Control-Allow-Origin-Header senden, der den Origin der App zulässt. Ein Dienst, der das nicht tut, zeigt überhaupt nichts, obwohl genau dieselbe Kachel-URL in einem Browser-Tab einwandfrei öffnet. Das ist die häufigste Ursache für einen korrekt aussehenden Dienst, der nie erscheint, und am schwersten zu erraten. - HTTPS. Ein Browser blockiert reines HTTP-Bildmaterial innerhalb einer HTTPS-Seite.
- Erreichbarkeit. Bestätigen Sie, dass der Dienst vom Rechner aus antwortet, auf dem der Browser läuft, und nicht nur aus Ihrem eigenen Netzwerk heraus.
Lässt sich Ihr Dienst nicht dazu bringen, Cross-Origin-Header zu senden, ist die übliche Lösung, ihm einen Proxy vorzuschalten, der das kann, auf Ihrer eigenen Infrastruktur.
Was ein Link nicht kann
- Nur ein Dienst pro Link. Es gibt keine Möglichkeit, eine Liste zu übergeben, und keine, Ihren Dienst zu den eingebauten Karten hinzuzufügen.
- Er wird nicht gespeichert. Jeder Besuch braucht den Link erneut.
- Er erscheint nicht als neuer Eintrag im Options-Panel — er nimmt den Platz der gesamten Liste ein, und die Zeile Kartentyp verschwindet.
- Er reist nicht mit einer Freigabe. Siehe oben.
epsg,epsgExtentundtileSizewerden hier berücksichtigt, aber nicht in der eigenen Konfigurationsdatei einer Bereitstellung, sodass ein Link einen Dienst präziser beschreiben kann, als es eine installierte Bereitstellung kann.
Für eine dauerhafte Liste Ihrer eigenen Dienste, auswählbar wie jede andere Karte und von allen Nutzenden dieser Bereitstellung gemeinsam genutzt, siehe Frei vs Pro.
Zuletzt aktualisiert: