国际图象互操作框架(IIIF)

APIs和应用实例

nternational mage nteroperability

ramework （IIIF）曾蕾（Marcia Lei Zeng）

第十四届数字图书馆前沿问题高级研讨班(ADLS)2017-12-03, 福州

http://iiif.io/

Based on: • Sanderson, Rob (2015) “Introduction to the Presentation API” http://www.slideshare.net/azaroth42/iiif-presentation-api;

“Introduction to IIIF” http://www.slideshare.net/azaroth42/introduction-to-iiif ; • Warner, Simeon (2015) “IIIF Introduction and Opportunities at Cornell” http://www.slideshare.net/simeonwarner/2015-01-

cornellvrwgiiif ;• Robson, Glen (2017) “Introduction to Annotation, Content Search, and IIIF Authentication from the IIIF Conference - The

Vatican” https://www.slideshare.net/GlenRobson/introduction-to-annotation-content-search-and-iiif-authentication-from-the-iiif-conference-the-vatican

• Cramer, Tom (2017) “03 Introduction to IIIF” https://www.youtube.com/watch?v=EE1YskDrzPs

• IIIF Website specifications & showcases http://iiif.io/ and https://www.youtube.com/channel/UClcQIkLdYra7ZnOmMJnC5OA1

IIIF是近年来发展最快的一个国际团体，成果累累，召开的国际会议越来越大。

2前年在美国第一次召开。

2

2017年欧美会议和展示已举行5次。

IIIF Community 发起者和早期成员

National Libraries

• British Library

• France

• Denmark

• Israel

• New Zealand

• Norway

• Poland

• Serbia

• Wales

Research Institutions

•C2RMF (France)

•Cornell University

•Johns Hopkins Univ.

•Harvard University

•Oxford University

•Princeton University

•Stanford University

•Wellcome Library

•Yale University

Projects

• Biblissima

• e-codices

• TPEN

• TextGrid

Aggregators

• Artstor

• DPLA

• Europeana

Museums

• YCBA

• British Museum

3

http://iiif.io/community/#participating-institutions

目前IIIF团体正式成员和其他参与机构

4

5

文化遗产 －－ 近年来渐渐地被数字化，但数字化后的文件仍难以被发现、再利用、引用、交换、比较 ...

为什么要有国际图象互操作框架IIIF？

John Constable (1776-1837)Stonehenge – Making a

Masterpiece

Sketch (1820): V&A Watercolour Sketch: BM

Watercolour (1835)Victoria and Albert Museum

Watercolour Sketch: V&A

+ Letters

+ Exhibitions

+ Essays

+ Related Works

+ Bibliography

在学习研究一个艺术作品时，怎样将相关物件放到一个界面上来？

Constable’s “Stonehenge”

6

1895. Pastel on board. (own by Petter Olsen)

1895. Lithograph. (own by private)

1893. Oil , tempera, and pastel on cardboard(National Gallery, Oslo, Norway, 1994-02 was stolen and recovered 1994-05.)

The Scream 吶喊- Edvard Munch 孟克 between 1893 and 1910

特别是，怎样将分散在不同地方的相关物件放到一起比较？

1893: pastel on cardboard.

1910: tempera on cardboard, was stolen from the Munch Museum in 2004-08, recovered in 2006-08.

7

对一个图像而言，除了要求某一部分的选取、放大和缩小，还有其它使用要求

移动设备的普及，使得使用者习惯于使用放大功能，细看某一部分。

想想：如何随意选取、引用、分享、比较某一部分、角度、质量、等等？

8

多年来，大家都在采用不同的工具和系统，形成大大小小的独立王国。这些独立王国不但耗费时间和金钱，而且功能和内容範围很受局限。

IIP Image

IIP Moo Viewer

digilib

FSI Viewer

FSI Server

Wellcome PlayerMirador

Internet Archive Book Reader

Image

Servers

Image

Clients

Image

Apps

图像应用程序

图像客户端

图像服务器

9

对一个物件而言，往往会有多个图像

移动设备的普及，使得使用者习惯于使用放大功能，细看某一部分。

…使用者还希望对相同和相关的图像进行比较，不管来源于同一处还是多处

独立王国贵、慢、功能简单、内容范围受局限；难以交换、再利用、引用、比较

没有可认同的标准，我们只有独立王国

如果采用标准化的API(应用程序接口)，技术变得可以互相交换，我们可以在使用层中对不同技术进行选择

10

有了标准APIs(应用程序接口)后Facilitate distributed access over standard APIs

内容变得可以分享11

IIIF的四个应用程序接口API协议

Get images via a

simple, RESTful,

web service.

Support for tiles

needed for pan-zoom

viewers.

Just enough metadata to drive a remote viewing experience.

(e.g. sequence, labels, attribution, license)

1.

Image API2.

Presentation API

API= application programming interface, a set of routines, protocols, and tools for building software applications.

http://iiif.io/technical-details.html

3. Authentication

API

Searching annotation

content, not

metadata.

4. Content Search API

A set of workflows for guiding the user through an existingaccess control system.

图像API 呈现API 身份验证 API 内容搜索 API

12

13

Image request你要的是图像的• 哪一部分？• 多大？• 什么角度？• 什么质量？• 什么格式？

图像API

14http://iiif.io/#try-itLet’s try it:

IIIF 的“图像API”能将这些要求通过统一的句法来表现

根基

图像资源

｛根基｝／｛区域｝／｛大小｝／｛角度｝／｛质量｝.｛载体格式｝顺序：

15http://www.slideshare.net/simeonwarner/2015-01-cornellvrwgiiif

不仅仅是扫描的图像，3D物件的图像也可以这样表示

URL句法要求1. 图像本身索取 URI ：

{scheme}://{server}/{prefix}/{identifier}/{region}/{size}/{rotation}/{quality}.{format}

http://www.example.org/image-service/abcd1234/full/full/0/default.jpg

region=125,15,120,140

size=90, rotation=!345 quality=gray

.../125,15,120,140/90,/!345/gray.jpg

http://iiif.io/api/image/2.0/16

http://puzzle.mikeapps.me/

借用这个puzzle网站来看看后面的URI

特别标出这一片段的URI

后面是每片图像的URI

看看图像的信息

17

18

｛根基｝／｛区域｝／｛大小｝／｛角度｝／｛质量｝.｛载体格式｝

https://iiif.archivelab.org/iiif/mma_irises_436528/1524,2444,762,611/200,/0/default.jpg

{scheme}://{server}/{prefix}/{identifier}/{region}/{size}/{rotation}/{quality}.{format}

19

URL句法要求1. 图像本身索取 URI ：

{scheme}://{server}/{prefix}/{identifier}/{region}/{size}/{rotation}/{quality}.{format}

例：http://www.example.org/image-service/abcd1234/full/full/0/default.jpg

2. 有关图像的信息的索取 URI

{scheme}://{server}{/prefix}/{identifier}/info.json

例：http://www.example.org/image-service/abcd1234/info.json

http://iiif.io/api/image/2.0/

20

图像API

2. IIIF的“呈现API”

（Presentation API）基本结构

21

数字内容

单页

所有张页的顺序

整个物件

物件列单及整套藏品

collections, manifests

Collection

Manifest

22

源于不同机构的特藏

某个物件

Canvas

23

Canvas Model

Canvas 的属性（元数据）有：长、宽、类型、标签

单页

数据模型: SharedCanvas

http://www.shared-canvas.org24

古籍原件

数字化图像

学术注释

学术注释

机器可读文字

25

所有资源:

数字内容

相关关系

相关关系表

单页

张页的列单

列单套

所有张页的顺序

整个物件

物件列单及整套藏品

26

http://iiif.io/api/presentation/2.0/

对每种资源的元数据要求

必须具备

建议具备

可有可无

不允许有

26

内容标注

单页

张页顺序

物件

整套藏品

27

http://iiif.io/api/presentation/2.0/

内容标注

单页

张页顺序

物件

整套藏品

（续）对每种资源的元数据要求

Recommended URI Patterns

28

对每种资源的URI成分规范的要求

http://iiif.io/api/presentation/2.1/

例：

Sequence（顺序）

（JSON－LD格式）：

29

编码格式示范

对其URI成分规范的要求：

ID：http://….. /p1类型：sc:单页标签：第1页

ID：http://….. /p2类型：sc:单页标签：第2页

ID：http://….. /p3类型：sc:单页标签：第3页

IIIF的四个API

Get images via a

simple, RESTful,

web service.

Support for tiles

needed for pan-zoom

viewers.

Just enough metadata to drive a remote viewing experience.

(e.g. sequence, labels, attribution, license)

1.

Image API

2.

Presentation API

API= application programming interface, a set of routines, protocols, and tools for building software applications.

http://iiif.io/technical-details.html

3. Authentication API

Searching annotation

content, not metadata.

4. Content Search API

A set of workflows for guiding the user through an existing access control system.

图像API 呈现API 身份验证 API 内容搜索 API

30

2. 认证服务• 2.1. 访问 Cookie 服务

– 2.1.1. 服务描述– 2.1.2. 与访问 Cookie 服务的交互– 2.1.3. 登录交互模式– 2.1.4 点击互动模式– 2.1.5 亭 Kiosk 互动模式– 2.1.6. 外部交互模式

• 2.2. 访问令牌Token服务– 2.2.1. 服务描述– 2.2.2. JSON 访问令牌响应– 2.2.3. 非浏览器客户端应用程序的交互– 2.2.4. 基于浏览器的客户端应用程序的交互– 2.2.5. 使用访问令牌– 2.2.6. 访问令牌错误情况

• 2.3. 注销服务– 2.3.1. 服务描述– 2.3.2 互动

• 2.4. 具有身份验证服务的示例说明

1. 导言• 1.1. 术语• 1.2. 内容资源的身份验证• 1.3. 描述资源的身份验证• 1.4. 安全

3. 与访问控制资源的互动• 3.1. 全部或无访问权限• 3.2. 分层访问4. 从浏览器客户端角度看工作流程附件

3. IIIF Authentication API

身份验证 API

31

1. 导言

• 1.1. 使用案例

• 1.2. 术语

2. 概览

4. 自动完成

• 4.1. 服务描述

• 4.2. 请求

• 4.2.1. 查询参数

• 4.2.2. 示例请求

• 4.3. 答复

5. property定义附录

• a. 请求参数要求

3. 搜索

• 3.1. 服务描述

• 3.2. 请求

– 3.2.1. 查询参数

– 3.2.2. 请求示例

• 3.3. 呈现 API 兼容的响应

– 3.3.1. 简单列表

– 3.3.2. 分页结果

– 3.3.3. 目标资源的结构

• 3.4 搜索 API 的特定响应

– 3.4.1. 忽略的参数

– 3.4.2. 搜索字词片段

– 3.4.3. 搜索字词的突出显示

– 3.4.4. 多条注解的命中

4. IIIF Search API

内容搜索 API

32

单件／查寻？内容=鸟&动机=画画

相关标准： Web Annotation Data ModelW3C Recommendation 23 February 2017

动机

动机画非画评论描述标签链接

查寻内容

日期

用户

http://example.org/services/manifest/search?q=bird&motivation=painting

IIIF应用

IIIF 不是一套新的系统，而是一套标准；

可在不同层次使用。

• Image Apps

• Image Clients

• Image Servers

• http://iiif.io/apps-demos/

图像应用程序， e.g.，Mirador

图像客户端 e.g., OpenLayers

图像服务器， e.g.，ContentDM

33

IIP Image

IIP Moo Viewer

digilib

FSI Viewer

FSI Server

Wellcome PlayerMirador

Internet Archive Book Reader

Image

Servers

Image

Clients

Image

Apps

图像应用程序

图像客户端

图像服务器

34

IIIF 不是一套新的系统，而是一套标准；可在不同层次使用。已经有许多图像工具和系统支持IIIF

a.用于对多个图像的比较（分享资源，但不需要下载）

标注工具

描述工具

地理参考工具

图像解析工具

地图1（由单位A提供）

地图2（由单位B提供）

地图3（由单位C提供）

地图4（由单位D提供）

IIIF应用

35

Partial Reconstruction of 1

Mirador viewer showing images from 16 institutions, each serving their own images

Mirado 显示器上展现由16个单位［不同］服务器提供的某手抄本的图像

36

可比较的、经过加注标引的、搜集到的图片自动显示在读者可用的平台上

IIIF in support of Research. May 26, 2016https://www.slideshare.net/IIIF_io/iiif-in-support-of-research

37

對缺漏張頁也可以專門

定位

38

http://projectmirador.org/demo/#aba693db-5073-4bcc-a855-9925fa3168d4

39

http://projectmirador.org/demo/#aba693db-5073-4bcc-a855-9925fa3168d4

https://github.com/IIIF/mirador

40

41

42

汇集，比较

IIIF in support of Research. May 26, 2016https://www.slideshare.net/IIIF_io/iiif-in-support-of-research

43

IIIF in support of Research. May 26, 2016https://www.slideshare.net/IIIF_io/iiif-in-support-of-research

加注，分享

44

放大比较－可以细化到每个字母Zoom to compare features from images provided by different

institutions – to the detail of the letter

45

Princeton University LibraryLoris 图像服务器

http://showcase.iiif.io/showcase/loris-server.html

不仅支持JPEG2000, jpg, 也支持TIFF本图。

46

放大

http://showcase.iiif.io/showcase/ycba.html

Yale University

Yale Center for British Art

放大

47

分形（英语：Fractal），又称碎形

http://showcase.iiif.io/showcase/fractals.html

可达到十亿pixels（像素）宽和十亿pixels高

48

可达到十亿pixels（像素）宽和十亿pixels高 49

b. 按需所求，构造可互动的呈现界面，同时展示多种结果mix overview images, descriptions, page views, detail views etc.

etc.

presentations

这种分享的canvas也可用于对不同博物馆的艺术作品、信件、展览、散文、相关作品、书目等的展示。

全貌 描述 单页 细看放大

50

51

http://collections.britishart.yale.edu/vufind/Record/1667701

c. 用于将图中各部分的内容转成机器可读文字

55

1.1 百万 IIIF图片

看到图片的同时也看到文字。

The National Library of Wales 威尔士国家图书馆在线报纸

56

hdl.handle.net/10107/4642022The Welsh Book of Remembrance 1928威尔士年鉴1928

Search:“Port Dinorwic”

19 results found. =>

57

威尔士国家图书馆

d. 用于合作性的加注、修正、语义抽取

58

加注、修正

59

http://showcase.iiif.io/showcase/klokantech-iiifviewer.html

60

Turn scans into maps

http://showcase.iiif.io/showcase/georeferencer.html

将数字化扫描的文件变为地图

61

大英图书馆

http://showcase.iiif.io/showcase/georeferencer.html

Turn scans into maps

62

将数字化扫描的文件变为地图 大英图书馆

http://showcase.iiif.io/showcase/georeferencer.html

精确分析

63

将数字化扫描的文件变为地图 大英图书馆

成功案例数不胜数。请查看最近的演示会议中分享结果的录像: https://www.youtube.com/channel/UClcQIkLdYra7ZnOmMJnC5OA/videos

64

Europeana 支持符合IIIF的查寻sv_dcterms_conformsTo:*iiif*

65

IIIF益处1.丰富多彩的图像递送2.可以用在原有系统上，不管是服务器还是客户端、插件等

3.出版一次，复用多次4.将众人提供的资源重新组合5. 标注可由使用者进行6.全球性的支持和内容网络7.支持获取途径控制、归因8.促使有出处来源和受控的分享

From “Benefits”. By Robert Sanderson “Introduction to IIIF” Visual Resources Association's 33rd Annual Conference, workshop on IIIF, Denver, CO. March 12-14, 2015. http://www.slideshare.net/azaroth42/introduction-to-iiif p.27

http://iiif.io/

66

何谓IIIF？

• 技术：API，图像，关联数据

• 软件：采用技术的软件

• 社团：采用和开发软件的社团

结语

http://iiif.io/

谢谢大家!67

希望中国有单位加入 IIIF；希望你们单位成为首个来自中国的IIIF成员

国际图象互操作框架