Schnittstelle

Schnittstelle

Das LVGL stellt umfangreiche Geoinformationen als standardisierte Geodienste, auch GeoWeb-Dienste oder GeoWebServices, genannt, zur Verfügung. Diese Dienste sind Grundlage für eine Vielzahl von Online Fachanwendungen im Geoportal.

Darüber hinaus können diese Dienste aber auch unmittelbar in ein Geographisches Informationssystem (GIS) eingebunden werden und entfalten so ihren vollen Mehrwert. Das Einbinden von WMS-Diensten erfolgt jeweils über eine eigene Internet-Adresse (WMS-URL).

Der WMS ist der am häufigsten genutzte Kartendienst um Karten zu präsentieren. Mit seiner Hilfe werden internetbasierte Kartenausschnitte abgefragt, als temporärer Rasterkartenausschnitt visualisiert und in Nutzerapplikationen eingebunden. Dort sind sie Grundlage für die Kombination oder Überlagerung mit eigenen Karten und Fachdaten.

Karten lassen sich grundsätzlich sowohl von frei verfügbaren als auch von geschützten WebMapServivces abrufen.

Im Geoportal Saarland sind WMS-Dienste mit drei unterschiedlichen Freigabestufen registriert:

• Freie WMS Dienste ohne Präfix, in der Regel sind Umweltfachdaten freigegeben (Beispiel: Bodendaten, Naturschutzdaten, Geologie usw.) (keine Registrierung notwendig).
• Im Landesdatennetz freigegebene WMS-Dienste mit dem Präfix SL-Netz (Beispiel Geobasisdaten oder Fachdaten ohne Maßstabsbegrenzung) (keine Registrierung und Freischaltung bei Nutzung im Landesdatennetz notwendig).
• Abgesicherte, kostenpflichtige WMS-Dienste mit dem Präfix Premium (räumlich abgesichert) bzw. Premium SL (saarlandweit) verfügbar bzw. freischaltbar (Beispiel Liegenschaftskarte, DOP 2013; Bodenschätzung usw.) (Registrierung und Freischaltung notwendig).

Möchten Sie einen WMS Dienst in ihr System einbinden, müssen Sie in einem ersten Schritt die Adresse bzw. URL des Dienstes kennen. Freie WMS Dienste haben in der Regel kein Präfix und können ohne Nutzungsbeschränkungen eingeladen werden. Das Geoportal stellt verschiedene Schnittstellen zur Verfügung, die im Folgenden näher beschrieben werden.

Möchten Sie abgesicherte Dienste nutzen müssen Sie sich in einem ersten Schritt im Geoportal registrieren.

Schnittstellen im Portal

Das Geoportal stellt genormte Schnittstellen nach dem OGC- Standard zur Verfügung (siehe http://www.opengeospatial.org).

• WMS - Web Map Service, zur visuellen Darstellung von Geodaten als Karten
• WFS - Web Feature Service, zum Herunterladen von Feature-Daten
• CSW - Catalog Service, zur Suche nach Metadaten

Der getCapabilities Aufruf liefert ein OGC WMS Capabilities Dokument (XML) zurück, das alle Informationen enthält, die ein OGC WMS Client benötigt, um Kartenanfragen an den Server zu beantworten.

Verfügbare WMS- Schnittstellen

Abhängig vom Dienst sind folgende Schnittstellen verfügbar:

• Geoportal Capabilities
  Für die im Geoportal registrierten Dienste (i.d.R. WMS-Gruppen) werden pro Layer jeweils ein GetCapabilities Aufruf mit einem Service Metadatensatz generiert und mit Metadateninformationen angereichert. Es besteht die Möglichkeit, den Kartendienst dauerhaft in Ihrem eigenen Kartenclient einzubinden. Diese Schnittstelle steht Ihnen immer zur Verfügung. (Vorteil: Das Geoportal funktioniert wie eine Registry, so dass die Geoportal Capabilities auch gleich bleiben, wenn sich die DienstURL beim Datenanbieter etwa wegen eines Serverumzuges ändert). Wir bieten Ihnen 2 Arten der Geoportal Capabilities an. Zum einen ein Capabilities Dokument, das nur speziell die Einzelebene beinhaltet und zum anderen ein Capabilities Dokument, das sämtliche Unterebenen beinhaltet, da oftmals Dienste zusätzlich Layer in Ihren Unterebenen enthalten, die gruppiert eingeladen werden sollen.
• Original Capabilities
  Angabe der originalen Capabilities des Dienstes, wie der Datenanbieter ihn bereitstellt - steht bei freien Diensten (i.d.R. ohne Präfix) und bei Diensten die im Landesdatennetz freigegeben sind zur Verfügung (erkennbar am Präfix „SL-Netz“).
  
  Die Verwendung der Original Capabilities ist bei Systemen sinnvoll, welche die getMap Adresse aus der Aufrufadresse generieren und diese nicht aus den Capabilities entnehmen. Es wird immer der gesamte Dienst mit Unterlayern dargestellt, Vorsicht: Original Capabilities können sich ändern, wenn bspw. ein Serverumzug notwendig wird -> vgl. Monitoring abonnieren)


• INSPIRE Capabilities URL
  Die INSPIRE-RL stellt umfangreiche Anforderungen bezüglich der Bereitstellung von Diensten. Da die originalen Service Capabilities nicht alle INSPIRE-relevanten Informationen zur Verfügung stellen, werden die Daten im Geoportal mit den notwendigen Informationen angereichert.


• INSPIRE Service MetadatenDatei:Inspiresymbol.jpgDatei:Rdfsymbol.jpg
  Liefert die INSPIRE Metadaten des Dienstes.


• Validierung gegen INSPIRE Geoportal
  Stellt Ihnen einen Validator zur Verfügung, der prüft, ob die Metadaten des Dienstes INSPIRE konform sind.


• Secured Capabilities URL
  Damit können Sie bei Premium SL Diensten die Karte dauerhaft in ihre externe GIS – Software einbinden. Dies ist möglich, wenn Sie vom LVGL für diesen Dienst freigeschaltet wurden. (siehe Freischaltung von Diensten)


• KML
  Schnittstelle zur Verwendung in Google Earth.

Schnittstellen eines abgesicherten Dienstes (Beispiel)

Die wesentlichen Schnittstellen finden Sie, wenn Sie sich die Metadaten eines Dienstes betrachten. Sie gelangen dorthin, indem Sie den Diensttitel klicken.

Hier „Premium SL: DOP20 (2013)“

Nun öffnet sich ein Fenster, das die Metadatenbeschreibung beinhaltet.

Um zu den Capabilities Dokumenten zu gelangen, müssen Sie in den Karteireiter "Schnittstellen" wechseln.

Durch das Auswählen von

• Link zum Capabilities Dokument wird Ihnen im Browser das GetCapabilities Dokument angezeigt
• öffnet sich ein Fenster, indem die GetCapabilities URL angezeigt wird und herauskopiert werden kann, diese wird benötigt um den Service in Ihre Präsentationssoftware einzuladen.

Abgesicherte Dienste

Das Portal verfügt über eine integrierte Sicherheits- und Loggin-Komponente. Demzufolge finden Sie im Geoportal unterschiedlich abgesicherte Dienste. Anhand ihrer Bezeichnung erkennt man die betreffende Freigabestufe. Datei:BspBezeichnungeinesDienstes.jpg

Antrag auf Freischalten eines abgesicherten Dienstes

Sie können im Geoportal einen Antrag auf Freistellung stellen oder sich via E-Mail an uns wenden.

Freischaltung über das Geoportal

• Melden Sie sich im Geoportal unter Login mit Ihrem Nutzer an. Sollten Sie sich noch nicht registriert haben, müssen Sie dies noch zuvor durchführen.
• Suchen Sie nach dem gewünschten Dienst im Suchfeld.
  Datei:Dop2013.jpg
• Unter „Interaktive Daten“ finden Sie eine entsprechende Trefferliste der vorhandenen Dienste.
  Datei:Trefferlistedop2013.jpg
• Zur Beantragung eines geschützten Dienstes, klicken Sie bitte auf den Button (Dienste Berechtigung). Im folgenden Dialog „Antragstellung Freischaltung“ können Sie mit uns in Kontakt treten.

Freischaltung per E-Mail

Senden Sie eine E-Mail. Um die Freischaltung zeitnahe zu ermöglichen, benötigen wir folgende Angaben von Ihnen:

Ihren Benutzernamen
Ihre E-Mailadresse
Titel des freizuschaltenden Dienstes

Einladen eines abgesicherten Dienstes

Gehen Sie wie unter dem Punkt "Beispiel: Schnittstellen eines abgesicherten Dienstes" beschrieben vor, um zu den Capabilities Dokumenten zu gelangen.

• Öffnen Sie den Karteireiter "Schnittstellen" und klicken Sie auf das Verknüpfungssymbol bei „Secured Capabilities URL“.
  Datei:Markiert sec cap.JPG
• Beachten Sie: Bei abgesicherten Diensten werden die Original Capabilities nicht angezeigt und die Geoportal Capabilities enthalten in diesem Fall einen sog. Session-Key, der bei abgesicherten Diensten nicht unbegrenzt gültig ist.
• Es öffnet sich ein Fenster, aus dem Sie sich die Capabilities-URL des Dienstes kopieren können.
  Beispiel: https://geoportal.saarland.de/http_auth/34908?REQUEST=GetCapabilities&VERSION=1.1.1&SERVICE=WMS
• Diese benötigen Sie, um den Kartendienst in Ihre Software einzubinden. Wenn die Anmeldemaske Ihrer GIS - Software erscheint, geben Sie Ihre Geoportal-Zugangsdaten ein. Dies können Sie in zwei Varianten tun.
  
  1. Benutzername: MaxMustermann;m.mustermann@muster.com
  Passwort: Ihr Passwort
  
  Achten Sie auf das Semikolon zwischen Benutzernamen und Email-Adresse!
  
  2. Benutzername: MaxMustermann
  Passwort: Ihr Passwort
  
  Um die zweite Variante der Anmeldung zu nutzen ist es notwendig, dass Sie sich nach der Registrierung einmal im Geoportal anmelden.

  Verwenden des Style - Parameter

  Wir bieten bei einigen Diensten den Style - Parameter an. Dieser ermöglicht Ihnen aus mehreren vordefinierten Darstellungen, eine zu wählen. Zum Beispiel können Sie entscheiden, ob unser WMS-Dienst in einem Farbwert-Style oder in einem Grauwert-Style präsentiert werden soll.
  

  Zuvor sollten Sie sicherstellen, dass Ihr Präsentationsprogramm diesen Parameter unterstützt. Ist dies nicht der Fall, sollte standardmäßig der "Default-Style" Parameter benutzt werden mit dem Sie die Original Ansicht des WMS-Dienstes präsentiert bekommen sollten.
  

  Im Folgenden zeigen wir Ihnen an zwei Beispielen, wie man bei einem WMS-Dienst mit Style-Parameter den Style ändern kann:

  ---

  ArcGIS V. 10.2.2
  

  Öffnen Sie die Layer-Eigenschaften und wählen Sie unter dem Reiter "Styles" das Dropdownmenü "Layer-Style auswählen" den gewünschten Style aus.

  ---

  Qgis V. 2.10

  Beim Einladen eines WMS können Sie auswählen welcher Style eingeladen werden soll. Datei:Qgis.jpg

  ---

  Einbinden in einen UMN Mapserver Beispiel einer Layer-Konfiguration in einem Mapfile:

  
  LAYER

    NAME 'sl_dop2013'
  

    TYPE RASTER
  

   1. CONNECTIONTYPE WMS
  

   2. CONNECTION "https://geoportal.saarland.de/http_auth/37350?"
  

      METADATA
  

      'wms_title' 'TEST HTTP_AUTH'
  

   3.   "wms_proxy_host" "xxx"
  

   4.   "wms_proxy_username" "xxx" 
  

   5.   "wms_proxy_password" "xxx" 
  

   6.   "wms_proxy_port" "xxx" 
  

      'wms_abstract'  
  

   7.   "wms_name" "sl_dop2013" 
  

      'wms_srs'   'EPSG:31466 EPSG:31467 EPSG:31468 EPSG:4326 EPSG:4258 EPSG:3034'
  

      'wms_extent'         '2525932 5442177 2602112 5500809'
  

   8.   "wms_auth_username" "MaxMustermann"
  

   9.  "wms_auth_password" "xxx"
  

   10.  "wms_auth_type" "digest"
  

      "wms_server_version" "1.1.1" 
  

      "wms_formatlist" "image/png,image/jpeg,image/gif,image/bmp,image/swf" 
  

      "wms_format" "image/jpeg" 
  

      "wms_enable_request" "*" 
  

  
  

  Zu 1.

  Es wird ein WMS- Dienst eingebunden.

  Zu 2.

  URL des Dienstes.

  Zu 3. bis 6.

  Optionale Angabe, in dem Fall, dass Sie über einen Proxy ins Internet gehen.

  Zu 7.

  Der Layername des Dienstes der angefordert wird, muss exakt mit dem Layernamen des einzubindenden Dienstes übereinstimmen. Es Kann auch eine durch Komma getrennte Liste angegeben werden.

  Zu 8. Bis 9.

  Die eigentliche Authentifizierung. Muss durch Ihre Zugangsdaten ausgefüllt werden.

  Zu 10.

  Die Art der Authentifizierung, muss „digest“ sein.