Die REST-API im Geoportal
Mit der Geoportal-REST-API können die einzelnen Metadatensätze im Geoportal-Katalog einer eindeutigen URL mit Webzugriff zugewiesen werden. Der Geoportal-Katalog kann auch über URLs mithilfe der REST-Syntax abgerufen werden. Der Zugriff auf einzelne Metadatendokumente mithilfe ihrer REST-URLs oder auf Gruppen von Dokumenten, die bestimmten Suchkriterien entsprechen, mithilfe einer Such-URL im REST-Format ist beim Suchen, Anzeigen und Freigeben von Datensätzen ausgesprochen praktisch. Beispielsweise können Sie die URL an ein Metadatendokument oder eine Suche an Kollegen senden. Diese können die Ressourcen dann ohne Geoportal nutzen und müssen keine eigene Suche durchführen. Durch Einbindung der URLs in andere Webseiten oder in das Content-Management-System der Organisation erhalten Benutzer Links zu Ressourcen. Auch hier muss keine eigene Suche durchgeführt werden. Außerdem erleichtert die REST-API die Einbindung externer Anwendungen, wie unten erläutert.
Um die REST-URL eines einzelnen Metadatensatzes anzuzeigen, klicken Sie in den Suchergebnissen auf den Link Details des jeweiligen Datensatzes, und führen Sie einen Bildlauf bis zum Ende der Seite mit den Details durch. Die URL wird ähnlich wie im folgenden Beispiel mit einer eindeutigen GUID formatiert: /geoportal/rest/document?f=html&id=%7B<GUID>%7D.
Um die Suchergebnisse im REST-Format für eine bestimmte Suche anzuzeigen, blättern Sie nach Durchführung der Suche zum Ende der Seite mit den Geoportal-Suchergebnissen, wo Sie die Links für die Suche in den Formaten GEORSS, ATOM, HTML, FRAGMENT, KML und JSON REST finden. Die einzelnen REST-Formate werden in der Tabelle unten mit jeweils einem Verwendungsbeispiel in einer externen Anwendung erläutert.
| REST-Format | Beschreibung | Externe Anwendung |
|---|---|---|
GEORSS | Ergebnisse werden im Format GEORSS angezeigt. So können Benutzer auch einen RSS-Feed für Datensätze abonnieren, die Suchkriterien entsprechen. | RSS-Leser wie Microsoft Outlook, Microsoft Internet Explorer und Mozilla Firefox |
ATOM | Ergebnisse werden im Format ATOM angezeigt, einem weiteren Standard zum Abrufen von Syndication-Feeds, mit dem Benutzer Aktualisierungen abonnieren können. | RSS-Leser wie Microsoft Outlook, Microsoft Internet Explorer und Mozilla Firefox |
HTML | Ergebnisse werden als vollständiges HTML-Dokument formatiert. | Content-Management-Systeme und Wikis wie Microsoft SharePoint, Joomla! und Apache JSPWiki |
FRAGMENT | Ergebnisse werden als HTML-Fragment ohne die Tags <html>, <head>, <title> oder <body> formatiert. | Content-Management-Systeme und Wikis wie Microsoft SharePoint, Joomla! und Apache JSPWiki |
KML | Ergebnisse werden im KML-Format formatiert, um Suchergebnisse in Web-Mapping-Anwendungen anzeigen zu können. | Anwendungen zur Kartenerstellung wie Google Maps und Google Earth |
JSON | Ergebnisse werden im JSON-Format mit Pretty-Print ausgegeben. | Benutzerdefinierte Anwendungen |
Mit der REST-API können Sie mithilfe der Funktion OpenSearch das Geoportal zudem direkt über einen Webbrowser durchsuchen. Sie haben unendlich viele Möglichkeiten, Ihren Geoportal-Katalog in andere Anwendungen einzubinden und somit Ihren Metadatenkatalog möglichst auffällig zu positionieren.