Skip to main content

GD Earthquake Event

リクエスト#

GET https://api.dmdata.jp/v2/gd/earthquake/:eventId

地震情報のリスト。

URLパラメータ#

パラメータ名デフォルト説明
:eventIdstring
地震情報のEventIDを指定

APIに必要な権限#

  • gd.earthquake

APIの情報#

このAPIでは、震度速報、震源に関する情報、震源・震度に関する情報、遠地地震に関する情報、顕著な地震の震源要素更新のお知らせの電文を統合して提供しています。

テスト電文はこのAPIでは扱いません。

また、対象となるEventIDの地震情報の電文一覧では、JSON化データの情報を返答します。


レスポンス#

APIは常にJSONを返答します。

status: ok#

成功時に次のような内容を返答します。

{
"responseId": "3750ccf70651e928",
"responseTime": "2021-04-01T00:00:00.000Z",
"status": "ok",
"event": {
"id": 1584,
"eventId": "20210808085414",
"originTime": "2021-08-08T08:54:00+09:00",
"arrivalTime": "2021-08-08T08:54:00+09:00",
"hypocenter": {
"code": "787",
"name": "鹿児島湾",
"coordinate": {
"latitude": {
"text": "31.3˚N",
"value": "31.3000"
},
"longitude": {
"text": "130.6˚E",
"value": "130.6000"
},
"height": {
"type": "高さ",
"unit": "m",
"value": "0"
},
"geodeticSystem": "日本測地系"
},
"depth": {
"type": "深さ",
"unit": "km",
"value": "0",
"condition": "ごく浅い"
}
},
"magnitude": {
"type": "マグニチュード",
"unit": "Mj",
"value": "2.6"
},
"maxInt": "2",
"telegrams": [
{
"serial": 0,
"id": "...",
"classification": "telegram.earthquake",
"head": {
"type": "VXSE53",
"author": "RJTD",
"time": "2021-08-07T23:58:00.000Z",
"designation": null,
"test": false
},
"receivedTime": "2021-08-07T23:58:10.311Z",
"xmlReport": {
"head": {
"title": "震源・震度情報",
"serial": "1",
"eventId": "20210808085414",
"headline": " 8日08時54分ころ、地震がありました。",
"infoKind": "地震情報",
"infoType": "発表",
"reportDateTime": "2021-08-08T08:58:00+09:00",
"targetDateTime": "2021-08-08T08:58:00+09:00",
"infoKindVersion": "1.0_1"
},
"control": {
"title": "震源・震度に関する情報",
"status": "通常",
"dateTime": "2021-08-07T23:58:08Z",
"editorialOffice": "気象庁本庁",
"publishingOffice": "気象庁"
}
},
"schema": {
"type": "earthquake-information",
"version": "1.0.0"
},
"format": "json",
"url": "https://data.api.dmdata.jp/v1/..."
}
]
}
}
フィールド出現説明
responseIdいつもString
API処理ID
responseTimeいつもISO8601Time
API処理時刻
statusいつもString
成功時は "ok"、失敗時(エラー)は "error"
eventいつもObject
地震情報の要素と電文情報
event.idいつもInteger
ID
event.eventIdいつもString
地震情報のEventID
event.originTime震度速報のみの場合は出現しないISO8601Time
地震発生時刻
event.arrivalTimeいつもISO8601Time
地震検知時刻
event.hypocenter震度速報のみの場合は出現しないObject
震源要素 Earthquake component / Hypocenterを参照
event.magnitude震度速報のみの場合は出現しないObject
マグニチュード要素 Earthquake component / Magnitudeを参照
event.maxIntいつもString|Null
最大震度、観測した震度がない場合はNullとする
event.telegramsいつもArray<Object>
地震情報の電文リスト
event.telegrams[].serialいつもInteger
電文受信通番
event.telegrams[].idいつもString
配信データを区別するユニーク384bitハッシュ
event.telegrams[].classificationいつもString
配信区分により変化。取りうる値は telegram.earthquake
event.telegrams[].headいつもObject
ヘッダ情報
event.telegrams[].head.typeいつもString
データ種類コード
event.telegrams[].head.authorいつもString
発表英字官署名
event.telegrams[].head.timeいつもISO8601Time
基点時刻
event.telegrams[].head.designationいつもString|Null
指示コード
event.telegrams[].head.testいつもBoolean
訓練、試験等のテスト等電文かどうかを示す
このAPIでは常にfalse
event.telegrams[].receivedTimeいつもISO8601Time
受信時刻
event.telegrams[].xmlReportいつもObject
XML電文Control,Head情報
event.telegrams[].schemaいつもObject
加工データのスキーマ情報
event.telegrams[].schema.typeいつもString
スキーマ名
event.telegrams[].schema.versionいつもString
スキーマのバージョン
event.telegrams[].formatいつもString|Null
bodyフィールドの表現形式を示す。"xml"、"a/n"、"binary"は気象庁が定めたフォーマット、"json"は本サービスが独自に定めたフォーマット
event.telegrams[].urlいつもString
電文本文URL

status: error#

APIは各種エラーを次の通り返答します。

{
"responseId": "66d23c0cede77d82",
"responseTime": "2021-04-01T00:00:00.000Z",
"status": "error",
"error": {
"message": "...",
"code": 400
}
}
フィールド出現説明
errorいつもObject
エラー情報。
error.messageいつもString
エラーメッセージ、標準エラーおよび別表参照。
error.codeいつもInteger
HTTPステータスコード。

標準エラーを出力します。