Wie nutze ich die App „WMS Karte“?
Mit der App WMS Karte siehst du die Karten aus eurem Kartendienst (WMS) direkt am Datensatz in epilot, zum Beispiel aus eurem Geoinformationssystem (GIS) oder einem öffentlichen Geoportal. Das können Netzpläne, Leitungsverläufe, Flurstücke oder Luftbilder sein. Die Karte öffnet sich automatisch an der Adresse des Datensatzes, und du blendest die Ebenen ein, die du für den Vorgang brauchst.
So musst du nicht mehr in ein zweites System wechseln und die Adresse dort erneut suchen, wenn du etwa bei einem Netzanschluss wissen willst, welche Leitungen am Grundstück liegen. Dieser Artikel zeigt dir, wie du die App einrichtest und mit der Karte arbeitest.
Was ist ein WMS?
WMS steht für „Web Map Service“. Das ist ein gängiger Standard, über den GIS-Systeme und Geoportale ihre Karten für andere Anwendungen bereitstellen. Viele Landes- und Kommunalportale bieten solche Kartendienste öffentlich an, und die meisten GIS-Systeme können ihre Karten ebenfalls als WMS bereitstellen.
Voraussetzung
Du brauchst die Adresse eures WMS-Kartendienstes, zum Beispiel https://geo.stadtwerke-beispiel.de/geoserver/wms. Der Dienst muss über https:// aus dem Internet erreichbar sein. Ist er geschützt, brauchst du zusätzlich die Zugangsdaten: Benutzername und Passwort, ein Token oder einen API-Schlüssel. Diese Angaben erhältst du von eurem GIS-Team oder dem Betreiber des Kartendienstes. Stellt euer GIS noch keinen WMS bereit, muss euer GIS-Team ihn zuerst freischalten.
App installieren und einrichten
-
Navigiere zu Konfiguration → Integration → Apps und installiere im Tab Marketplace die App WMS Karte.
-
Trage die Angaben zu eurem Kartendienst ein (siehe Tabelle).
-
Speichere die Konfiguration. Die Angaben hinterlegst du nur einmal zentral, sie gelten für alle Nutzer:innen eurer Organisation.
| Einstellung | Bedeutung |
|---|---|
| Host (Pflichtfeld) | Der Name des Servers, ohne https:// und ohne Pfad. Im Beispiel oben: geo.stadtwerke-beispiel.de |
| Pfad | Der Teil der Adresse nach dem Servernamen. Im Beispiel oben: /geoserver/wms |
| Anmeldung am WMS-Server | Wie sich epilot am Kartendienst anmeldet: Keine (offener Server), Benutzername und Passwort, Bearer-Token oder API-Schlüssel. Je nach Auswahl erscheinen die passenden Felder für die Zugangsdaten. |
| Standard-Ebenen | Die Ebenen, die beim Öffnen der Karte bereits eingeblendet sind. Trage die technischen Namen der Ebenen ein, durch Komma getrennt. Die Namen kennt euer GIS-Team. Lässt du das Feld leer, startet die Karte ohne Ebenen. |
| Mapbox-Stil | Optional ein anderer Kartenhintergrund, zum Beispiel ein Satellitenbild. Ohne Angabe wird eine helle Straßenkarte verwendet. |
Deine Zugangsdaten sind geschützt
Passwort, Token und API-Schlüssel werden verschlüsselt bei epilot gespeichert. Sie sind nach dem Speichern für niemanden mehr sichtbar und werden nie an den Browser der Nutzer:innen übertragen.
Karte am Datensatz anzeigen
Nach der Installation steht dir die Karte als Bereich WMS Karte für die Detailansicht deiner Datensätze zur Verfügung, zum Beispiel an Opportunities, Kontakten oder Zählern.
-
Öffne im Entity-Builder die Entität, an der die Karte erscheinen soll, zum Beispiel Opportunity.
-
Füge die Capability WMS Karte hinzu und speichere.
-
Öffne einen Datensatz. Die Karte erscheint als eigener Bereich in der Übersicht.
Mit der Karte arbeiten
Standort des Datensatzes
Die Karte zentriert sich automatisch auf den Datensatz und markiert den Standort. Hat ein Datensatz mehrere Adressen, nutzt sie die Adresse des Standorts: zuerst die Lieferadresse bzw. die Adresse des Anschlussobjekts, dann weitere Adressen. Die Rechnungsadresse verwendet sie nur, wenn es keine andere gibt.
Sind an der Adresse Koordinaten hinterlegt, wird genau dieser Punkt angezeigt. Ohne Koordinaten sucht die Karte den Ort über die Adresse selbst. Dafür müssen mindestens Postleitzahl und Ort ausgefüllt sein.
Unter der Karte steht die Adresse, auf die sie gerade zentriert ist. Hast du die Karte verschoben, bringt dich Auf Datensatz zentrieren wieder zurück zum Standort.
Kein Standort hinterlegt
Hat der Datensatz weder Adresse noch Koordinaten, zeigt die Karte diesen Hinweis. Ergänze eine Adresse am Datensatz oder klicke auf Karte trotzdem anzeigen, um die Karte ohne Standort zu öffnen.
Ebenen ein- und ausblenden
Eine Ebene ist ein Thema eurer Karte, zum Beispiel „Stromnetz Niederspannung“, „Gasleitungen“ oder „Flurstücke“. Welche Ebenen es gibt, liest die App automatisch aus eurem Kartendienst. Du musst sie nicht einzeln anlegen.
-
Klicke in der Karte auf Ebenen.
-
Wähle eine oder mehrere Ebenen aus. Sie werden sofort über die Karte gelegt. Bei vielen Ebenen hilft dir das Suchfeld Ebenen durchsuchen.
-
Mit Alle abwählen blendest du alle Ebenen wieder aus.
Deine Auswahl ändert nichts an den Standard-Ebenen aus den App-Einstellungen und nichts für deine Kolleg:innen.
Tipp
Hinterlege als Standard-Ebenen die zwei oder drei Ebenen, die ihr im Alltag am häufigsten braucht. So sehen alle beim Öffnen eines Datensatzes sofort das Wichtigste, ohne erst auswählen zu müssen.
Häufige Fragen
Die Karte meldet „WMS-Karte ist noch nicht eingerichtet“. Was tun?
Dann fehlt in den App-Einstellungen noch eine Pflichtangabe, meist der Host. Die Meldung nennt dir, was fehlt. Ergänze die Angabe unter Konfiguration → Integration → Apps in der App WMS Karte.
Warum können die Ebenen nicht geladen werden?
Meist stimmt die Adresse des Kartendienstes nicht, oder die Zugangsdaten sind falsch oder abgelaufen. Prüfe Host, Pfad und die Anmeldung in den App-Einstellungen. Stimmen die Angaben, ist der Kartendienst möglicherweise nur aus eurem Firmennetz erreichbar. Sprich in diesem Fall mit eurem GIS-Team, denn der Dienst muss aus dem Internet erreichbar sein.
Die Karte zeigt die falsche Stelle. Woran liegt das?
Unter der Karte siehst du, welche Adresse sie verwendet. Die Karte bevorzugt die Lieferadresse bzw. die Adresse des Anschlussobjekts vor anderen Adressen des Datensatzes. Sind an der Adresse Koordinaten hinterlegt, haben sie Vorrang vor Straße und Ort. Ohne Koordinaten braucht die Karte mindestens Postleitzahl und Ort.
Warum verschwindet eine Ebene, wenn ich herauszoome?
Viele Kartendienste zeichnen detailreiche Ebenen wie Flurkarten oder Leitungspläne nur in der Nahansicht. Zoomst du weiter heraus, blendet die Karte die Ebene aus und zeigt den Hinweis Näher heranzoomen, um diese Ebene zu sehen. Zoome wieder hinein, dann erscheint die Ebene erneut. Ab welcher Ansicht eine Ebene sichtbar ist, legt euer GIS-Team am Kartendienst fest.
Warum ist eine Ebene in der Liste ausgegraut?
Der Kartendienst stellt diese Ebene nicht in dem Kartenformat bereit, das die App für die Darstellung braucht. Euer GIS-Team kann das am Kartendienst freischalten (Stichwort: Web Mercator, EPSG:3857).
Unser Kartendienst ist geschützt und die Ebenen werden nicht dargestellt. Warum?
Bei geschützten Kartendiensten muss der Dienst seine Karten im Format SVG ausliefern können. Bietet er das nicht an, zeigt die App einen entsprechenden Hinweis. Gib diesen Hinweis an euer GIS-Team weiter, es kann das Format am Kartendienst aktivieren.
Können wir mehrere Kartendienste gleichzeitig anbinden?
Die App verbindet sich mit einem Kartendienst. Von diesem kannst du beliebig viele Ebenen gleichzeitig einblenden.
Kann ich in der Karte etwas an unseren GIS-Daten ändern?
Nein. Die App zeigt die Karten nur an. An den Daten in eurem GIS ändert sie nichts.