GSJ 地質年代データセット（GeolTime）API ドキュメント

概要

GSJ 地質年代 API は、 GSJ 地質年代データセット（GeolTime） に含まれる地質年代情報を、機械可読な形式で取得するための Web API です。 GEOAGE コードに対応する年代リソース（item）と、年代階級（eon, era, period, epoch, age 等）を表す Rank リソースを提供します。

提供形式

本 API ドキュメントでは、application/json の JSON レスポンスを対象とします。 同じリソース URI について、URI 末尾に .rdf を付与する形式指定、またはコンテンツネゴシエーションにより、 RDF/XML 形式の取得も可能です。

提供リソース

本 API では、主として次の 2 種類のリソースを提供します。

GeolTime item（年代アイテム）

GEOAGE コードに対応する地質年代単位（名称、階級、数値年代、親子階層など）を表すリソースです。

GeolTime rank（年代階級）

年代階級（eon, era, period, epoch, age など）を表すリソースです。

年代アイテム（item）

GEOAGE コードから年代アイテムを取得（item）

GEOAGE コードを指定して、そのコードに対応する年代アイテム（GeolTime item）を取得します。

レスポンス例

{
  "type": "GeolTime",
  "code": "GEOAGE_111010030",
  "@id": "https://gbank.gsj.jp/ld/resource/geoltime/item/GEOAGE_111010030",
  "license": "https://www.gsj.jp/license/license.html",
  "note": "本データは日本地質学会ガイドラインに基づく年代名称をGSJが機械可読形式に再構築したものです。元データの著作権は日本地質学会にあります。",
  "source": [
    {
      "label": "地質系統・年代の日本語記述ガイドライン（日本地質学会）",
      "url": "https://geosociety.jp/name/content0062.html"
    }
  ],
  "parent_code": "GEOAGE_111010000",
  "name": "完新世前期",
  "name_e": "Early Holocene",
  "rank_code": "age",
  "rank": "期",
  "rank_e": "Age",
  "jis_a_0205_age_code": "111010030",
  "age_unit": "Ma",
  "upper_age": 0.0082,
  "upper_age_str": "0.0082",
  "lower_age": 0.0117,
  "lower_age_str": "0.0117",
  "isPartOf": "https://gbank.gsj.jp/ld/resource/geoltime/item/GEOAGE_111010000",
  "hasPart": [
    "https://gbank.gsj.jp/ld/resource/geoltime/item/GEOAGE_111010400"
  ]
}

主なフィールド

type

リソース種別（GeolTime）。

code, @id

GEOAGE コードおよび当該年代リソースの URI。

name / name_e

年代名（日本語 / 英語）。

rank_code, rank, rank_e

年代階級（例：期 / age）と、その日本語・英語名称。

upper_age / lower_age

上限 / 下限の数値年代 （単位は Ma：現在から数えて何百万年前かを表す）。 機械処理や数値比較を目的として、年代定義から数値部分のみを取り出したものです。

upper_age_str / lower_age_str

公式な年代定義における誤差表記（± 等）を含む元の年代表記を保持した文字列表現です。 上記の数値型フィールド（upper_age, lower_age）は、 この表記から便宜的に数値部分のみを抽出したものです。

parent_code, isPartOf, hasPart

年代階層構造（親・子の関係）。

license, note, source

ライセンス・注意事項・出典情報。

年代階級（rank）

年代階級コードから Rank を取得（rank）

年代階級コード（eon, era, period, epoch, age など）を指定して、Rank リソースを取得します。

レスポンス例

{
  "type": "GeolTimeRank",
  "code": "age",
  "@id": "https://gbank.gsj.jp/ld/resource/geoltime/rank/age",
  "name": "期",
  "name_e": "Age",
  "notation": "age"
}

主なフィールド

type

リソース種別（GeolTimeRank）。

code, @id

年代階級コードおよび当該 Rank リソースの URI。

name / name_e

年代階級名（日本語 / 英語）。

notation

表示用の略記（多くの場合 code と同じ）。

エラー応答

指定した GEOAGE コードや年代階級コードが存在しない場合などには、次のようなエラー応答が返されます。

{
  "ok": false,
  "message": "GeolTime item not found for code=GEOAGE_999999999"
}

ok

成功かどうか（エラー時は false）。

message

エラー内容を示すメッセージ。

補足

より詳細なフィールド定義やスキーマは、OpenAPI 仕様（JSON）または Swagger UI のスキーマ表示を参照してください。