Konfiguration

Minimale Config

Eine Versionsnummer und eine Hintergrundkarte genügen für den Einstieg. Für andere Einstellungen gelten Standardwerte, die sich bei Bedarf überschreiben lassen.

Standardwerte: Diese Konfiguration enthält keine Angaben zu Ansicht, Bedienelementen oder Gestaltung. Der Viewer ergänzt Zoom, Kompass, Vollbild, Standort, Globusansicht, Maßstab, Quellenangaben, Koordinaten und Druck. Das Farbschema folgt dem Betriebssystem.

Die komplette Einbindung

Die Konfiguration oben ist direkt in die Seite eingebettet:

minimal.html

<script type="module" src="/map0.js"></script>

<map0-viewer style="height:520px">
  <script type="application/json">
    {
      "version": 1,
      "basemaps": [
        {
          "type": "style",
          "url": "https://mapsneu.wien.gv.at/basemapv/bmapv/3857/resources/styles/root.json"
        }
      ]
    }
  </script>
</map0-viewer>

Drei Wege, eine Config zu übergeben, in dieser Rangfolge:

Eine config-Property, gesetzt aus JavaScript (für SPAs und Wrapper)
Ein config-src-Attribut, das auf eine JSON-Datei zeigt
Ein <script type="application/json">-Element innerhalb des Viewers, wie oben gezeigt

Wenn die Config falsch ist

Der Viewer prüft die Konfiguration vor der Darstellung. Fehler erscheinen direkt mit dem JSON-Pfad der betroffenen Einstellung:

error panel

$.basemaps          at least one basemap is required, e.g. { "type": "style", "url": "…" }
$.layers[2].url     a "wms" layer needs a "url"
$.layers[2].layers  a "wms" layer needs "layers" (WMS LAYERS parameter)