第四紀噴火・貫入活動データベース API仕様

第四紀噴火・貫入活動データベースは、第四紀に活動した国内の火山及び貫入岩体についての活動年代などの情報を提供しています。

この第四紀噴火・貫入活動データベースAPIを利用することで、現在から過去約3百万年の間に活動の認められた噴火および貫入活動について、

  1. 緯度経度範囲から検索
  2. ある地点から指定距離内にあるものを検索
  3. 過去のある期間に活動のあったものを検索
  4. 指定した火山についての情報を取得
することができます。

リクエストの例

検索条件を指定して火山を検索するためのリクエストの例を以下に示します。

火山情報リストを全てJSONで取得
https://gbank.gsj.jp/quatigneous/api/volcano.json
緯度経度範囲内の火山情報リストをJSONで取得
https://gbank.gsj.jp/quatigneous/api/volcano.json?BBox=138,139,36,37
指定位置を中心とした指定距離内の火山情報リストをJSONで取得
https://gbank.gsj.jp/quatigneous/api/volcano.json?Center=139.72,35.69&Distance=100
指定位置を中心とした指定距離内の火山情報リストをHTMLで取得
https://gbank.gsj.jp/quatigneous/api/volcano.html?Center=139.72,35.69&Distance=100
指定位置を中心とした指定距離内の火山情報リストをHTMLで取得(ヘッダー付)
https://gbank.gsj.jp/quatigneous/api/volcano.html?Center=139.72,35.69&Distance=100&html_header=1
50万~10万年前の期間に活動した火山情報リストをHTMLで取得
https://gbank.gsj.jp/quatigneous/api/volcano.html?upperAge=10&lowerAge=50
指定位置を中心とした指定距離内かつ50万~10万年前の期間に活動した火山情報リストをHTMLで取得
https://gbank.gsj.jp/quatigneous/api/volcano.html?Center=139.72,35.69&Distance=100&upperAge=10&lowerAge=50
火山id:260 の那須岳の火山情報をJSONで取得
https://gbank.gsj.jp/quatigneous/api/volcano/260.json
火山id:260 の那須岳の火山情報をHTMLで取得
https://gbank.gsj.jp/quatigneous/api/volcano/260.html
火山id:260 の那須岳の火山情報をHTMLで取得(ヘッダー付)
https://gbank.gsj.jp/quatigneous/api/volcano/260.html?html_header=1

リクエストURLおよびリクエストパラメータ

■ 火山情報リスト

リクエストURL
JSON形式: https://gbank.gsj.jp/quatigneous/api/volcano.json?[parameter]=[value]&…
HTML形式: https://gbank.gsj.jp/quatigneous/api/volcano.html?[parameter]=[value]&…

パラメータ名必須デフォルト説明
upperAgedouble--活動年代の上限(万年前)
lowerAgedouble--活動年代の下限(万年前)
BBoxdouble,double,double,double--緯度経度範囲(世界測地系)内の火山情報リストを取得。例:140,141,35,36
Centerdouble,double--Centerから半径Distance(km)の範囲内の火山情報リストを取得。例:140,35 [Distanceと同時に指定]
Distancedouble--Centerからの距離(km)。※ [Centerと同時に指定]
callbackstring--JSONPを利用する際に、JSON形式のデータを受け取るためのコールバック関数名
callback を指定することで、JSONP形式の出力となる
html_headerint-0HTMLで出力する際、1を指定するとページヘッダ・フッタが付加される。

※距離検索に関する注意: 火山位置(緯度経度情報)は代表的な山頂を示しています。貫入岩体の規模や山体形状等を考慮した噴出中心位置とは異なりますので、指定位置から火山までの距離には誤差が含まれます。


■ 火山情報

リクエストURL
JSON形式: https://gbank.gsj.jp/quatigneous/api/volcano/{id}.json?[parameter]=[value]&…
HTML形式: https://gbank.gsj.jp/quatigneous/api/volcano/{id}.html?[parameter]=[value]&…
({id}は、火山情報リストで取得することのできる火山IDを指定)

パラメータ名必須デフォルト説明
callbackstring--JSONPを利用する際に、JSON形式のデータを受け取るためのコールバック関数名
callback を指定することで、JSONP形式の出力となる
html_headerint-0HTMLで出力する際、1を指定するとページヘッダ・フッタが付加される。

レスポンス

■ 火山情報リストのJSON形式データ

プロパティ名内容
type"FeatureCollection"
category"volcano_list"
titleタイトル
nameデータセット名
base_uriURIのベース
features火山データの配列
プロパティ名内容
type"Feature"
name火山の名称
geometryジオメトリ
プロパティ名内容
type"point"
coordinates緯度経度
properties火山の情報
プロパティ名内容
data_id火山ID
lowerAge活動年代の下限(万年)
upperAge活動年代の上限(万年)
volcanoClass火山の種別
ageReliability年代の信頼度


■ 火山情報リストのJSON形式データの例

URL: https://gbank.gsj.jp/quatigneous/api/volcano

{
    "type": "FeatureCollection"
    "category": "volcano_list", 
    "title": "火山リスト", 
    "name": "q4magmatism", 
    "base_uri": "https://gbank.gsj.jp/quatigneous/api/volcano/", 
    "features": [
        {
            "type": "Feature", 
            "name": "茂世路岳", 
            "geometry": {
                "coordinates": [
                    148.83806, 
                    45.38917
                ], 
                "type": "point"
            }, 
            "properties": {
                "ageReliability": {
                    "text": "年代信頼度", 
                    "value": "C"
                }, 
                "data_id": {
                    "text": "火山ID", 
                    "value": 2
                }, 
                "lowerAge": {
                    "multiplier": 10000, 
                    "text": "下限(万年)", 
                    "unit": "year", 
                    "value": 5
                }, 
                "upperAge": {
                    "multiplier": 10000, 
                    "text": "上限(万年)", 
                    "unit": "year", 
                    "value": 0
                }, 
                "volcanoClass": {
                    "text": "種別ID", 
                    "value": 1
                }
            }
        }, 
        ........
    }
}

■ 火山情報JSON形式データ

プロパティ名内容
type"DataCollection"
category"volcano_information"
titleタイトル
nameデータセット名
base_uriURIのベース
uriこのデータを示すURI
geometryジオメトリ
プロパティ名内容
type"point"
coordinates緯度経度
properties火山の情報
プロパティ名内容
data_id火山ID
name火山・岩体名
nameYomi火山・岩体名の読み仮名
volcanoClass火山の種別
volcanoType火山の形式・構造
rockType主な岩石
activityPeriod活動年代
lowerAge活動年代の下限(万年)
upperAge活動年代の上限(万年)
ageReliability年代の信頼度
child参照データの配列
プロパティ名内容
type"data"
titleタイトル
name参照先火山の名称
properties参照先火山の参照情報
プロパティ名内容
data_idID
description参照先の記述
プロパティ名内容
typeデータ型式(html, json)
uriURI
reference参照文献情報
プロパティ名内容
titleタイトル
typeデータ型式(html, json)
uriURI


■ 火山情報JSON形式データの例:「那須岳」

URL: https://gbank.gsj.jp/quatigneous/api/volcano/260

{
    "type": "DataCollection", 
    "category": "volcano_information", 
    "title": "火山情報", 
    "name": "那須岳", 
    "base_uri": "https://gbank.gsj.jp/quatigneous/api/volcano/", 
    "uri": "https://gbank.gsj.jp/quatigneous/api/volcano/260"
    "geometry": {
        "type": "point", 
        "coordinates": [
            139.96306, 
            37.12472
        ]
    }, 
    "properties": {
        "activityPeriod": {
            "text": "活動年代", 
            "value": "約50万年前以降.茶臼岳火山は1万6000年前以降."
        }, 
        "ageReliability": {
            "text": "信頼度", 
            "value": "A"
        }, 
        "data_id": {
            "text": "火山ID", 
            "value": 260
        }, 
        "lowerAge": {
            "multiplier": 10000, 
            "text": "下限(万年)", 
            "unit": "year", 
            "value": 50
        }, 
        "name": {
            "text": "火山・岩体名", 
            "value": "那須岳"
        }, 
        "nameYomi": {
            "text": "よみ", 
            "value": "なすだけ"
        }, 
        "rockType": {
            "text": "主な岩石", 
            "value": "安山岩,玄武岩"
        }, 
        "upperAge": {
            "multiplier": 10000, 
            "text": "上限(万年)", 
            "unit": "year", 
            "value": 0
        }, 
        "volcanoClass": {
            "text": "種別", 
            "value": "第四紀(旧定義)"
        }, 
        "volcanoType": {
            "text": "形式・構造", 
            "value": "成層火山"
        }
    }, 
    "child": [
        {
            "type": "data",
            "category": "volcano", 
            "title": "火山詳細", 
            "name": "那須岳", 
            "description": {
                "type": "html", 
                "uri": "https://gbank.gsj.jp/volcano/Quat_Vol/volcano_data/D70.html"
            }, 
            "properties": {
                "data_id": {
                    "text": "ID", 
                    "value": 174
                }, 
                "reference": {
                    "type": "json", 
                    "title": "日本の火山(第3版)", 
                    "uri": "https://gbank.gsj.jp/quatigneous/api/ref/1"
                }
            }
        }, 
        {
            "type": "data",
            "category": "volcano", 
            "title": "火山詳細", 
            "name": "那須岳", 
            "description": {
                "type": "html", 
                "uri": "https://gbank.gsj.jp/volcano/cgi-bin/volcanic.cgi?id=037"
            }, 
            "properties": {
                "data_id": {
                    "text": "ID", 
                    "value": 497
                }, 
                "reference": {
                    "type": "json", 
                    "title": "1万年噴火イベントデータ集", 
                    "uri": "https://gbank.gsj.jp/quatigneous/api/ref/3"
                }
            }
        }, 
        {
            "type": "data",
            "category": "observatory_target", 
            "title": "観測機器", 
            "name": "那須岳", 
            "description": {
                "type": "json", 
                "uri": "https://gbank.gsj.jp/quatigneous/api/observatory/volcano/39"
            }, 
            "properties": {
                "data_id": {
                    "text": "ID", 
                    "value": 39
                }
            }, 
            "reference": {
                "type": "text",
                "text": "気象庁(2013)日本活火山総覧(第4版)", 
                "title": "日本活火山総覧"
            }
        }
    ] 
}