画像共有の新しい標準IIIF

1. マニフェストであることを示す情報

JSONは汎用フォーマットなので、まずそのデータがIIIFの表現APIに従ったマニフェストであることを示さなければなりません。例1では、最初の3つのプロパティがこの役割を果たしています。全て必須プロパティです。

@typeプロパティは、マニフェストの内部に記述する大半のJSONオブジェクトで必須です。この値sc:Manifestの先頭にあるsc:という接頭辞は、後述のカンバスを共有するShared Canvasを意味しています（これはIIIFの前身に当たる規格の名称です。こうした背景については改めて取り上げます）。

2. 資料オブジェクト全体に関する情報

続けて、提供する資料オブジェクト全体に関する基本的な説明情報を記述します。labelは必須プロパティです。

descriptionの値とmetadataのvalueにはHTMLを使うことが認められているので、処理をする場合は注意が必要です。これら以外にHTMLが許されるのは次のattributionだけで、他のプロパティ値で使うことはできません。この他、thumbnailを加えておくと複数のマニフェストを表示できるビューアでの一覧表示などに利用できます。

さらに、資料オブジェクトを利用する上での権利やライセンスを記述します。

この他にも、ロゴ（logo）、関係情報リンク（related、seeAlsoほか）などが記述できます。日本のリソースをIIIFで提供する場合は、viewingDirectionを用いて、後述のシーケンスの表示送り方向（右から左に並べるなど）を示すことができます。

3. 資料オブジェクトを構成する部分についての情報

冊子のような資料オブジェクトは複数のページで構成され、その順序が重要です。個別のページなどの資料オブジェクト構成部品はカンバス（Canvas）によって表現され、マニフェストはそれを順番に並べたシーケンス（Sequence）を必ず持つことになっています。

プロパティ名が複数形であることから分かるように、sequencesの値はリスト（配列）と定義されています。

一般的には、資料オブジェクト内のカンバスの並びは1つに決まります。しかし、たとえば羊皮紙を閉じ合わせた写本のページ順序が研究によって別の順序が正しいと分かるなど、異なる並び順（従来の順序と正しい順序など）を提供したい場合もあり得ます。そのため、IIIFマニフェストは複数のシーケンスを持つことが可能となっているのです。

マニフェストのプロパティには、単一値と配列のいずれも認められるものもありますが、sequencesの値は常に配列です。したがってシーケンスが1つだけであっても、ここは配列を用いなければなりません。ただし、マニフェストファイルに埋め込む（直接記述する）シーケンスは最初の1つだけで、残りは別ファイルにしてURIで参照することになっています。

シーケンスの記述

sequencesの配列の要素となる各シーケンスは、次のプロパティを持ちます。

canvasesも、やはり複数形の名前が示すとおり、値は配列でなければなりません。

{
  "@context": "http://iiif.io/api/presentation/2/context.json", 
  "@id": "http://iiif.bodleian.ox.ac.uk/iiif/manifest/ba2b7e70-348b-4b76-96d7-36fede6c946c.json", 
  "@type": "sc:Manifest",
  ...
  "sequences": [
    {
      "@type": "sc:Sequence",
      "canvases": [
        {
          "@id": "http://iiif.bodleian.ox.ac.uk/iiif/canvas/cc7229b9-d949-4041-b43c-9190e7529976.json",
          ...
        },
        ...
      ]
    }
  ]
}

マニフェストがシーケンスを1つしか持たない場合はこれで十分ですが、複数シーケンスがあるときは、それぞれを区別できるようにlabelプロパティで名前を与えます（2番目以降のシーケンスは独立したファイルとなるので、マニフェストと同様に@contextと@idも必要となります）。

カンバスの記述

canvasesの値である配列の要素となるJSONオブジェクトが、個々のページなどを表すカンバスです。ビューアなどのツールは、異なる解像度の画像や関連資料などをこのカンバス上に“描く”ことによって利用者に表示します。

images以外はいずれも必須プロパティです（欠落しているページを示すため画像なしのカンバスを用意するといったケースもあることから、imagesは必須ではないのです）。ビューアはheightとwidthによってカンバスのアスペクト比を計算し、ここに複数の解像度の画像をリサイズして表示します。

imagesプロパティの値も常にリストです。その内容はあとで説明するとして、まず最小限のカンバスを例示してみましょう。

{
  "@id": "http://iiif.bodleian.ox.ac.uk/iiif/canvas/cc7229b9-d949-4041-b43c-9190e7529976.json",
  "@type": "sc:Canvas",
  "label": "Image 1",
  "height": 6051,
  "width": 5136,
  "images": [
    {
      "@type": "oa:Annotation",
      "motivation": "sc:painting",
      "resource": {
        "@id": "http://iiif.bodleian.ox.ac.uk/iiif/image/cc7229b9-d949-4041-b43c-9190e7529976/full/full/0/default.jpg",
        "@type": "dctypes:Image"
      },
      "on": "http://iiif.bodleian.ox.ac.uk/iiif/canvas/cc7229b9-d949-4041-b43c-9190e7529976.json"
    }
  ]
}

@idには必ずURIを記述します。これは並び順が異なる別シーケンスのファイルを用意するとき、同じカンバスを重複記述せず、URIで参照できるようにするためです。

なお仕様では、マニフェストを動的に生成することを想定してか、このURIからカンバスのJSONを取得できるようにするべき（SHOULD）としていますが、マニフェスト全体を静的JSONファイルにしているときは、これは現実的ではありません。その場合は、JSONを取得できそうな印象を与えないように、カンバスURIには.jsonなどの拡張子を付与しないほうがよいでしょう。

また、カンバスURIにはフラグメント識別子（#以降の部分ID）は使わないことになっています。これはカンバスの一部分を対象に関連情報を記述するときに不都合が生じないようにするためです。

カンバスの注釈

例3のimagesのリスト要素は、次のプロパティを持っています。

プロパティ名から想像されるのとは異なり、リストの要素は画像自身ではなく、注釈（oa:Annotation）です。これは「カンバスを注釈の対象とし、その注釈内容として画像やその他のリソースを記述する」というモデルを下敷きにしていることによります（接頭辞oa:はOpen Annotationを表します。このモデルについては改めて詳しく取り上げます）。

Open Annotationでは、注釈の種類をmotivationプロパティで表現します。ここでは“描く”（sc:painting）ことによってカンバスへの注釈を実現するというわけです（IIIFマニフェストでは必須）。また、このモデルでは注釈内容（画像）と注釈対象（この場合カンバス）の対を示す必要があるので、それぞれをresourceとonプロパティで示しています。したがって、onの値は常にカンバスの@idの値に一致します。

画像リソース

上述のように、注釈の内容（resourceの値）となるのが画像リソースです。

例3では、1枚の固定的な画像でカンバスを注釈しており、その画像のURIを@idで与えています。これで表示APIの記述としては正しいのですが、マニフェストを処理するアプリケーションの大半は、画像がIIIFの画像APIに従ったサービス（URIのパラーメタでタイル画像を要求できるサーバー）で提供されることを期待しています。こうしたサービスに対応する画像の場合は、画像リソースを次のように記述します。

{
  "@id":"http://iiif.bodleian.ox.ac.uk/iiif/image/cc7229b9-d949-4041-b43c-9190e7529976/full/full/0/default.jpg",
  "@type":"dctypes:Image",
  "service": {
    "@context": "http://iiif.io/api/image/2/context.json",
    "@id":"http://iiif.bodleian.ox.ac.uk/iiif/image/cc7229b9-d949-4041-b43c-9190e7529976",
    "profile":"http://iiif.io/api/image/2/profiles/level1.json"
  }
}

serviceプロパティの値が、IIIFサービスを記述するJSONオブジェクトです。

IIIFサービスは表現APIではなく画像APIで定義されているので、改めて@contextを記述します（マニフェスト要素に記述したものと似ていますが、/api/image/2...となっていることから、画像APIのコンテクストであることが分かります）。画像APIでは、@id値の基底URIに続けて領域、サイズ、回転といったパラメータを加えることで、タイル画像などを指定できます。

profileプロパティは、サービスが画像APIの機能をどこまでサポートしているかを示します。レベルは0、1、2の3段階で、0が最小限、2がフルサポートを意味します。このプロパティは必須ではないのですが、省略するとマニフェストを正しく処理できないビューアもあるようなので、加えておくべきでしょう。一方@typeは、このJSONオブジェクトでは不要です。

なおIIIFサービスを利用する場合は、画像リソース自身の@idは使われないのですが、IIIFサービスに対応しない（けれどもマニフェストは処理できる）ビューアでも画像を閲覧できるよう、単独の画像が取得できるURIを与えておくことが望まれます。