Introducing the IIIF (International Image Interoperability Framework) APIs and some application cases to the Chinese academic libraries. 介绍国际图象互操作框架(IIIF) 的四个应用程序接口API协议和应用实例。

1. 国际图象互操作框架(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/UClcQIkLdYra7ZnOmMJnC5OA
1

2. IIIF是近年来发展最快的
一个国际团体，成果累累，
召开的国际会议越来越大。
2前年在美国第一次召开。
2
2017年欧美会议和
展示已举行5次。

3. 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

4. http://iiif.io/community/#participating-institutions
目前IIIF团体正式成员和其他参与机构
4

5. 5
文化遗产 －－ 近年来渐渐地被数字化，但数字化后的文
件仍难以被发现、再利用、引用、交换、比较 ...
为什么要有国际图象互操作框架
IIIF？

6. 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

7. 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. 对一个图像而言，除了要求某一部分的选取、放大和缩小，
还有其它使用要求
移动设备的普及，使得使用者习惯于使用放大功能，细看某一部分。
想想：如何随意选取、
引用、分享、比较某
一部分、角度、质量、
等等？
8

9. 多年来，大家都在采用不同的工具和系统，形成大大小小的独立王国。这些独
立王国不但耗费时间和金钱，而且功能和内容範围很受局限。
IIP Image
IIP Moo Viewer
digilib
FSI Viewer
FSI Server
Wellcome Player
Mirador
Internet Archive
Book Reader
Image
Servers
Image
Clients
Image
Apps
图像应用程序
图像客户端
图像服务器
9

10. 对一个物件而言，往往会有多个图像
移动设备的普及，使得使用者习惯于使用放大功能，细看某一部分。
…使用者还希望对相同和相关的图像进行比
较，不管来源于同一处还是多处
独立王国
贵、慢、功能简单、内容范围受局限；
难以交换、再利用、引用、比较
没有可认同的标准，我们只有独立王国
如果采用标准化的API(应用程序接口)，技术变得可以
互相交换，我们可以在使用层中对不同技术进行选择
10

11. 有了标准APIs(应用程序接口)后
Facilitate distributed access over standard APIs
内容变得可以分享 11

12. 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
12

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

14. 14
http://iiif.io/#try-itLet’s try it:
IIIF 的“图像API”能将这些要求通
过统一的句法来表现
根基
图像资源
｛根基｝／｛区域｝／｛大小｝／｛角度｝／｛质量｝.｛载体格式｝顺序：

15. 15
http://www.slideshare.net/simeonwarner/2015-01-cornellvrwgiiif
不仅仅是扫描的图像，3D物件的图像也可以这样表示

16. 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

17. http://puzzle.mikeapps.me/
借用这个puzzle
网站来看看后面
的URI
特别标出这一片段的URI
后面是每片图像的URI
看看图像的信息
17

18. 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. 19

20. 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

21. 2. IIIF的“呈现API”
（Presentation API）
基本结构
21
数字内容
单页
所有张页的顺序
整个物件
物件列单及
整套藏品

22. collections, manifests
Collection
Manifest
22
源于不同机构的特藏
某个物件

23. Canvas
23
Canvas Model
Canvas 的属性（元数据）有：
长、宽、类型、标签
单页

24. 数据模型: SharedCanvas
http://www.shared-canvas.org
24
古籍原件
数字化图像
学术注释
学术注释
机器可读文
字

25. 25
所有资源:
数字内容
相关关系
相关关系表
单页
张页的列单
列单套
所有张页的顺序
整个物件
物件列单及整
套藏品

26. 26
http://iiif.io/api/presentation/2.0/
对每种资源的元数据要求
必须具备
建议具备
可有可无
不允许有
26
内容标注
单页
张页顺序
物件
整套藏品

27. 27
http://iiif.io/api/presentation/2.0/
内容标注
单页
张页顺序
物件
整套藏品
（续） 对每种资源的元数据要求

28. Recommended URI Patterns
28
对每种资源的URI成分规范的要求
http://iiif.io/api/presentation/2.1/

29. 例：
Sequence
（顺序）
（JSON－LD格式）：
29
编码格式示范
对其URI成分规范的要求：
ID：http://….. /p1
类型：sc:单页
标签：第1页
ID：http://….. /p2
类型：sc:单页
标签：第2页
ID：http://….. /p3
类型：sc:单页
标签：第3页

30. 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

31. 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

32. 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 Model
W3C Recommendation 23 February 2017
动机
动机
画
非画
评论
描述
标签
链接
查寻内容
日期
用户
http://example.org/services/
manifest/search?q=bird&
motivation=painting

33. IIIF应用
IIIF 不是一套新的系统，而是一套标准；
可在不同层次使用。
• Image Apps
• Image Clients
• Image Servers
• http://iiif.io/apps-demos/
图像应用程序， e.g.，Mirador
图像客户端 e.g., OpenLayers
图像服务器， e.g.，ContentDM
33

34. IIP Image
IIP Moo Viewer
digilib
FSI Viewer
FSI Server
Wellcome Player
Mirador
Internet Archive
Book Reader
Image
Servers
Image
Clients
Image
Apps
图像应用程序
图像客户端
图像服务器
34
IIIF 不是一套新的系统，而是一套标准；可在不同层次使用。
已经有许多图像工具和系统支持IIIF

35. a.用于对多个图像的比较
（分享资源，但不需要下载）
标注工具
描述工具
地理参考工具
图像解析工具
地图1
（由单位A提供）
地图2
（由单位B提供）
地图3
（由单位C提供）
地图4
（由单位D提供）
IIIF应用
35

36. Partial Reconstruction of 1
Mirador viewer showing images from 16
institutions, each serving their own images
Mirado 显示器上展现由16个单位［不同］服
务器提供的某手抄本的图像
36

37. 可比较的、经过加注标引的、搜集到的图片自动显示在读者可用的平台上
IIIF in support of Research. May 26, 2016
https://www.slideshare.net/IIIF_io/iiif-in-support-of-research
37

38. 對缺漏張頁
也可以專門
定位
38

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

40. http://projectmirador.org/demo/#aba693db-
5073-4bcc-a855-9925fa3168d4
https://github.com/IIIF/mirador
40

41. 41

42. 42

43. 汇集，比较
IIIF in support of Research. May 26, 2016
https://www.slideshare.net/IIIF_io/iiif-in-support-of-research
43

44. IIIF in support of Research. May 26, 2016
https://www.slideshare.net/IIIF_io/iiif-in-support-of-research
加注，分享
44

45. 放大比较－可以细化到每个字母
Zoom to compare features from images provided by different
institutions – to the detail of the letter
45

46. Princeton University Library
Loris 图像服务器
http://showcase.iiif.io/showcase/loris-server.html
不仅支持JPEG2000, jpg, 也支持TIFF本图。
46
放大

47. http://showcase.iiif.io/showcase/ycba.html
Yale University
Yale Center for
British Art
放大
47

48. 分形（英语：Fractal），又称碎形
http://showcase.iiif.io/showcase/fractals.html
可达到十亿pixels（像素）宽和十亿pixels高
48

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

50. b. 按需所求， 构造可互动的呈现界面，同时展示多种结果
mix overview images, descriptions, page views, detail views etc.
etc.
presentations
这种分享的canvas也可用于对不同博物馆的艺术作品、信件、展览、散文、相关作品、书目等的展示。
全貌 描述 单页 细看放大
50

51. 51

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

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

55. 1.1 百万 IIIF
图片
看到图片的
同时也看到
文字。
The National Library of Wales 威尔士国家图书馆在线报纸
56

56. hdl.handle.net/10107/46420
22
The Welsh Book of
Remembrance 1928
威尔士年鉴1928
Search:
“Port Dinorwic”
19 results found. =>
57
威尔士国家图书馆

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

58. 加注、修正
59

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

60. Turn scans into maps
http://showcase.iiif.io/showcase/georeferencer.html
将数字化扫描的文件变为地图
61
大英图书馆

61. http://showcase.iiif.io/showcase/georeferencer.html
Turn scans into maps
62
将数字化扫描的文件变为地图 大英图书馆

62. http://showcase.iiif.io/showcase/georeferencer.html
精确分析
63
将数字化扫描的文件变为地图 大英图书馆

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

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

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，图像，关
联数据
• 软件：采用技术的软件
• 社团：采用和开发软件
的社团
结语

66. http://iiif.io/
谢谢大家!
67
希望中国有单位加入 IIIF；
希望你们单位成为首个来自中国的IIIF成员
国际图象互操作框架