This is a website containing information on how to use Europeana Cloud Image Service and how to deliver data to the Image Service.

What is Europeana Cloud Image Service?

Europena Cloud Image Serivce provides access to images stored in Europeana Cloud. It is a compatible with International Image Interoperability Framework which provides a standardised method of describing and delivering images over the web. It supports images in JPEG2000 format. 

The service consists of:

  •  IIIF compatible server, so it can be used with any IIIF viewer located on clients sites
  • embeded JavaScript viewer which can be linked to from the web
  • image conversion service helps to create IIIF compatible images

What images can be accessed via Image Service

  • At this moment Image Service supports images in JPEG2000 format. 
  • they have to be stored in Europeana Cloud
  • *preferably* they have to be converted from TIFF format using Image Conversion Service
  • they have to be public

What format of images are supported. 

Right now only TIFF to JPEG 2000 conversion is possible. This is why the instructions below will take it as example. Europeana Cloud team is currently working on providing JPEG -> JPEG2000 converter.

How to use EC Image Service?

Store your TIFF images in Europeana Cloud

Even though it is possible right now, it is highly recommended not to deliver JPEG 2000 images to Europeana Cloud but, to create a file in this format using Image Conversion Service. In this way we can be sure that the created file is fully compatible with the Image Service. It is highly probable that the ability to deliver bare JPEG2000 images to be later used in Image Service will be disabled in the future.

To store your TIFF images in Europeana cloud - simply use Europeana Cloud API to send files to Metadata and Content Service. Please check developer's tutorial to get to know the API.

Transform the images to JPEG2000 using Europeana Cloud's Data Processing Service

Use Data Processing Service API to convert your TIFF images to JPEG2000. Check out how in the tutorial.

Retrieve images using IIIF server

The base url for Europeana Cloud IIIF server is: http://iiif.europeana.eu

Accessing images using regular URLs

Let's assume that you know your image URL e.g.

https://cloud.europeana.eu/api/records/NXM6XJWLW5AC4ZPPIAZFQ6UDWAXLXCGFWUTMDXPPPW7RMDKVIMNA/representations/presentation_images/versions/d3139491-fcc9-11e5-bc8a-fa163e60dd72/files/node-2/image/SBB/Berliner_Tageblatt/1903/10/05/0/F_SBB_00001_19031005_032_505_0_008.jp2

If you would visit the link above you would download a JP2000 file. If you want to view the image using IIIF viewer (embeded Europeana Cloud viewer) please:


In case of our example the link would be: http://iiif.europeana.eu/records/NXM6XJWLW5AC4ZPPIAZFQ6UDWAXLXCGFWUTMDXPPPW7RMDKVIMNA/representations/presentation_images/versions/d3139491-fcc9-11e5-bc8a-fa163e60dd72/files/node-2/image/SBB/Berliner_Tageblatt/1903/10/05/0/F_SBB_00001_19031005_032_505_0_008/

Accessing images using friendly URLs

If you are using so called "friendly URLs" to access ECloud resources (check for reference TODO put link to docs of Friendly URLs here)

Let's assume this is the URL to your image in ECloud:

https://cloud.europeana.eu/api/data-providers/TheEuropeanLibrary/records/3000097619352/representations/presentation_images/node-2/image/SBB/Berliner_Tageblatt/1903/10/05/0/F_SBB_00001_19031005_032_505_0_008.jp2

Create the URL to IIIF server in the same way as previously:

In case of our example the link would be: http://iiif.europeana.eu/data-providers/TheEuropeanLibrary/records/3000097619352/representations/presentation_images/node-2/image/SBB/Berliner_Tageblatt/1903/10/05/0/F_SBB_00001_19031005_032_505_0_008

Accessing IIIF info files

Image metadata and a list of server capabilities is available through an info.json request, which provides information on the image and the functionality provided by the image server. In order to retrieve the information file for an image simply add /info.json suffix to the end of the URL e.g. 

http://iiif.europeana.eu/records/NXM6XJWLW5AC4ZPPIAZFQ6UDWAXLXCGFWUTMDXPPPW7RMDKVIMNA/representations/presentation_images/versions/d3139491-fcc9-11e5-bc8a-fa163e60dd72/files/node-2/image/SBB/Berliner_Tageblatt/1903/10/05/0/F_SBB_00001_19031005_032_505_0_008/info.json

and respectively 

http://iiif.europeana.eu/data-providers/TheEuropeanLibrary/records/3000097619352/representations/presentation_images/node-2/image/SBB/Berliner_Tageblatt/1903/10/05/0/F_SBB_00001_19031005_032_505_0_008/info.json

for friendly URLs.

 

 

 

 

  • No labels