Metadata

The AODN Geospatial Portal is a front end to GeoNetwork and other web services. You will need to point your portal instance at a GeoNetwork instance. The metadata served by GeoNetwork must reference online resources for WMS and data download services. It must also be marked up with terms that conform to the AODN vocabularies.

GeoNetwork

Our GeoNetork build contains all the necessary schema plugins and vocabularies.

You can find the latest version on our Jenkins server. Just download geonetwork.war and deploy it to a tomcat instance.

Metadata configuration

There are instructions below, but the easiest way may be to look at some examples:

Go to the IMOS instance of the AODN portal.

Choose a data collection that is similar to the one you wish to publish.

Follow the link to the metadata. A link to the metadata is available in three places for each data collection. You can find it by following the "continue reading" link on Step 1. You can find it under the "info" tab on Step 2. You can also find it by following the "view metadata record" link on Step 3. Each of these links will take you to our GeoNetwork Catalog. From there you can choose "XML view" to see how the data collection was configured.

Copy the metadata into your own GeoNetwork catalog and modify as appropriate.

Linking to map layers

Each of your metadata records must include a link to a corresponding WMS layer so that it can be displayed in the AODN portal. The following XML fragment is an example:

<gmd:onLine>
<gmd:CI_OnlineResource>
<gmd:linkage>
<gmd:URL>http://geoserver-123.aodn.org.au/geoserver/wms</gmd:URL>
</gmd:linkage>
<gmd:protocol>
<gco:CharacterString>OGC:WMS-1.1.1-http-get-map</gco:CharacterString>
</gmd:protocol>
<gmd:name>
<gmx:MimeFileType type="text/html">imos:argo_profile_layer_map</gmx:MimeFileType>
</gmd:name>
<gmd:description>
<gco:CharacterString>Argo Profiles</gco:CharacterString>
</gmd:description>
</gmd:CI_OnlineResource>
</gmd:onLine>

The AODN portal can also display ncWMS layers. Here is an example:

<gmd:onLine>
<gmd:CI_OnlineResource>
<gmd:linkage>
<gmd:URL>http://rs-data1-mel.csiro.au/ncWMS/wms</gmd:URL>
</gmd:linkage>
<gmd:protocol>
<gco:CharacterString>OGC:WMS-1.1.1-http-get-map</gco:CharacterString>
</gmd:protocol>
<gmd:applicationProfile gco:nilReason="missing">
<gco:CharacterString/>
</gmd:applicationProfile>
<gmd:name>
<gco:CharacterString>oc.SO-Johnson.chl.8d.seawifs/chlorophyll</gco:CharacterString>
</gmd:name>
<gmd:description gco:nilReason="missing">
<gco:CharacterString/>
</gmd:description>
</gmd:CI_OnlineResource>
</gmd:onLine>

Download Options

Download types and configurations are documented here.

Some examples follow:

Linking to a WFS for data download

You also need to include a download service in your metadata. The AODN portal will send a request to your download service when the user clicks "download".

The preferred data download service is Geoserver WFS. We prefer the GeoServer implementation of WFS because it allows data to be filtered.

Example:

<gmd:onLine>
<gmd:CI_OnlineResource>
<gmd:linkage>
<gmd:URL>http://geoserver-123.aodn.org.au/geoserver/ows</gmd:URL>
</gmd:linkage>
<gmd:protocol>
<gco:CharacterString>OGC:WFS-1.0.0-http-get-capabilities</gco:CharacterString>
</gmd:protocol>
<gmd:name>
<gco:CharacterString>argo_profile_download_data</gco:CharacterString>
</gmd:name>
<gmd:description>
<gco:CharacterString>This OGC WFS service returns filtered geographic information. The returned data is available in multiple formats including CSV.</gco:CharacterString>
</gmd:description>
</gmd:CI_OnlineResource>
</gmd:onLine>

List of URLs (BODAAC)

The AODN portal will also accept a link to a BODAAC service that returns OpenDAP URLs matching a query. This option is useful if your data is stored in netCDF files instead of a relational database. In this case users will get a list of URLs if they click the download button.

Example:

<gmd:onLine>
<gmd:CI_OnlineResource>
<gmd:linkage>
<gmd:URL>http://geoserver-123.aodn.org.au/geoserver/ows</gmd:URL>
</gmd:linkage>
<gmd:protocol>
<gco:CharacterString>IMOS:AGGREGATION--bodaac</gco:CharacterString>
</gmd:protocol>
<gmd:name>
<gco:CharacterString>acorn_hourly_avg_bonc_nonqc_timeseries_url#file_url</gco:CharacterString>
</gmd:name>
<gmd:description>
<gco:CharacterString>The BODAAC is a WFS service that returns a list of OpenDAP URLs matching a query.</gco:CharacterString>
</gmd:description>
</gmd:CI_OnlineResource>
</gmd:onLine>

GoGoDuck for serving subsetted/aggregated gridded data

Another data download option is the GoGoDuck, which extends the BODAAC. We developed the GoGoDuck service in-house for sub-setting and aggregating gridded data. If you wish to specify a GoGoDuck, you will need two online resource sections: the GoGoDuck resource itself, and a BODAAC resource that tells the GoGoDuck where to find the files.

GoGoDuck example:

<gmd:onLine>
<gmd:CI_OnlineResource>
<gmd:linkage>
<gmd:URL>http://geoserver-123.aodn.org.au/geoserver</gmd:URL>
</gmd:linkage>
<gmd:protocol>
<gco:CharacterString>IMOS:AGGREGATION--gogoduck</gco:CharacterString>
</gmd:protocol>
<gmd:name>
<gco:CharacterString>acorn_hourly_avg_bonc_nonqc_timeseries_url</gco:CharacterString>
</gmd:name>
<gmd:description>
<gco:CharacterString>The GoGoDuck subsets and aggregates gridded data. Data is returned as a NetCDF file.</gco:CharacterString>
</gmd:description>
</gmd:CI_OnlineResource>
</gmd:onLine>

nb. You also need a BODAAC section (see previous example)

Attached data

You can also make data available by linking directly to a file.

Example:

<gmd:onLine>
<gmd:CI_OnlineResource>
<gmd:linkage>
<gmd:URL>https://catalogue-123.aodn.org.au/geonetwork/srv/en/file.disclaimer?uuid=4402cb50-e20a-44ee-93e6-4728259250d2&fname=argo-dm-user-manual.pdf&access=private</gmd:URL>
</gmd:linkage>
<gmd:protocol>
<gco:CharacterString>WWW:DOWNLOAD-1.0-http--downloadother</gco:CharacterString>
</gmd:protocol>
<gmd:name>
<gmx:MimeFileType type="application/pdf">argo-dm-user-manual.pdf</gmx:MimeFileType>
</gmd:name>
<gmd:description>
<gco:CharacterString>Argo User's Manual</gco:CharacterString>
</gmd:description>
</gmd:CI_OnlineResource>
</gmd:onLine>

Other download options

The AODN portal supports the AODAAC, which is similar to the GoGoDuck.

Vocabularies

Our vocabularies are available separately via the ANDS vocabulary service.