Author | |
---|---|
Technical Contacts | |
Version | 1.1 |
Date | March 2024 |
Table of Contents |
---|
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.
...
Table of Contents |
---|
- wo ist was zu finden?
Main idea
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)
Exchange point for data ingest
Contact
Layer definitions, styles i.e., abstract etc.
Git repository O2A Spatial Data Products
upcoming O2A Data Product Configuration SOP
format was agreed upon.
Example files for media data:
View file | ||||
---|---|---|---|---|
|
View file | ||||
---|---|---|---|---|
|
View file | ||||
---|---|---|---|---|
|
View file | ||||
---|---|---|---|---|
|
View file | ||||
---|---|---|---|---|
|
View file | ||||
---|---|---|---|---|
|
Various options for data exchange are possible, such as shared projects in the cloud, git repositories or OAI-PMH.
For inquiries about exchange location and database ingestion frequency, please reach out to the GeoServer team.
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.owner.layer.toml
Making videos and photos available on the web typically involves a two-step process. First, they need to be transcoded, and then delivered via a web server. The subsequent sections present an overview of tools and recommendations that can assist you in this process.
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 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. Based 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.
Media files tend to be data intensive. Computing them on demand, as in the case of the image broker, might be challenge to the infrastructure, especially for high server loads. The The following recommendations are intended to reduce load times and contribute to a positive user experience.
Web server: Use state of the art and proven hosting applications, like NGINX or Apache HTTP Server.
HTTP/2: Improves Activate HTTP/2 to improve page loading speed, among otherse.g., via multiple request requests over one connection, binary protocol and compression of request headers.
Load balancing: Set up load balancing. Multiple combined media servers allow higher throughput (especially image broker) and provide fault tolerance.
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.
Currently, there are two viewer instances hosted in the web: Marine-Data and Earth-Data.
...
These data provisioning configuration files, along with their respective arrangements, are built on a predefined structure. You can find the documentation heredocumentation in the O2A Data Product Configuration SOP.
The repository for sharing your configuration files is located in the O2A Spatial Data Products repository. For access and further permissions, please contact one of the viewer teamtechnical contacts.
To visualize media data in the viewer properly, the following configuration files are required.
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 used instead of mapped to the technical names from of the data.
Example:
View file | ||||
---|---|---|---|---|
|
The viewer documentation Metadata Templates 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.
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.
...
Additionally, photos can be integrated in the sidebar. By providing urls URLs to images in multiple resolutions, responsive image loading can be used. This is further supported by the lightbox that opens when the an image is clicked, thus providing an enlarged view in adaptive resolution.
The required functions and all other template functions are available in the viewer Metadata Templates documentation.
Example:
View file | ||||
---|---|---|---|---|
|
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...
...
based on viewer steps
gallery.mapping.json
- wie funktioniert das mit mapping: item["properties#harmonized"]["persistent_identifier"]. Falls nicht vorhanden über item["properties#harmonized"]["name"] und falls das nicht als Kompbination aus [item["properties#harmonized"]["date_time"], item.geometry.coordinates.join(separator)]
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
The gallery's content depends on the URL query parameters. The parameters are composed as follows.
Query Parameter | Query Value | Required | Note |
---|---|---|---|
site | gallery | ✔️ | fixed query value |
ows | <ows_uri> | ✔️ | identifier used to find the gallery configuration in the catalogue (i.e., https://marine-data.de/rest/search/) via the resources.uri field. |
layer | <layer_name> | ✔️ | depend on the name of the layer in the GeoServer database |
filter | <cql-filter> | ✔️ | required to select a subset of the layer table, i.e., based on dataset, event, author etc. CQL and ECQL syntax are used (more infos) |
shareID | <persistent_identifier> | ❌ | if the persistent_identifier field is blank or does not exist in the gallery mapping file, the name field serves as the identifier, or if not present, a combination of location and time is used |
Example:
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.
All fields inside the mapping file are optional. If any field is missing, its corresponding functionality will not be enabled in the gallery.
A detailed description and overview can be found in the O2A Media Layer - Gallery Mapping documentation.
Like all other configuration files, the gallery mapping file is part of the configuration repository and should be provided in O2A Spatial Data Products.
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.Example