The REST API in the Geoportal
The Geoportal REST API allows each metadata record in the geoportal catalog to be assigned a unique web-accessible URL. The geoportal catalog can also be queried through URLs using REST syntax. Accessing individual metadata documents through their REST URLs, or groups of documents that match specific search criteria through a REST-formatted search URL, provides powerful functionality for searching, viewing, and sharing records. For example, you can send the URL to a metadata document or a search to colleagues, and they can access that resource without having to go to the geoportal and conduct their own search. Integrating the URLs into other web pages, or your organization's Content Management System, provides users with quick links to resources again without having to do their own search. Additionally, the REST API allows for easy integration with external applications, as described below.
To see the REST URL for an individual metadata record, click the Details link for the record in the search results and scroll to the bottom of the Details page. The URL will be formatted similar to the following, with a unique GUID: /geoportal/rest/document?f=html&id=%7B<GUID>%7D.
To see the REST-formatted results for a specific search, scroll to the bottom of the geoportal search results page after performing the search to view links for the search in GEORSS, ATOM, HTML, FRAGMENT, KML, and JSON REST format. Each REST format is described in the table below, with an example of how that format can be used in an external application.
| REST format | Description | External application |
|---|---|---|
GEORSS | View results in GEORSS format, also allowing users to subscribe to an RSS feed for records matching search criteria | RSS readers such as Microsoft Outlook, Microsoft Internet Explorer, and Mozilla Firefox |
ATOM | View results in ATOM format, another standard for retrieving syndication feeds that also allows users to subscribe to updates | RSS readers such as Microsoft Outlook, Microsoft Internet Explorer, and Mozilla Firefox |
HTML | Formats results as a full HTML document | Content Management Systems and Wikis such as Microsoft SharePoint, Joomla!, and Apache JSPWiki |
FRAGMENT | Formats results as an HTML fragment without the <html>, <head>, <title>, or <body> tags | Content Management Systems and Wikis such as Microsoft SharePoint, Joomla!, and Apache JSPWiki |
KML | Formats results in KML, allowing for display of search results in web mapping applications | Mapping applications such as Google Maps and Google Earth |
JSON | Pretty prints results in JSON format | Custom applications |
The REST API also allows you to search the Geoportal directly from a web browser with OpenSearch capability. There are limitless possibilities with how your Geoportal catalog can be integrated into other applications, thereby increasing the prominence and exposure of your metadata catalog.