Integrated Database Search for Metropolitan Museums

Developer

バージョン︓1.0
リリース︓2021/03/30

Tokyo Museum Collection (以降、TMC)では、東京都の⽂化施設の所蔵品情報を収集して統合データベースを構築しています。TMCではすべての所蔵品データのメタデータ(所蔵品に関する情報)をオープンデータとして公開しています。以降、データの利⽤⽅法について解説します。

本サイトの概要や利⽤条件については以下のページを参照してください。

  • ・Tokyo Museum Collection について
  • ・利⽤条件

データの⼊⼿⽅法

TMCでは次の2つの⽅法でデータを⼊⼿できます。

  • 1. 各所蔵品の詳細ページのメタデータダウンロードボタン
    各所蔵品のオープンデータはそれぞれの個別ページからJSON形式でダウンロードできます。 キャプチャー画像:作品詳細ページ
  • 2. 検索API

    指定した条件で絞込検索した結果を返却します。検索条件をパラメーターとして付与したGETリクエストを送信してください。JSON形式のデータがレスポンスされます。

    API Path

                          
    https://museumcollection.tokyo/works/?output=json
                          
                        
    パラメーター
    パラメーター 説明
    keyword 検索キーワードを指定します
    artist_name 作家名を指定します
    genre ジャンルを指定します
    medium 材質・技法の値を指定します
    museums 施設コード表を用い、所蔵品を保持している所蔵館を指定します。値は配列で送信します
    production_year_from 制作年を指定します。入力された西暦以降の作品を検索します
    production_year_to 制作年を指定します。入力された西暦以前の作品を検索します
    limit 取得する件数を指定します。0から1000の間で指定でき、初期値は100です
    offset 取得をスキップする数を指定します
    output "json"を指定します

    サンプルクエリ(江戸東京博物館の1900年以降の版画を検索)

    https://museumcollection.tokyo/works/?genre=block-prints&production_year_from=1900&museums[]=edo-tokyo-museum&output=json

各種コード

TMC内では施設コードを定め、データの中で参照している。検索クエリにも⽤いる。

1. 施設コード
コード ラベル(日) ラベル(英) IRI
edo-tokyo-museum 江戸東京博物館   https://museumcollection.tokyo/ns/codes/museums#edo-tokyo-museum
topmuseum 東京都写真美術館   https://museumcollection.tokyo/ns/codes/museums#topmuseum
mot-art-museum 東京都現代美術館   https://museumcollection.tokyo/ns/codes/museums#mot-art-museum
tatemonoen 江戸東京建物園   https://museumcollection.tokyo/ns/codes/museums#tatemonoen
tobikan 東京都美術館   https://museumcollection.tokyo/ns/codes/museums#tobikan
teien-art-museum 庭園美術館   https://museumcollection.tokyo/ns/codes/museums#teien-art-museum

データ形式

TMCでは、TMCが定める標準項⽬のデータをJSON形式で返却しています。

TMC標準項⽬

TMC標準項⽬とは、TMCがデータ収集対象としている各施設のデータ間で共通化できるデータ項⽬を指します。各施設によるオリジナルデータとTMC標準項⽬の対照表を表1に⽰します。

・ここで定める全ての値が揃っていることは保証されません。当該項⽬の値が無い場合は空⽂字列が⼊ります

表1)TMC標準項⽬と各施設によるオリジナルデータ項⽬との対照表

TMC共通項目 江戸東京博物館 東京都写真美術館 東京都現代美術館 江戸東京建物園 東京都美術館 庭園美術館
ID 資料番号 作品番号/Art number 収蔵作品番号 資料番号 作品番号 収蔵品No.
作品名 資料名 作品名(和)/Title in Japanese 作品名 建造物名 作品名 作品名
作品名(en) 資料名(英) 作品名(英)/Title in English 作品名英文 Name 作品名(英題) Title
大分類名 一分類 区分/Category 作品分類   中分類 大分類
中分類名 二分類          
制作年 西暦年月日 制作年/Date 制作年 制作年(建築年) 制作年(西暦) 制作年
所蔵館       所蔵館    
サイズ(高さ) 寸法_高さ   サイズ(高さ、縦)   寸法(高さ、縦)cm  
サイズ(幅) 寸法_横   サイズ(横、幅)   寸法(幅、横)cm  
サイズ(奥行) 寸法_縦   サイズ(奥行)   寸法(奥行き)cm  
寸法(公開用)   寸法/Size(和)       寸法
収集方法 収集方法 受入方法       収集の方法
作者名 作者名   作家名   作家名 作者名
作者名(en) 作者名(英)   作家名英文   作家名(英語表記) Artist name
材質・技法   技法/Technique(和) 材質・技法   材質・技法 素材・技法
材質・技法(en)     材質・技法(英文)   材質・技法(英文)  
生没年     生没年     生没年
解説 解説 解説(和)   解説    

レスポンスデータ

TMC標準項⽬をJSON-LD形式で返却します。データモデルはSchma.orgのCreativeWorkを参照しています。いくつかのクラスがネストされた構造になっています。以降はクラスごとのプロパティとその値の⼀覧になります。

※ JSON-LDとはLinked DataのJSON表現です。詳しくはW3Cのドキュメントをご参照ください
※ Schema.org では多様な概念を対象にデータモデルを策定しています

レスポンスデータの構造
図)レスポンスデータの構造
schema:CreativeWork
プロパティ TMC共通項目
schema:identifier schema:PropertyValueのArray  
schema:genre skos:ConceptのArray(分野コードを参照) 大分類、中分類
schema:name literalのArray(対応する言語を言語タグで指定) 作品名、作品名(en)
schema:creator schema:PersonのArray  
schema:size literalのArray(対応する言語を言語タグで指定) サイズ(高さ)、サイズ(幅)、サイズ(奥行き)、寸法
schema:dateCreated 4桁の数字 制作年
schema:material literalのArray(対応する言語を言語タグで指定) 材質・技法、材質・技法(en)
schema:isPartOf schema:CollectionのArray  
dct:provenance literalのArray(対応する言語を言語タグで指定) 収集方法
schema:description literalのArray(対応する言語を言語タグで指定) 解説

schema:PropertyValue

TMC ID とaccession numberと2系統のIDがある。 TMC ID はTMC内での所蔵品の識別⼦。 accession numberは所蔵館による元データが持っていた識別⼦。

プロパティ TMC共通項目
schema:value literal(体系の中での識別値) ID(accession number)
schema:name literal(IDの体系を指すラベル)  
schema:Person
プロパティ TMC共通項目
schema:name literalのArray(対応する言語を言語タグで指定) 作家名、作家名(en)
schema:birthDate xsd:date 生没年(生年)
schema:deathDate xsd:date 生没年(没年)

schema:Collection

所蔵品は必ず所蔵館のコレクションに含まれる。また、所蔵品がシリーズを構成する場合にもschema:Collectionのオブジェクトとして⽰される。

プロパティ TMC共通項目
schema:maintainer schema:OrganizationのArray  
schema:name literalのArray(対応する言語を言語タグで指定) 所蔵館
schema:Organization
プロパティ TMC共通項目
schema:name literalのArray(対応する言語を言語タグで指定) 所蔵館

データ例

                  
{
    "@context": {
        "dct": "http://purl.org/dc/elements/1.1/",
        "schema": "http://schema.org/",
        "xsd": "http://www.w3.org/2001/XMLSchema#",
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#"
    },
    "@type": "schema:CreativeWork",
    "@id": "https://museumcollection.tokyo/works/6231143",
    "schema:identifier": [
        {
            "@type": "PropertyValue",
            "schema:name": "TMC ID",
            "schema:value": "6231143"
        },
        {
            "@type": "PropertyValue",
            "schema:name": "accession number",
            "schema:value": "1975-00-0539-000"
        }
    ],
    "schema:genre": [
        {
            "@id": "https://museumcollection.tokyo/ns/codes/genre#絵画",
            "skos:prefLabel": [
                {
                    "@value": "絵画",
                    "@lang": "ja"
                }
            ]
        }
    ],
    "schema:name": [
        {
            "@value": "忙中閑",
            "@lang": "ja"
        },
        {
            "@value": "A Rest During a Busy Day",
            "@lang": "en"
        }
    ],
    "schema:creator": [
        {
            "@type": "schema:Person",
            "schema:name": [
                {
                    "@value": "山本 日子士良",
                    "@lang": "ja"
                },
                {
                    "@value": "YAMAMOTO Hikoshiro",
                    "@lang": "en"
                }
            ],
            "schema:birthDate": [
                {
                    "@type": "xsd:date",
                    "@value": "1907-06-24"
                }
            ],
            "schema:deathDate": [
                {
                    "@type": "xsd:date",
                    "@value": "1946-01-19"
                }
            ]
        }
    ],
    "schema:size": "145.5(高さ、縦)×112.1(幅、横) cm",
    "schema:dateCreated": "1967",
    "schema:material": [
        {
            "@value": "油彩/カンヴァス",
            "@lang": "ja"
        },
        {
            "@value": "Oil on canvas",
            "@lang": "en"
        }
    ],
    "schema:isPartOf": [
        {
            "@type": "schema:Collection",
            "schema:maintainer": [
                {
                    "@type": "schema:Organization",
                    "schema:name": [
                        {
                            "@value": "東京都現代美術館",
                            "@lang": "ja"
                        },
                        {
                            "@value": "Museum of Contemporary Art Tokyo",
                            "@lang": "en"
                        }
                    ]
                }
            ]
        },
        {
            "@type": "schema:Collection",
            "schema:name": [
                {
                    "@value": "コレクション名",
                    "@lang": "ja"
                },
                {
                    "@value": "Collection Name",
                    "@lang": "en"
                }
            ]
        }
    ],
    "dct:provenance": [
        {
            "@value": "寄贈",
            "@lang": "ja"
        }
    ]
}