Skip to content

Configuring downloads in metadata records

evacougnon edited this page Mar 22, 2023 · 23 revisions

The Portal uses the metadata record alone to determine the download options for a particular data collection.

The full list of protocols with their associated download option (label shown on step 3) and handlers is as follow:

Protocol Download Options Handler
OGC:WFS, OGC:WFS-1.0.0-http-get-capabilities CSV - non-gridded, Python WfsDownloadHandler, PythonDownloadHandler
IMOS:AGGREGATION--bodaac 'List of URLs' , Un-subsetted NetCDFs BodaacDownloadHandler
OGC:WPS--gogoduck NetCDF - gridded , CSV - gridded (point timeseries) GogoduckDownloadHandler, PointCSVDownloadHandler
AODN:FILE-list Un-subsetted Non-NetCDFs FileListDownloadHandler
ShapeFileDownloadHandler OGC:WFS-1.0.0-http-get-feature--shapefile Shapefile
ALA:Occurrence-download CSV - ALA , TSV - ALA , SHP - ALA AlaDownloadHandler
WWW:DOWNLOAD-1.0-http--csiro-oa-app CSV - DataTrawler DataTrawlerDownloadHandler
GA:Download GeoTIFF GaDownloadHandler

To set one of this protocol for a dataset collection:

  1. add/update the "OnLine resource", under "Distribution" when editing the metadata record (Note: use full view)
  2. select appropriate protocol or copy the name of the protocol if not listed in the drop down
  3. Update the following (see examples in the table below):
    • Linkage
    • Name of the resource
    • Description (most of the protocols have standard description, see table below for some example)

To find working example of other collections that are using the protocol you're thinking of using, type in the protocol's name in the Geonetwork search bar. The search runs on the xml file of the record, therefore would include the protocol's name.

Below are the most used protocols with their settings needed in the metadata record:

Service Feature Online resource type / Protocol Name of the resource Online resource href / Linkage Description
WFS CSV download, Python code snippet download OGC:WFS-1.0.0-http-get-capabilities Name of the layer e.g. aatams_sattag_qc_nrt_profile_data URL of the Geoserver e.g. http://geoserver-rc.aodn.org.au/geoserver/ows Standard description: "This OGC WFS service returns filtered geographic information. The returned data (label shown for download) is available in multiple formats including CSV."
BODAAC Download size estimation, List of URLs, Unsubsetted NetCDF IMOS:AGGREGATION--bodaac Name of the layer containing the URLs, the # symbol, then the name of the column containing the source URL (with no spaces) e.g. acorn_hourly_avg_rot_nonqc_timeseries_url#file_url URL of the Geoserver e.g. http://geoserver-rc.aodn.org.au/geoserver/ows Standard description: "The BODAAC is a WFS service that returns a list of OpenDAP URLs matching a query."
GoGoDuck Subsetted NetCDF download OGC:WPS--gogoduck Name of the layer containing the URLs e.g. cars_australia_weekly URL of the Geoserver e.g. http://geoserver-rc.aodn.org.au/geoserver Standard description: "The GoGoDuck subsets and aggregates gridded data. Data is returned as a NetCDF file."
FILE-list Download original files listed in WFS AODN:FILE-list Name of download option in Portal, this will change the download label on step 3. e.g. Un-subsetted Non-NetCDFs, Original CSV files, Original files (zipped) Complete Geoserver WFS request to get file URLs in CSV format e.g. http://geoserver-rc.aodn.org.au/geoserver/ows?service=WFS&request=GetFeature&typeName=aodn_nsw_oeh_bathy_map&propertyName=url&outputFormat=csv, https://geoserver-rc.aodn.org.au/geoserver/ows?service=WFS&request=GetFeature&typeName=imos:animal_tracking_acoustic_qc_detection_map&propertyName=url&outputFormat=csv Case by case description, e.g. " ", "Download original data (one csv file per tag)"

Multi-WFS

It is possible to use multi WFS setting in the metadata record. A good example are the satellite tagging collections (example). Set as many "OnLine Resource" with the WFS protocol that you have views to include. For each WFS, enter the standard description, including the text you want to see as the download label in brackets e.g. "This OGC WFS service returns filtered geographic information. The returned data (CTD profiles) is available in multiple formats including CSV."