Skip To Content

Using the Geoportal REST API

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 formatDescriptionExternal 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.


В этом разделе
  1. The REST API in the Geoportal