Opensearch

The NextGEOSS data hub provides an OpenSearch interface supporting two-step search. Below you will find information about accessing the OpenSearch decription documents and the search endpoints, as well as a description of the available parameters. You will need a client to use OpenSearch. If you do not have an OpenSearch client or you are not a developer using the OpenSearch interface as the backend of your client or project, the OpenSearch interface is not for you. Please use the Web interface.

Accessing the Description Documents

The description documents are available at the following endpoint: https://catalogue.nextgeoss.eu/opensearch/description.xml?osdd={OpenSearch Description Document ID}. The osdd parameter is required. There is one description document for step one of two-step search (or "collection search") and each individual collection has its own description document. The search results of collection search include a link to the description document for each collection, so you only need the description document for collection search in order to begin using the OpenSearch interface. Your client will discover the relevant collection-level description documents for you as you search.

Access the collection search description document here:
https://catalogue.nextgeoss.eu/opensearch/description.xml?osdd=collection

Accessing the Search Endpoints

The search endpoints are located at https://catalogue.nextgeoss.eu/opensearch/collection_search.atom? (for step one or collection search) and https://catalogue.nextgeoss.eu/opensearch/search.atom? (for step two or product search/search within a given collection).

The description documents instruct your client how to query each endpoint.

Search Parameters

Consult a description document and the related standards for details about the supported search parameters. The data hub supports the OpenSearch Geo and Time extensions.

By default, the following parameters are supported:

  • opensearch:searchTerms
  • opensearch:searchTerms
  • opensearch:maxResults
  • opensearch:startPage
  • geo:box
  • geo:geometry
  • geo:uid
  • time:start
  • time:end
  • eo:modificationDate

Additional parameters, including parameters that are specific to individual collections (like cloud coverage) will be added as the project progresses.

Search Results

The OpenSearch search results present a subset of the metadata available for each collection or product in the results. These defaults are chosen to comply with OGC OpenSearch best practices. For more details, consult OGC's documentation.

The metadata included in each entry in the results feed are:

  • atom:title
  • atom:id
  • dc:identifier
  • atom:link rel="self"
  • atom:link rel="up"
  • dc:publisher
  • atom:published
  • atom:updated
  • atom:summary
  • dc:date
  • georss:polygon
  • atom:link rel="alternate"
  • atom:category
  • atom:link rel="enclosure"

More detailed metadata will be added as the project progresses.