Curation API
Curation APIは、IIIF Presentation API 2.1のCollection (http://iiif.io/api/presentation/2.1/#collection)に類似した構造を取る。現時点ではIIIF Presentation API 2.1の独自拡張であり、@typeはcr:Curationとしている。以下、この構造をCurationと呼ぶ。
Collectionが物理的なオブジェクト（一冊の図書など）に対応したManifestを最小粒度としてグループ化したものとして想定されているのに対し、Curationは、Canvasに含まれる矩形領域を最小粒度として、Manifest横断的にグループ化可能なものとして想定している。
Curationの構造は以下のようになる。
-
Curation-
@context（必須） -
@type（必須） -
@id（必須） -
label（必須） -
selections（必須）-
Range-
canvases/members（どちらか必須） -
within（必須）
-
-
-
Curationでは、新たに導入したselectionsプロパティを用いて閲覧対象Canvasを指定する。selectionsは、Range (http://iiif.io/api/presentation/2.1/#range)の順序付きリスト（配列）である。Rangeでは、canvasesプロパティ等を用いてCanvasまたはCanvasの部分矩形領域を指定し、Canvasが属するManifestの情報はwithinプロパティを用いて記述する。
Canvasの部分矩形領域を指定する場合は、Canvasの@idに#xywh=(http://iiif.io/api/presentation/2.1/#segments)形式のフラグメントを付加する。
記述例
{
"@context": [
"http://iiif.io/api/presentation/2/context.json",
"http://codh.rois.ac.jp/iiif/curation/1/context.json"
],
"@type": "cr:Curation",
"@id": "http://codh.rois.ac.jp/iiif/iiif-curation-viewer/sample/curation.json",
"label": "Curated NIJL Data set",
"attribution": "Provided by CODH (ROIS) and NIJL NW Project.",
"related": {
"@id": "http://codh.rois.ac.jp/pmjt/book/",
"format": "text/html"
},
"selections": [
{
"@id": "http://codh.rois.ac.jp/pmjt/book/200014778/range/r1",
"@type": "sc:Range",
"label": "Curated contents from 『画本虫撰』",
"canvases": [
"http://codh.rois.ac.jp/pmjt/iiif/200014778/canvas/00000",
"http://codh.rois.ac.jp/pmjt/iiif/200014778/canvas/00011",
"http://codh.rois.ac.jp/pmjt/iiif/200014778/canvas/00023",
"http://codh.rois.ac.jp/pmjt/iiif/200014778/canvas/00023#xywh=3435,2487,840,750"
],
"within": "http://codh.rois.ac.jp/pmjt/book/200014778/manifest.json"
},
{
"@id": "http://codh.rois.ac.jp/pmjt/book/200003067/range/r1",
"@type": "sc:Range",
"label": "Curated contents from 『唐糸草紙』",
"members": [
{
"@id": "http://codh.rois.ac.jp/pmjt/iiif/200003067/canvas/00000",
"@type": "sc:Canvas",
"label": "p.1"
},
{
"@id": "http://codh.rois.ac.jp/pmjt/iiif/200003067/canvas/00008",
"@type": "sc:Canvas",
"label": "p.9"
},
{
"@id": "http://codh.rois.ac.jp/pmjt/iiif/200003067/canvas/00010",
"@type": "sc:Canvas",
"label": "p.11"
},
{
"@id": "http://codh.rois.ac.jp/pmjt/iiif/200003067/canvas/00010#xywh=2850,1000,730,680",
"@type": "sc:Canvas",
"label": "p.11"
}
],
"within": {
"@id": "http://codh.rois.ac.jp/pmjt/book/200003067/manifest.json",
"@type": "sc:Manifest",
"label": "唐糸草紙"
}
}
]
}
Timeline APIとCuration APIの組み合わせ
Curation APIをTimeline APIと組み合せて使えば、時系列画像からのキュレーションも可能となる。
Curationにおいて、Timelineに属するcs:Canvasを指定する場合には、selectionsプロパティのmembersを用いて対象を記述する。membersプロパティでのcs:Canvasの記述においては、cursorIndexプロパティの記載を必須とする。withinの@idにはTimelineの@idを記載し、@typeプロパティ値はtl:Manifestとする。
記述例
{
"@context": [
"http://iiif.io/api/presentation/2/context.json",
"http://codh.rois.ac.jp/iiif/curation/1/context.json"
],
"@type": "cr:Curation",
"@id": "http://codh.rois.ac.jp/iiif/iiif-curation-viewer/sample/himawari/curation.json",
"label": [
{
"@value": "ひまわり8号ギャラリー",
"@language": "ja"
},
{
"@value": "Himawari-8 Gallery",
"@language": "en"
}
],
"attribution": "NII \"Digital Typhoon\" / NICT \"Science Cloud\"",
"related": {
"@id": "http://agora.ex.nii.ac.jp/digital-typhoon/himawari-3g/gallery/",
"format": "text/html"
},
"selections": [
{
"@id": "http://agora.ex.nii.ac.jp/digital-typhoon/range/r1",
"@type": "sc:Range",
"label": "Curated contents from 『デジタル台風：ひまわり8号クリッピング』",
"members": [
{
"@id": "http://agora.ex.nii.ac.jp/digital-typhoon/iiif/2015/07/07/20150707020000",
"@type": "cs:Canvas",
"label": "2015-07-07T02:00:00Z",
"cursorIndex": 1436234400
},
{
"@id": "http://agora.ex.nii.ac.jp/digital-typhoon/iiif/2015/09/29/20150929025000",
"@type": "cs:Canvas",
"label": "2015-09-29T02:50:00Z",
"cursorIndex": 1443495000
},
{
"@id": "http://agora.ex.nii.ac.jp/digital-typhoon/iiif/2015/09/29/20150929025000#xywh=828,1840,1318,592",
"@type": "cs:Canvas",
"label": "2015-09-29T02:50:00Z",
"cursorIndex": 1443495000
},
{
"@id": "http://agora.ex.nii.ac.jp/digital-typhoon/iiif/2016/08/07/20160807032000",
"@type": "cs:Canvas",
"label": "2016-08-07T03:20:00Z",
"cursorIndex": 1470540000
},
{
"@id": "http://agora.ex.nii.ac.jp/digital-typhoon/iiif/2016/08/07/20160807032000#xywh=5072,1530,2126,1520",
"@type": "cs:Canvas",
"label": "2016-08-07T03:20:00Z",
"cursorIndex": 1470540000
},
{
"@id": "http://agora.ex.nii.ac.jp/digital-typhoon/iiif/2016/08/27/20160827033000",
"@type": "cs:Canvas",
"label": "2016-08-27T03:30:00Z",
"cursorIndex": 1472268600
},
{
"@id": "http://agora.ex.nii.ac.jp/digital-typhoon/iiif/2016/08/27/20160827033000#xywh=2784,1109,4176,3028",
"@type": "cs:Canvas",
"label": "2016-08-27T03:30:00Z",
"cursorIndex": 1472268600
}
],
"within": {
"@id": "http://codh.rois.ac.jp/iiif/iiif-curation-viewer/sample/himawari/timeline.json",
"@type": "tl:Manifest",
"label": "デジタル台風：ひまわり8号クリッピング"
}
}
]
}