GD Eew List

リクエスト

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

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

クエリパラメータ

パラメータ名	必須	デフォルト	説明
datetime	いいえ		String 最終報発表日時による絞り込みを行う。形式は、`2021-05-01T00:00:00~2021-06-01T00:00:00` のようにし、`~`で日付の範囲を区切る左辺を開始日時とし、右辺を終了日時（その時刻を含まない）検索の対象は受信時刻となり、左辺または右辺どちらかがなくてもよい
limit	いいえ	20	Integer 返す情報数を指定する。最大は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": "Ｍ不明"
        }
      },
      "intensity": {
        "forecastMaxInt": {
          "from": "5-",
          "to": "over"
        }
      },
      "text": "１日１７時０９分０４秒頃千葉県富津市付近　　　　　最大震度５弱程度以上と推定"
    }
  ],
  "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ステータスコード。

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

リクエスト​

クエリパラメータ​

APIに必要な権限​

APIの情報​

レスポンス​

status: ok​

status: error​