Skip to main content

GD Eew List

リクエスト

GET https://api.dmdata.jp/v2/gd/eew

過去に発表された緊急地震速報のリスト。

クエリパラメータ

パラメータ名必須デフォルト説明
datetimeいいえString
最終報発表日時による絞り込みを行う。
形式は、2021-05-01T00:00:00~2021-06-01T00:00:00 のようにし、~で日付の範囲を区切る
左辺を開始日時とし、右辺を終了日時(その時刻を含まない)
検索の対象は受信時刻となり、左辺または右辺どちらかがなくてもよい
limitいいえ20Integer
返す情報数を指定する。最大は100

APIに必要な権限

  • gd.eew

APIの情報

このAPIでは、緊急地震速報の最終報を受信したのちデータが更新されますので、リアルタイム処理に用いるのではなく事後参照としてお使いください。

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


レスポンス

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

status: ok

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

{
"responseId": "3750ccf70651e928",
"responseTime": "2021-04-01T00:00:00.000Z",
"status": "ok",
"items": [
{
"id": 1,
"eventId": "20160801170904",
"serial": 2,
"dateTime": "2016-08-01T17:09:06+09:00",
"isLastInfo": true,
"isCanceled": false,
"isWarning": false,
"earthquake": {
"arrivalTime": "2016-08-01T17:09:04+09:00",
"hypocenter": {
"code": "014",
"name": "関東甲信地方",
"coordinate": {
"latitude": {
"value": "35.3000",
"text": "35.3°N"
},
"longitude": {
"value": "139.9000",
"text": "139.9°E"
},
"height": {
"type": "高さ",
"unit": "m",
"value": "-10000"
},
"geodeticSystem": "日本測地系"
},
"depth": {
"type": "深さ",
"unit": "km",
"value": "10"
},
"reduce": {
"code": "9120",
"name": "千葉県"
},
"accuracy": {
"epicenters": [
"1",
"1"
],
"depth": "1",
"magnitudeCalculation": "8",
"numberOfMagnitudeCalculation": "1"
}
},
"magnitude": {
"type": "マグニチュード",
"unit": "Mj",
"value": null,
"condition": "M不明"
}
},
"intensity": {
"forecastMaxInt": {
"from": "5-",
"to": "over"
}
},
"text": "1日17時09分04秒頃千葉県富津市付近     最大震度5弱程度以上と推定"
}
],
"nextToken": "bmV4d..."
}
フィールド出現説明
responseIdいつもString
API処理ID
responseTimeいつもISO8601Time
API処理時刻
statusいつもString
成功時は ok、失敗時(エラー)は error
itemsいつもArray<Object>
アイテムリスト
items[].idいつもInteger
受信ID
items[].eventIdいつもString
緊急地震速報のEventID
items[].serialいつもInteger
緊急地震速報のEventIDに対する報数
items[].dateTimeいつもISO6801Time
この緊急地震速報(最終報)を発表した時刻
items[].isLastInfoいつもBoolean
このEventIDに対してこの内容が最終であるかどうかを示し、このAPIでは常に true とする
items[].isCanceledいつもBoolean
このEventIDに対して緊急地震速報を取り消されたかどうかを示し、取消された場合は true とする
items[].isWarning取消時には出現しないBoolean
このEventIDに対して、緊急地震速報の警報を発表されたかどうかを示し、警報発表済みの場合は true とする
items[].earthquake取消時は出現しないObject
予測震源要素 Earthquake componentを参照
items[].intensity取消時・震度未計算時は出現しないObject
予測震度要素 Intensity componentを参照
items[].text場合によるString
フリーテキストで表現したい場合に出現し、これを記述する
nextToken場合によるString
次のリソースがある場合に出現。詳しくはこちら

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ステータスコード。

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