This website uses cookies to ensure you get the best experience. By clicking or navigating the site you agree to allow our collection of information through cookies. More info

2 minutes to read Posted on Monday January 6, 2020

Tech

Europeana Media Policy

The Europeana Media Policy is a document for data partners who share their material in Europeana Collections. It outlines the requirements for the links to the media resources that are part of the provided metadata. It complements the information provided with the Europeana Publishing Guide and the EDM Mapping Guidelines. By following these requirements, we can give audiences a better experience and a greater connection with your collections. 

Following these requirements we will:

  • Extract technical metadata from media resources (e.g. mime-type, image size, duration, colour) to allow for a richer search and browse experience and to power functionalities such as enlarging and downloading images and other media.
  • Generate thumbnail (preview) images based on media resources, and show these images as part of the search results to help users find what they are looking for.
  • Display media resources on the item pages in Europeana Collections for a user to get the best possible experience and be able to interact with the content.

Metadata and media

We will process (links to) media resources in the following three metadata fields:

  • edm:object
  • edm:isShownBy
  • edm:hasView (for each - More than one instance of edm:hasView is possible when more than one media resource is provided.)

We will also process links provided with edm:isShownAt, but we will not generate any thumbnails. Processing the edm:isShownAt involves checking that the link is resolvable and storing the mime-type of the working link.

For more details about the metadata fields and their definition, please consult the EDM documentation. More details on how the links to media resources are used by the Europeana Collections website to ensure a seamless user experience are described on Europeana Pro.

Extract technical metadata

Europeana will extract metadata from the media resources provided via the above metadata fields to aid search in Europeana Collections and the APIs, and to determine how to present or consume a web resource in Europeana Collections. This is what we refer to as technical metadata (e.g. the image size, image colours, duration of audio clips). An overview of all the technical metadata which is extracted can be found in the EDM profile for technical metadata. An overview of all the technical metadata facets in Europeana Collections can be found at Documentation on the Europeana Search API. The content tiers, i.e. the quality of a media resource as specified in the Europeana Publishing Framework, are calculated on the basis of the technical metadata.

Retrieving the links to media resources in the above mentioned metadata fields is required in order to access and download those media resources. Downloading each resource is necessary in order to generate the technical metadata (and thumbnails, see below). Europeana will only temporarily download the media resource, which will be discarded after processing.

In order to successfully access and download a media resource, the following requirements must be met:

Generate thumbnail (preview) images

Thumbnails are a small image of the digital object. They directly affect the user click-through rate. Requirements and recommendations about the quality of thumbnails are provided in the Europeana Publishing Guide.

We will generate thumbnails from the media resources provided via the above metadata fields, if the mime-type of the media resources is valid (see also above). Note that for media resources with the mime-type “application/pdf” we only generate a thumbnail when we find an image in the pdf.

We will generate the following thumbnails:

  • An image with a width of at maximum 200 pixels.
  • An image with a width of at maximum 400 pixels.

The following must be noted:

  • The height of the thumbnail will be proportional in accordance with the aspect ratio.
  • If an image is smaller than 200 or 400 pixels, the original width of the image will be used as the size of the thumbnail (Europeana does not recommend to use images which are smaller than 400 pixels in width).

All thumbnails that we generate can be retrieved via the Thumbnail API. Note that for the thumbnail used for display in the search results of Europeana Collections, we have a specific metadata field: edm:preview. The value for edm:preview will be the thumbnail corresponding to either the media resource obtained from edm:object if available, otherwise the image with the highest resolution of either edm:isShownBy or the first edm:hasView.

Display of media resources

CORS

In order for the Europeana Collections portal to access and display media resources coming from providers’ servers, the latter must support Cross-Origin Resource Sharing (CORS). This is because web browsers restrict resources on a web page to be requested from another domain outside the domain it was served (Collections in this case). The CORS standard is needed because it allows servers to specify not only who can access its resources but also how these resources can be accessed. 

This is especially important for providers who share resources via IIIF as CORS is essential for our IIIF viewer to perform the image information requests and to obtain the presentation manifests. Without CORS, although the IIIF resources will be displayed in the provider’s website, it won’t be possible to be viewed in the Europeana Collections portal.

More information about CORS and how to implement it can be found here.


HTTPS

Providers of IIIF resources are encouraged to deliver their resources over HTTPS so that they can be included in our web page without issue.


Embedding of media resources

In order for an item to be embedded in the Europeana Collections portal, there must be a valid oEmbed endpoint (see example from SketchFab) available where the media referred to in the item is displayed using a third party viewer or player. An exception is made for some data partners that do not support oEmbed. 

On the metadata side, a link to a webpage where the item can be displayed and which can be mappable to an oEmbed URL is provided within edm:isShownBy. In order to do this and because there is no information in the metadata that relates the webpage link to the oEmbed endpoint, the Europeana Collections portal has to apply an additional logic to convert the URL provided in edm:isShownBy into an oEmbed URL that can be used for embedding. For this, it uses an internal registry of oEmbed endpoints which consists of both a public list and manual additions made by the Collections development team (which also includes the Europeana oEmbed implementations to cover the exceptions). This means that whenever a new dataset is added that uses a different oEmbed endpoint it will need to be added to this registry.

Version history

  • v1.0 / Remy Gardien and Cécile Devarenne / 11/05/2016 /  Final version after review
  • v2.0 / Henning Scholz, Adina Ciocoiu, Valentine Charles, Hugo Manguinhas, Fiona Mowat, Masa Skrinjar,  Eleftheria Tsoupra / 17/12/2019 / Major update to reflect how Metis and Europeana Collections work with media. 
top