...

Content

Table of Contents

GeoServer

The data can be hosted on the AWI GeoServer infrastructure. There are two important stages:

...

For both stages, a coordination with the GeoServer team is necessary. Please consult them if you intend to host your media data with the AWI GeoServer infrastructure to discuss what kind of data product — own layer(s) in own WMS, own layer(s) in existing WMS, integration of own data in existing layer(s) — suits your needs best.

File format and file exchange

In order to import the data into the GeoServer database and to allow the highest possible flexibility for the data provider, the O2A specification for GeoCSV (.sdi.csv) format was agreed upon.

Example files for media data:

...

For inquiries about exchange location and database ingestion frequency, please reach out to the GeoServer team.

Layer configuration

Besides the database, the GeoServer offers additional layer information, e.g. abstract, title, keywords. Moreover, there are other configuration options that the product owner must decide upon before the final layer can be hosted.

You can find out more about this topic in the O2A Data Product Configuration SOP. The corresponding configuration repository is O2A Spatial Data Products. For access and further permissions, please contact one of the technical contacts.

Provision of web media 

Making videos and photos available on the web typically involves a two-step process. First, they need to be transcoded, and then delivered via web server.  The subsequent sections present an overview of tools and recommendations that can assist you in this process.

Tools: Encoding of media files

When encoding photos and videos for the web, there is a trade-off between visual quality and data reduction. On the one hand, the media should be reduced in file size to achieve the best possible loading speed. On the other hand, the visual quality should not be degraded to the point of introducing unwanted artifacts. There are also technical parameters to consider that have a direct impact on browser performance and compatibility. To get an idea about the most important technical web video parameters, see Recommendation - Video Proxies Parameters.

...

ELEMENTS Image Broker: Web-API that brokers access to ELEMENTS content based on custom data fields, i.e. image-uuid. It is based on the implementation of the IIIF image standard with ELEMENTS as data source. For a detailed description and usage, see the git repository.

Recommendation: Hosting of media files

Media files tend to be data intensive. Computing them on demand, as in the case of the image broker, might challenge the infrastructure, especially for high server loads. The following recommendations are intended to reduce load times and contribute to a positive user experience.

...

Image broker cache: When using an image broker, it is highly recommended to enable media file caching. This will speed up the playout of images that have already been sent and are still in the cache. It can also help to reduce the amount of processing required when loading multiple images at the same time, i.e. in a media gallery, thus improving the user experience in the browser.

Viewer

Currently, there are two viewer instances hosted in the web: Marine-Data and Earth-Data.

...

To visualize media data in the viewer properly, the following configuration files are required.

Popup template

Image Modified

Clicking on a data point on the map triggers the appearance of a popup, which provides an overview of the data. Its style and information is configured via a template file written in markdown. Here, readable text can be mapped to the technical names of the data.

...

The vef documentation contains a comprehensive list of all functions available for displaying data. In case anything is missing, please get in touch with the viewer team.

Sidebar template

The sidebar template provides an overview of all the data associated with a data point. Besides displaying data in text form, media data can also be configured for playback.

...

Filter mapping

The viewer enables data filtering. As the naming of the data items may vary across different layers, consistent filtering across multiple layers is provided via filter mapping.

More coming soon...

Gallery

The media gallery provides a simple way to get an overview of all media files, e.g. in a dataset. In this lightbox, photos can be zoomed and viewed more closely, and videos can be played directly in the video player. Besides that, there is a metadata section that displays information from the item in the GeoServer layer. Moreover, it makes it possible to share items in the media gallery via links.

Demo gallery (with predefined configuration and dataset):
https://marine-data.de/?site=gallery

URL scheme

The gallery's content depends on the URL query parameters. The parameters are composed as follows.

...

https://marine-data.de/?site=gallery&layer=photos&filter=event='PS81/268-2'&shareID=7940784348543460

Gallery mapping 

A gallery mapping file needs to be present to enable flexible data structures and provide full functionality inside the gallery. It maps the dataset vocabulary (values in mapping dict) to the gallery vocabulary (keys in mapping dict) and is required for each GeoServer media layer.

...

Like all other configuration files, the gallery mapping file is part of the configuration repository and should be provided in O2A Spatial Data Products.

Metadata section

To prevent redundancy, the sidebar template of the viewer is also used in the media gallery. However, this template usually contains a method to display photos or videos. This method can be disabled in the media gallery as shown in the example file of the sidebar template above.