ホーム > 図書館員の方へ > 障害者サービスを実施する図書館へのサービス > 視覚障害者等用データの収集および送信サービス > 開発者の方へ(視覚障害者等用データ送信サービスに関する技術情報のご案内)

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

視覚障害者等用データ送信サービスは、視覚障害その他の理由で通常の活字の印刷物の利用が困難な方のために製作されたデータを、国立国会図書館サーチを通じて提供するものです。このページでは、個別のニーズに合わせたアプリケーションの作成等、視覚障害者等用データ送信サービスを利用したシステム開発に必要な情報を掲載しています。ご不明な点等は、ページ末尾のお問い合わせ先にお問い合わせください。

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

目次

1. 概要

1.1 メタデータの検索・ハーベスト

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

1.2 コンテンツの利用

1.2.1 音声DAISY、マルチメディアDAISY、テキストDAISY、プレーンテキスト

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

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

1.2.2 点字データ

点字データの利用には、国立国会図書館への登録やログインは必要ありません。どなたでもご利用いただけます。

このページの先頭へ

2. メタデータ

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

国立国会図書館サーチAPIの仕様は「国立国会図書館サーチ 外部提供インタフェース(API)」に掲載しています。ここでは本サービスに関する補足事項を中心に記載しますので、APIの仕様と併せてご覧ください。

2.1 リクエスト

2.1.1 データの種類と対応するデータプロバイダ

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

データの種類と提供する利用方法
データの種類データプロバイダ名称データプロバイダID備考
音声DAISY、マルチメディアDAISY、テキストDAISY、プレーンテキスト視覚障害者等用デジタル資料ndl-dl-daisy4種類のどれかを判別する方法は、レスポンスの特徴的な出力項目をご覧ください。
点字データ国立国会図書館デジタルコレクションndl-dl視覚障害者等用デジタル資料(ndl-dl)の中で、コレクションコード「点字データ(D12)」を指定すると、視覚障害者等用データ送信サービスの点字データのみを検索できます。コレクションコードの指定は OAI-PMH のみできます。

2.1.2 リクエスト例

SRU
  • 点字データの「mediatype=8」は「資料種別=障害者向け資料(障害者向け資料検索対象資料)」です。「dpid=ndl-dl(国立会図書館デジタルコレクション)」かつ「mediatype=8」は、2018年3月時点では視覚障害者向けデータ送信サービスの点字データのみです。今後他のデータが含まれる場合があります。
OpenSearch
  • 点字データの「mediatype=8」は「資料種別=障害者向け資料(障害者向け資料検索対象資料)」です。「dpid=ndl-dl(国立会図書館デジタルコレクション)」かつ「mediatype=8」は、2018年3月時点では視覚障害者向けデータ送信サービスの点字データのみです。今後他のデータが含まれる場合があります。
OpenURL
  • 点字データの「mediatype=8」は「資料種別=障害者向け資料(障害者向け資料検索対象資料)」です。「ndl_dpid=ndl-dl(国立会図書館デジタルコレクション)」かつ「mediatype=8」は、2018年3月時点では視覚障害者向けデータ送信サービスの点字データのみです。今後他のデータが含まれる場合があります。
OAI-PMH ListRecords(全アイテムのメタデータを取得する)
  • 「ページのソースを表示」等でご覧ください。
  • 「no record match」となる場合は、from・untilの日付を変更してお試しください。
OAI-PMH GetRecord(特定のアイテム1件のメタデータを取得する)
  • 「ページのソースを表示」等でご覧ください。

このページの先頭へ

2.2 レスポンス

2.2.1 データ例

返戻データ形式ごとの例です。以下の4つは同じデータのDC-NDL(RDF)の例です。

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

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

2.2.2 特徴的な出力項目

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

視覚障害者等用データ送信サービスで特徴的なレスポンス項目
項目名DC-NDL(RDF)のタグ名視覚障害者等用データ送信サービスの出力内容備考
著者別名dcndl:creatorAlternative著者よみ・DC-NDL(Simple)にこのタグはありません。
・dcndl:transcription(著者よみ)にうまく出力できないため、このタグに著者よみを出力しています。
注記dcterms:description原本の出版者・出版年・シリーズ名・ISBN、当該資料のシステム要件・製作注記、など
記録形式(データ型なし)dcterms:format(属性なし)データの種類・値は「音声DAISY」「マルチメディアDAISY」「テキストDAISY」「プレーンテキスト」「点字データ」のいずれか。
・DC-NDL(Simple)にこのタグはありません。
提供元書誌詳細画面のURLrdfs:seeAlsoのrdf:resource属性コンテンツのダウンロードURL・ストリーミングURL等

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

国立国会図書館ダブリンコアメタデータ記述(DC-NDL)の詳細については、以下をご参照ください。

このページの先頭へ

3. コンテンツ

3.1 コンテンツの種類・形式と利用方法

コンテンツの種類・形式と提供している利用方法(ダウンロードとストリーミング)は、以下のとおりです。

コンテンツの種類・形式と提供する利用方法
コンテンツの種類形式提供する利用方法
音声DAISYDAISY 2.02ダウンロードとストリーミング
マルチメディアDAISYDAISY 2.02ダウンロードとストリーミング
テキストDAISYANSI/NISO Z39.86-2005 (DAISY3)ダウンロードのみ
プレーンテキストTXTダウンロードのみ
点字データBSE又はBESダウンロードのみ

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

3.2 コンテンツファイルのディレクトリ構造

音声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)等が同梱されることがあります。

プレーンテキスト

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


  XXXXXXX/(原本の日本語書名タイトルがフォルダ名になっている。)
    └ abcdefg.txt(プレーンテキストデータ。フォルダ名は製作者の任意で英数のみ。)

点字データ

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


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

※ 一部の点字データは同じ内容のBES形式の点字データとBSE形式の点字データが同梱されています。また、点図データ(エーデル形式)が同梱されることがあります。

3.3 コンテンツの取得

3.3.1 音声DAISY、マルチメディアDAISY、テキストDAISY、プレーンテキスト

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

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

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

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

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

メタデータ中のダウンロードURL・ストリーミングURLについて
XXXXXXX にはコンテンツごとにユニークな数字が入ります。
【ダウンロードURL】

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


  http://iss.ndl.go.jp/info:ndljp/pid/XXXXXXXX/auth/daisy/download

【ストリーミングURL】

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


  http://iss.ndl.go.jp/info:ndljp/pid/XXXXXXXX/auth/daisy/streaming

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

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


  <rdfs:seeAlso rdf:resource="http://iss.ndl.go.jp/info:ndljp/pid/8833092/auth/daisy/streaming"/>
  <rdfs:seeAlso rdf:resource="http://iss.ndl.go.jp/info:ndljp/pid/8833092/auth/daisy/download"/>

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

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

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

3.3.2 点字データ

点字データの利用には、国立国会図書館への登録やログインは必要ありません。どなたでもご利用いただけます。

メタデータ中の「rdfs:seeAlso(提供元書誌詳細画面のURL)」タグの「rdf:resource」属性に、国立国会図書館デジタルコレクションの書誌画面のURLが記載されており、その国立国会図書館デジタルコレクションの書誌画面から点字データのダウンロードが可能です。「rdfs:seeAlso(提供元書誌詳細画面のURL)」記載のURLは、あくまで国立国会図書館デジタルコレクションの書誌画面へのリンクであり、直接点字データのダウンロードができるURLではありませんので、ご注意ください。

直接ダウンロードできるURLを使用したい場合は、国立国会図書館デジタルコレクションの点字データのダウンロードURLをご使用ください。ダウンロードURLは以下のとおりです。


  http://dl.ndl.go.jp/view/prepareDownload?itemId=info%3Andljp%2Fpid%2FXXXXXXX&contentNo=1

  • XXXXXXX にはコンテンツごとにユニークな数字が入ります。
  • XXXXXXX のユニークな数値は、メタデータ中の「dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/NDLJP"」(国立国会図書館で付与した永続的識別子)に記載されている永続識別子「info:ndljp/pid/XXXXXXXX」の「XXXXXXXX」です。
具体例(『東京の障害者サービス.1996』の点字データ)

上記メタデータ中の「rdfs:seeAlso(提供元書誌詳細画面のURL)」部分


  <rdcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/NDLJP">info:ndljp/pid/11035806</dcterms:identifier>
  <rdfs:seeAlso rdf:resource="http://dl.ndl.go.jp/info:ndljp/pid/11035806"/>


国立国会図書館デジタルコレクションの点字データダウンロードURL


  http://dl.ndl.go.jp/view/prepareDownload?itemId=info%3Andljp%2Fpid%2F11035806&contentNo=1

このページの先頭へ

4. 開発のために必要な手続き等

4.1 メタデータ(国立国会図書館サーチの外部提供インタフェース(API))の利用

国立国会図書館サーチ APIのご利用について」をご一読いただき、必要に応じて同ページにリンクのある「API利用申請フォーム」から申請してください。

4.2 コンテンツへのアクセス

4.2.1 音声DAISY、マルチメディアDAISY、テキストDAISY、プレーンテキスト

コンテンツへのアクセス(ダウンロード・ストリーミング)には、専用のIDとパスワードが必要です。アプリケーションの開発・検証等のためにIDとパスワードが必要な場合は、上記の「API利用申請フォーム」の「7. 通信欄」にその旨を記載して申請してください。申請内容等から個別に検討させていただきます。

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

4.2.2 点字データ

点字データの利用には、国立国会図書館への登録やログインは必要ありません。どなたでもご利用いただけます。

このページの先頭へ

5. お問い合わせ

図書館協力課 障害者図書館協力係
電話:0774-98-1458(月曜日から金曜日 9時から17時45分 国民の休日・祝日及び年末年始を除く)
FAX:0774-94-9117
メールアドレス:syo-tkyアットマークエヌディーエルピリオドジーオーピリオドジェーピー