開発者の方へ（視覚障害者等用データ送信サービスに関する技術情報のご案内）

視覚障害者等用データ送信サービスは、視覚障害その他の理由で通常の活字の印刷物の利用が困難な方のために製作されたデータを、みなサーチ（国立国会図書館障害者用資料検索）を通じて提供するものです。

このページでは、個別のニーズに合わせたアプリケーションの作成等、視覚障害者等用データ送信サービスを利用したシステム開発に必要な情報を掲載しています。ご不明な点等は、ページ末尾のお問い合わせ先にご連絡ください。

視覚障害者等用データ送信サービスの内容、提供しているデータ数等は、以下のページをご覧ください。

• 視覚障害者等用データ送信サービス（視覚障害者等個人の方向けのご案内）
• 視覚障害者等用データ送信サービス（図書館等向け案内）

• 1.はじめに
  • 1.1 用語
  • 1.2 日本における視覚障害者等用データの流通の概要
• 2. メタデータ
  • 2.1 リクエスト
  • 2.2 レスポンス
• 3. コンテンツ
  • 3.1 コンテンツの種類・形式と利用方法
  • 3.2 コンテンツファイルのディレクトリ構造
  • 3.3 コンテンツの取得
• 4. メタデータ、コンテンツ利用に必要な手続きと留意事項
  • 4.1 メタデータ（国立国会図書館サーチの外部提供インタフェース（API））の利用
  • 4.2 コンテンツの利用
• 5. お問い合わせ

著作権法第37条第3項で定義される用語。視覚障害のほか、肢体不自由やディスレクシアなどの理由により、視覚著作物（紙の本）をそのままの方式では利用することが困難な状態の者をいう。プリント・ディスアビリティのある者とほぼ同義。

視覚著作物（紙の本）を、録音図書（音訳）、点字（点訳）、テキストデータ等の、視覚障害者等が読書できる形式に変換したデータ。著作権法第37条の権利制限に基づいて視覚障害者等に提供するために製作されている。国立国会図書館が製作又は、公共図書館、大学図書館等から収集し、「視覚障害者等用データ送信サービス」を通じて提供している。

国立国会図書館が製作又は収集した視覚障害者等用データを、当館に利用者登録した視覚障害者等及び当館が承認した図書館等に対して送信するサービス。国立国会図書館視覚障害者等用資料送信及び貸出規則（平成25年国立国会図書館規則第6号）に基づいて提供されている。開発者による開発目的での利用については、同規則第1条の「別に定めるもの」として例外的に認められる場合がある。

国立国会図書館やサピエ図書館など、日本の視覚障害者等用データの流通の概要は「日本における視覚障害者等用データの流通の概要 ― 国立国会図書館とサピエ図書館 ―」（PDF: 147KB）をご覧ください。

国立国会図書館サーチの外部提供インタフェース（API）で、メタデータの検索やハーベストが可能です。

国立国会図書館サーチAPIの仕様は国立国会図書館サーチ API仕様の概要に掲載しています。ここでは本サービスに関する補足事項を中心に記載しますので、APIの仕様と併せてご覧ください。

データの種類と対応するデータプロバイダは以下のとおりです。

SRU（SRU（Search/Retrieve Via URL）により結果を取得）

• https://ndlsearch.ndl.go.jp/api/sru?operation=searchRetrieve&recordSchema=dcndl&query=dpid=ndl-dl-daisy AND anywhere=プロ野球 AND from=2018
  原本が2018年以降に刊行され、キーワードに「プロ野球」を含む資料をDCNDL形式で表示
• https://ndlsearch.ndl.go.jp/api/sru?operation=searchRetrieve&query=dpid=ndl-dl-daisy AND title=図書館&mediatype=mina-text
  タイトルに「図書館」を含むテキストデータをDC形式で表示

  ※「mediatype=mina-text」と指定すると、コレクションが「障害者向け資料」であり、資料形態がテキストデータであるメタデータに絞り込めます。 「mediaType」で指定できるコレクションや資料形態については、API仕様書（日本語版）の「附録2．データグループID・mediaType一覧 （PDF）」をご参照ください。

  ※recordSchemaを指定しない場合はDC形式のデータを表示します。

OpenSearch（URL で検索リクエストを発行し、結果を RSS2.0 形式で取得）

• https://ndlsearch.ndl.go.jp/api/opensearch?dpid=ndl-dl-daisy&title=心情の敵対者としての精神
  「心情の敵対者としての精神」というタイトルの資料を検索
• https://ndlsearch.ndl.go.jp/api/opensearch?dpid=ndl-dl-daisy&anywhare=ことわざ&digitized_publisher=国立国会図書館
  キーワードに「ことわざ」を含み、製作館が国立国会図書館である資料を検索

OpenURL（URL で発行されるリクエストに対して画面（HTML）で結果を返戻）

• https://mina.ndl.go.jp/api/openurl?ndl_dpid=ndl-dl-daisy&au=夏目漱石
  著者に「夏目漱石」を含むデータをみなサーチで検索
• https://ndlsearch.ndl.go.jp/api/openurl?ndl_dpid=ndl-dl-daisy&any=ことわざ&mediatype=mina-daisy
  キーワードに「ことわざ」を含むDAISYデータを国立国会図書館サーチで検索

  ※「mediatype=mina-daisy」と指定すると、コレクションが障害者向け資料であり、資料形態がDAISYのメタデータに絞り込めます。

OAI-PMH　ListRecords（全アイテムのメタデータを取得する）

• https://ndlsearch.ndl.go.jp/api/oaipmh?verb=ListRecords&metadataPrefix=dcndl&set=ndl-dl-daisy&from=2024-04-15&until=2024-04-20
  2024年4月15日から2024年4月20日に更新された資料のメタデータをDC-NDL形式で取得
• https://ndlsearch.ndl.go.jp/api/oaipmh?verb=ListRecords&metadataPrefix=oai_dc&set=ndl-dl-daisy&from=2024-04-01&until=2024-04-10
  2024年4月1日から2024年4月10日に更新された資料のメタデータをOAI＿DC形式で表示

  ※「ページのソースを表示」等でご覧ください。

  ※「no record match」となる場合は、from・untilの日付を変更してお試しください。期間は1年以内を指定してください。

OAI-PMH　GetRecord（特定のアイテム1件のメタデータを取得する）

• https://ndlsearch.ndl.go.jp/api/oaipmh?verb=GetRecord&metadataPrefix=dcndl&identifier=oai:ndlsearch.ndl.go.jp:R100000073-I12970745
  メタデータID「R100000073-I12970745」のメタデータをdcndl形式で取得。

  ※「ページのソースを表示」等でご覧ください。

  ※メタデータIDは、本サービスの全メタデータに対して一意に付与されているID で以下の体系で構成されます。
  oai(ドメイン名) :[リポジトリ番号]-[アイテム番号]
  全文テキストデータを除く視覚障害者等用データ送信サービスのリポジトリ番号は「R100000073」です。

返戻データ形式ごとの例です。以下は同一データの各形式の表示例です。

• ※OAI-PMHの例は「ページのソースを表示」等でご覧ください。

• データ例 DC-NDL（RDF）形式 ※OAI-PMHの例
• データ例 DC形式 ※SRUの例
• データ例 OAI_DC形式（OAI-PMH） ※OAI-PMHの例

データの種類ごとの例です。以下はいずれもOAI-PMHのDC-NDL(RDF)の例です。「ページのソースを表示」等でご覧ください。

• 音声DAISY
• マルチメディアDAISY
• テキストDAISY
• 電子書籍（EPUB）
• 音声付き電子書籍（EPUB）
• 透明テキスト付PDF
• Word（DOCX）
• プレーンテキスト（TXT）
• 点字データ

視覚障害者等用データ送信サービスで特徴的なレスポンス項目は以下のとおりです。

※出力内容は、変更になる場合があります。

DC-NDL（RDF）フォーマット仕様の詳細については、以下をご参照ください。

• DC-NDL（RDF）フォーマット仕様

コンテンツの種類・形式と提供している利用方法（ダウンロードとストリーミング）は、以下のとおりです。コンテンツの種類は、メタデータ「記録形式（データ型なし）」で判別できます。

※　EPUB以外のダウンロードファイルはzip形式で圧縮されています。EPUBのダウンロードファイルはepub形式です。

※　本表に記載されるファイル形式以外のものも収集対象になる場合があります。

音声DAISY、マルチメディアDAISY

zip形式で圧縮されたコンテンツファイルを解凍した後のディレクトリ構造は以下のとおりです。

  XXXXXXX/（DAISY図書の日本語タイトルがフォルダ名になっている。）
    ├─discinfo.html
    ├─abcdefg/（DAISY図書コンテンツファイルが格納されるフォルダ。フォルダ名は製作者の任意で英数のみ。）
    │  │
    │  ├─ncc.html
    │  ├─p00001.mp3（DAISY図書の音声ファイル。ファイル名は製作者の任意で英数のみ。）
    │  ├─p00002.mp3
　                  ︙
    │  ├─p00001.smil（DAISY図書のSMILファイル。ファイル名は製作者の任意で英数のみ。）
    │  ├─p00002.smil
                    ︙

※　その他、DAISY製作ソフトのプロジェクトファイルが同梱されることがありますが、基本的に無視していただいて差し支えありません。

テキストDAISY

zip形式で圧縮されたコンテンツファイルを解凍した後のディレクトリ構造は以下のとおりです。

  XXXXXXX/（DAISY図書の日本語タイトルがフォルダ名になっている。）
    ├─abcdefg/（DAISY図書のコンテンツファイルが格納されるフォルダ。フォルダ名は製作者の任意で英数のみ。）
    │  │
    │  ├─abcdefg.opf（パッケージファイル。ファイル名は製作者の任意で英数のみ。上の階層のフォルダ名と揃えられることが多い。）
    │  ├─abcdefg.ncx（ナビゲーションコントロールファイル。ファイル名は製作者の任意で英数のみ。上の階層のフォルダ名と揃えられることが多い。）
    │  ├─abcdefg.xsl（XSLTスタイルシート。ファイル名は製作者の任意で英数のみ。上の階層のフォルダ名と揃えられることが多い。）
    │  ├─abcdefg.res（リソースファイル。ファイル名は製作者の任意で英数のみ。上の階層のフォルダ名と揃えられることが多い。）
    │  ├─ptk00001.xml（DAISY図書のテキストコンテンツファイル。ファイル名は製作者の任意で英数のみ。）
    │  ├─ptk00002.xml
　                  ︙
    │  ├─ptk00001.smil（DAISY図書のSMILファイル。ファイル名は製作者の任意で英数のみ。）
    │  ├─ptk00002.smil
                    ︙

※　その他、DTDファイルやエンティティ参照 (oeb12.ent)等が同梱されることがあります。

電子書籍（EPUB）・音声付き電子書籍（EPUB）

ダウンロードファイルはepub形式で、単一ファイルです。

  abcdefg.epub（ファイル名は製作者の任意で英数のみ。）

透明テキスト付PDF、Word（DOCX）、プレーンテキスト（TXT）

zip形式で圧縮されたコンテンツファイルを解凍した後のディレクトリ構造は以下のとおりです。

  XXXXXXX/（原本の日本語書名タイトルがフォルダ名になっている。）
    ├─abcdefg01.txt（ファイル名は製作者の任意で英数のみ。）
    ├─abcdefg02.txt（ファイル名は製作者の任意で英数のみ。）
    ├─abcdefg03.txt（ファイル名は製作者の任意で英数のみ。）
                ︙

※　上記はプレーンテキスト（TXT）の例です。透明テキスト付PDFの場合は拡張子が.pdf、Word（DOCX）の場合は拡張子が.docxです。

点字データ

zip形式で圧縮されたコンテンツファイルを解凍した後のディレクトリ構造は以下のとおりです。以下はBES形式の例です。

  XXXXXXX/（原本の日本語書名タイトルがフォルダ名になっている。）
    ├─abcdefg01.bes（ファイル名は製作者の任意で英数のみ。）
    ├─abcdefg02.bes（ファイル名は製作者の任意で英数のみ。）
    ├─abcdefg03.bes（ファイル名は製作者の任意で英数のみ。）
                ︙

※　点図データ（エーデル形式）が同梱されることがあります。

コンテンツは、著作権法第37条の権利制限規定等に基づき製作されたもので、視覚障害者等として国立国会図書館に登録された方のみ利用できます。利用の際には、みなサーチに視覚障害者等用データ送信サービスの利用者IDでログインする必要があります。

• ※ログインに関するAPIはありません。

ログインをした上で、メタデータ中のダウンロードURL・ストリーミングURLにアクセスをすると、コンテンツを取得することができます。

コンテンツのダウンロードURL・ストリーミングURLは、メタデータ中の「rdfs:seeAlso（提供元書誌詳細画面のURL）」タグの「rdf:resource」属性に記載されています。このURLにアクセスするとダウンロード又はストリーミングが始まります。

ストリーミングを提供しているかどうかは、ストリーミングURLが記載された「rdfs:seeAlso（提供元書誌詳細画面のURL）」タグの有無により判別することが可能です。ストリーミングURLがある場合は、ストリーミングを提供しています。

メタデータ中のダウンロードURL・ストリーミングURLについて

XXXXXXX にはコンテンツごとにユニークな数字が入ります。

【ダウンロードURL】

URLに"download"という文字列が含まれています。

https://mina.ndl.go.jp/api/daisy/download/R100000073-IXXXXXXXX

【ストリーミングURL】

URLに"streaming"という文字列が含まれています。

https://mina.ndl.go.jp/api/daisy/streaming/R100000073-IXXXXXXXX

具体例（『ファインマン物理学.1』の音声DAISYデータ）

• みなサーチ書誌:ファインマン物理学.1
• メタデータ:データ例　DC-NDL(RDF)形式 ※OAI-PMHの例。「ページのソースを表示」等でご覧ください。

上記メタデータ中のrdfs:seeAlso部分

  <rdfs:seeAlso rdf:resource="https://mina.ndl.go.jp/api/daisy/streaming/R100000073-I8833093"/>
  <rdfs:seeAlso rdf:resource="https://mina.ndl.go.jp/api/daisy/download/R100000073-I8833093"/>

ストリーミングURLとダウンロードURLが記述されていることで、この音声DAISYについては、ダウンロードとストリーミングが可能と判断できます。

音声DAISY・マルチメディアDAISYのストリーミングについて

音声DAISY（DAISY 2.02）とマルチメディアDAISY（DAISY 2.02）のストリーミング再生は特殊な方法で実装しています。詳細はお問い合わせください。

* API利用全般については「APIのご利用について」をご覧ください

営利・非営利ともに申請不要でご利用いただけます。ただし、出典記載等の「書誌データの利用ルール」に従ってください。この書誌データの利用ルールは、クリエイティブ・コモンズ 表示 4.0 国際 パブリックライセンス（CC BY）と互換性があります。

視覚障害者等用データは、著作権法第37条の権利制限規定に基づいて製作・提供されています。著作権法第37条の詳細は「著作権法（昭和45年法律第48号）」をご覧ください。

コンテンツへのアクセス（ダウンロード・ストリーミング）には、視覚障害者等用データ送信サービスの利用者IDとパスワードが必要です。アプリケーションの開発・検証等のために利用者IDとパスワードが必要な場合は、このページの最後に示す問い合わせ先にお問い合わせください。申請内容等から個別に検討させていただきます。

なお、利用者が個人として利用者ID・パスワードを取得する方法については、「視覚障害者等用データ送信サービスの利用者登録について」をご覧ください。

留意事項

コンテンツの利用については、次の点に留意してください。

• 視覚障害者等でない者が利用することはできない。
• 図書館等でない者が複製することはできない。
• 開発目的での利用については、著作権法第30条の4第1号に規定する範囲において可能である。（「必要と認められる限度」に限られている点に留意されたい。）
• その他、国立国会図書館との間での合意事項（覚書等）を遵守すること。

図書館協力課 障害者図書館協力係
電話：0774-98-1458（月曜日から金曜日 9時から17時45分 国民の休日・祝日及び年末年始を除く）
FAX：0774-94-9117
メールアドレス：syo-tky