按时序导航

翻译者：ginkgo

原文链接：https://iiif.io/api/cookbook/recipe/0230-navdate/

译文：
专题首页| 专题列表

用例

您有一个或多个具有日期属性的 IIIF 资源，并且希望将它们的日期发送到客户端以置于基于日期的界面。例如，您可能希望借助时间线或日历显示 IIIF 对象。对于一组分散的资源，统一使用navDate允许将收藏（collection）作为数据和按时序排列的计算寻址。

实现说明

navDate属性，正如其名称所暗示的那样，允许一个清单（manifest）识别与某一 IIIF 资源关联的日期，以帮助查看器为用户提供基于日期的导航。客户端不必（not required）使用navDate，具有基于日期的导航的客户端也不必（may not）默认使用该导航界面。

此属性仅供计算机代理使用。metadata属性条目中应该（should）包含更多描述性的日期范围，旨在直接向人类显示。

该navDate属性的值必须（must）是带有时区的XSD dateTime 字面量。时区应该（should）采用 UTC +“Z”格式，也可以（may）采用与此不同的“+hh:mm”格式 。如果一个使用navDate属性的画布（Canvas）还包含一个duration属性，那么该画布的navDate属性应取值为资源内容开始的日期和时间。使用“01”表示未知或不准确的月份或日期，使用“00”表示任何未知或不准确的时间部分。

只允许收藏（Collections）、清单（Manifests）、范围（Ranges）和画布（Canvas）包含navDate属性，并且该属性在每个资源中只能出现一次。符合标准的客户端应忽略其他资源上的navDate属性。

限制

无

示例

本专题展示了一个虚构的收藏（Collection），其中包含来自美国国会图书馆保存的特定国家公园地图的 2 个实例。如果您想在本地扩展此示例，您可以在美国国会图书馆网站上找到本系列中的其他地图。

收藏

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

{
  "@context": "http://iiif.io/api/presentation/3/context.json",
  "id": "https://iiif.io/api/cookbook/recipe/0230-navdate/navdate-collection.json",
  "type": "Collection",
  "label": {
    "en": [
      "Chesapeake and Ohio Canal map and guide pamphlets"
    ]
  },
  "thumbnail": [
    {
      "id": "https://iiif.io/api/image/3.0/example/reference/43153e2ec7531f14dd1c9b2fc401678a-88695674/full/max/0/default.jpg",
      "type": "Image",
      "format": "image/jpeg",
      "height": 300,
      "width": 221,
      "service": [
        {
          "id": "https://iiif.io/api/image/3.0/example/reference/43153e2ec7531f14dd1c9b2fc401678a-88695674",
          "profile": "level1",
          "type": "ImageService3"
        }
      ]
    }
  ],
  "items": [
    {
      "id": "https://iiif.io/api/cookbook/recipe/0230-navdate/navdate_map_2-manifest.json",
      "type": "Manifest",
      "label": {
        "en": [
          "1986 Chesapeake and Ohio Canal, Washington, D.C., Maryland, West Virginia, official map and guide"
        ]
      },
      "navDate": "1986-01-01T00:00:00+00:00"
    },
    {
      "id": "https://iiif.io/api/cookbook/recipe/0230-navdate/navdate_map_1-manifest.json",
      "type": "Manifest",
      "label": {
        "en": [
          "1987 Chesapeake and Ohio Canal, Washington, D.C., Maryland, West Virginia, official map and guide"
        ]
      },
      "navDate": "1987-01-01T00:00:00+00:00"
    }
  ]
}

1986年地图

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

{
  "@context": "http://iiif.io/api/presentation/3/context.json",
  "id": "https://iiif.io/api/cookbook/recipe/0230-navdate/navdate_map_2-manifest.json",
  "type": "Manifest",
  "label": {
    "en": [
      "1986 Chesapeake and Ohio Canal, Washington, D.C., Maryland, West Virginia, official map and guide"
    ]
  },
  "navDate": "1986-01-01T00:00:00+00:00",
  "items": [
    {
      "id": "https://iiif.io/api/cookbook/recipe/0230-navdate/canvas/p1",
      "type": "Canvas",
      "label": {
        "en": [
          "1986 Map, recto and verso, with a date of publication"
        ]
      },
      "height": 1765,
      "width": 1286,
      "items": [
        {
          "id": "https://iiif.io/api/cookbook/recipe/0230-navdate/page/p1/1",
          "type": "AnnotationPage",
          "items": [
            {
              "id": "https://iiif.io/api/cookbook/recipe/0230-navdate/annotation/p0001-image",
              "type": "Annotation",
              "motivation": "painting",
              "body": {
                "id": "https://iiif.io/api/image/3.0/example/reference/43153e2ec7531f14dd1c9b2fc401678a-87691274-1986/full/max/0/default.jpg",
                "type": "Image",
                "format": "image/jpeg",
                "height": 1765,
                "width": 1286,
                "service": [
                  {
                    "id": "https://iiif.io/api/image/3.0/example/reference/43153e2ec7531f14dd1c9b2fc401678a-87691274-1986/",
                    "profile": "level1",
                    "type": "ImageService3"
                  }
                ]
              },
              "target": "https://iiif.io/api/cookbook/recipe/0230-navdate/canvas/p1"
            }
          ]
        }
      ]
    }
  ]
}

1987年地图

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

{
  "@context": "http://iiif.io/api/presentation/3/context.json",
  "id": "https://iiif.io/api/cookbook/recipe/0230-navdate/navdate_map_1-manifest.json",
  "type": "Manifest",
  "label": {
    "en": [
      "1987 Chesapeake and Ohio Canal, Washington, D.C., Maryland, West Virginia, official map and guide"
    ]
  },
  "navDate": "1987-01-01T00:00:00+00:00",
  "items": [
    {
      "id": "https://iiif.io/api/cookbook/recipe/0230-navdate/canvas/p1",
      "type": "Canvas",
      "label": {
        "en": [
          "1987 Map, recto and verso, with a date of publication"
        ]
      },
      "height": 7072,
      "width": 5212,
      "items": [
        {
          "id": "https://iiif.io/api/cookbook/recipe/0230-navdate/page/p1/1",
          "type": "AnnotationPage",
          "items": [
            {
              "id": "https://iiif.io/api/cookbook/recipe/0230-navdate/annotation/p0001-image",
              "type": "Annotation",
              "motivation": "painting",
              "body": {
                "id": "https://iiif.io/api/image/3.0/example/reference/43153e2ec7531f14dd1c9b2fc401678a-88695674/full/max/0/default.jpg",
                "type": "Image",
                "format": "image/jpeg",
                "height": 7072,
                "width": 5212,
                "service": [
                  {
                    "id": "https://iiif.io/api/image/3.0/example/reference/43153e2ec7531f14dd1c9b2fc401678a-88695674/",
                    "profile": "level1",
                    "type": "ImageService3"
                  }
                ]
              },
              "target": "https://iiif.io/api/cookbook/recipe/0230-navdate/canvas/p1"
            }
          ]
        }
      ]
    }
  ]
}

相关专题

• 书籍章节目录描述了如何排列含有范围（Range）的资源
• [可替代序列 (通过 sequence 范围)][0027] 描述了如何为非默认资源排序
• [具有多个排序的手稿][0070] 描述了一个现实问题以及多种排序可能如何解决这一问题
• [视频导航的缩略图范围][0073] 描述了如何从视频资源中排列缩略图以进行导航
• 基础报纸描述了与多个清单（Manifest）一起使用的navDate属性