IIIF Presentation API v2のIIIFコレクションで、ページネーションを使う

概要

IIIF Presentation API v2のIIIFコレクションで、ページネーションを使う機会がありましたので、備忘録です。

IIIFコレクションでは、以下のように、複数のマニフェストファイル（およびコレクション）の一覧を提供することができます。

この時、対象とするマニフェストファイルが多数になった場合、一つのIIIFコレクションでは配信が難しくなりました。

これに対して、以下でページネーションに関する仕様がありましたので、こちらを使ってみます。

上記のページでは、以下のような例が紹介されていました。

まず、一つの目のJSONでコレクション全体のマニフェストファイル数totalを示し、さらにはじめの部分マニフェストファイル群へのリンクをfirstで提示します。

firstで指定されたコレクションが2つ目のJSONであり、startIndexとnextを使って、現在の位置と次の部分マニフェストファイル群へのリンクを示すようでした。

上記のようなページネーションについて、DrupalとElasticsearchの組み合わせによる実装例を紹介します。以下の記事で紹介したように、drupal/elasticsearch_connectorを使って、DrupalとElasticsearchを接続していることを前提とします。

Elasticsearchでは、fromを使ってオフセットを指定することができますが、max_result_window（デフォルトでは、10,000件）を超える場合、正しく機能しません。

そこでsearch_afterを使って、特定のコンテンツに続くコンテンツを取得することができます。

例えば、特定のソート条件下で、20,000件目のコンテンツのID（field_id）を取得し、以下のようなクエリにより、20,001件目以降のコンテンツを取得できます。searchAfterに20,000件目のコンテンツのIDが入っています。

ただし、Elasticsearch単独で特定のソート条件下において、デフォルトのmax_result_windowを使う場合、例えば20,000件目のコンテンツのID（field_id）を取得するには工夫が必要になります。

そこで、特定のソート条件下におけるxxx件目のコンテンツの取得、を行う部分については、DrupalのREST APIを使用しました。DrupalのViewsを使い、オフセットでユーザが指定指定できるようにした上で、1件のコンテンツを返却できるようにしました。

例：/api/xxx?offset=20000

これにより、search_afterに必要なコンテンツのIDを取得することができ、上述したElasticsearchへのクエリと組み合わせることで、ページネーションを含むIIIFコレクションを構築することができました。

上記で実装したIIIFコレクションをPresentation API Validatorにかけてみました。

結果、上述したような、1つ目のコレクション全体を示すJSONでは、以下の警告が表示されました。

また、2つ目のコレクションの一部の示すJSONでは、以下の警告が表示されました。

さらに、1つ目のコレクション全体を示すJSONについては、Universal ViewerやMiradorでもうまく表示させることができませんでした。

今回紹介した実装に問題があるのか等、引き続き調査してみたいと思います。

IIIFコレクションを使って、多数のマニフェストファイル（またはサブコレクション）を提示する際に、本記事が参考になりましたら幸いです。