翻译者：syl
原文链接：https://iiif.io/api/cookbook/recipe/0005-image-service/

用例

你的藏品中有一件稀有或特殊的物品，你想把它提供给广大观众进行研究，包括那些没有能力亲自到你的机构去检查该物品的人。使用IIIF展示该物品的中等分辨率平面数字图像是可能的，但如果你已经实施了IIIF图像API服务，你就会大大增强研究和参与的互动可能性。在你的演示清单中指定一个IIIF图像API服务，除其他功能外，还可以对大型高分辨率图像进行适当的深度缩放，客户端生成的衍生物，对图像片段进行注释和外部参考，图像旋转，选择颜色，创建用于注释的图像片段，等等。反过来，这允许研究人员对物体进行更复杂的检查，并为稳定、持久和可发现的基于图像的学术研究提供更多可能性。

实施说明

这个属性可以附加到任何IIIF资源类型上，并且需要使用id和type属性。注释的结构遵循最简单的清单—图像专题。在图像body注解中，使用service属性指定IIIF图像API服务。该服务的id属性值是该IIIF图像API服务的基本URI。

type属性告诉用户你引用的是哪个版本的IIIF图像API（1，2，或3）。type的值在IIIF服务注册表中定义，包括与其他IIIF API兼容的值。更多信息请参见IIIF呈现规范中的服务属性。

图像服务属性应包括一个profile属性，其值代表服务对 IIIF 图像规范的遵从程度。你可以在图像 API 合规性规范中阅读更多关于服务合规性等级的信息。

作为一种优化，您可能希望将所有info.json内容（不包括@context）作为清单中服务部分的内容。这样做可使客户采取选定的行动，如选择适当的缩略图，而无需向服务发出单独请求。

限制条件

尽管版本3的Manifest可以使用版本2的@id和@type属性格式来指定一个服务，但这些只能在你指定一个本身是版本2的图像服务时使用。关于这个主题的更多信息，请参见[专题75][0075]。

例子

JSON-LD|在Universal Viewer中查看|在Mirador中查看

  1. {
  2.   "@context": "http://iiif.io/api/presentation/3/context.json",
  3.   "id": "https://iiif.io/api/cookbook/recipe/0005-image-service/manifest.json",
  4.   "type": "Manifest",
  5.   "label": {
  6.     "en": [
  7.       "Picture of Göttingen taken during the 2019 IIIF Conference"
  8.     ]
  9.   },
  10.   "items": [
  11.     {
  12.       "id": "https://iiif.io/api/cookbook/recipe/0005-image-service/canvas/p1",
  13.       "type": "Canvas",
  14.       "label": {
  15.         "en": [
  16.           "Canvas with a single IIIF image"
  17.         ]
  18.       },
  19.       "height": 3024,
  20.       "width": 4032,
  21.       "items": [
  22.         {
  23.           "id": "https://iiif.io/api/cookbook/recipe/0005-image-service/page/p1/1",
  24.           "type": "AnnotationPage",
  25.           "items": [
  26.             {
  27.               "id": "https://iiif.io/api/cookbook/recipe/0005-image-service/annotation/p0001-image",
  28.               "type": "Annotation",
  29.               "motivation": "painting",
  30.               "body": {
  31.                 "id": "https://iiif.io/api/image/3.0/example/reference/918ecd18c2592080851777620de9bcb5-gottingen/full/max/0/default.jpg",
  32.                 "type": "Image",
  33.                 "format": "image/jpeg",
  34.                 "height": 3024,
  35.                 "width": 4032,
  36.                 "service": [
  37.                   {
  38.                     "id": "https://iiif.io/api/image/3.0/example/reference/918ecd18c2592080851777620de9bcb5-gottingen",
  39.                     "profile": "level1",
  40.                     "type": "ImageService3"
  41.                   }
  42.                 ]
  43.               },
  44.               "target": "https://iiif.io/api/cookbook/recipe/0005-image-service/canvas/p1"
  45.             }
  46.           ]
  47.         }
  48.       ]
  49.     }
  50.   ]
  51. }

相关专题

  • 最简单的清单——图像演示了在没有IIIF图像API服务的情况下使用图片。
  • 添加图像缩略图讨论{如何处理缩略图}。
  • [在第2版服务上包含图像的第3版清单演示][00XX]是与将您的产品从第2版升级到第3版有关的专题的一部分。
  • [服务][0055]