概要
このAPIは強震モニタを元にしたリアルタイムデータ取得APIです。各エンドポイントが返すデータ内の intensity フィールドは、震度の文字表記です。
推定震度(estimatedIntensity)について
レスポンスの estimatedIntensity フィールドは、内部の震度表示用の値です。
マップ表示はこの値を使って色分けされています。
推定震度とRAW値の対応表
| estimatedIntensity | rawRange | 震度相当 |
|---|---|---|
| 7.0 | 6.5以上 | 震度7相当 |
| 6.5 | 6.0以上6.5未満 | 震度6強相当 |
| 6.0 | 5.5以上6.0未満 | 震度6弱相当 |
| 5.5 | 5.0以上5.5未満 | 震度5強相当 |
| 5.0 | 4.5以上5.0未満 | 震度5弱相当 |
| 4.5 | 4.0以上4.5未満 | 震度4相当 |
| 4.0 | 3.5以上4.0未満 | 震度4相当 |
| 3.5 | 3.0以上3.5未満 | 震度3相当 |
| 3.0 | 2.5以上3.0未満 | 震度3相当 |
| 2.5 | 2.0以上2.5未満 | 震度2相当 |
| 2.0 | 1.5以上2.0未満 | 震度2相当 |
| 1.5 | 1.0以上1.5未満 | 震度1相当 |
| 1.0 | 0.5以上1.0未満 | 震度1相当 |
| 0.5 | 0.0以上0.5未満 | 震度0相当 |
| 0.0 | -0.5以上0.0未満 | 震度0相当 |
| -0.5 | -1.0以上-0.5未満 | −0.5以下 |
| -1.0 | -1.5以上-1.0未満 | −0.5以下 |
| -1.5 | -2.0以上-1.5未満 | −0.5以下 |
| -2.0 | -2.5以上-2.0未満 | −0.5以下 |
| -2.5 | -3.0以上-2.5未満 | −0.5以下 |
| -3.0 | -3.5以上-3.0未満 | −0.5以下 |
| null | 欠損 | データなし |
エンドポイント一覧
GET /stations
全ての観測点の現在の震度データを取得します。マップ表示で使用されているエンドポイントです。
レスポンス
{
"dataTime": 1739804400000,
"count": 2200,
"stations": [
{
"index": 0,
"lat": 35.68,
"lon": 139.76,
"intensity": "j",
"estimatedIntensity": 0.0,
"rawRange": "-0.5以上0.0未満"
},
{
"index": 1,
"lat": 35.72,
"lon": 139.82,
"intensity": "k",
"estimatedIntensity": 0.5,
"rawRange": "0.0以上0.5未満"
}
]
}
GET /nearest
指定した座標に最も近い観測点の震度データを取得します。
クエリパラメータ
| 名前 | 説明 | 必須 |
|---|---|---|
lat | 緯度(度、10進数) | はい |
lon | 経度(度、10進数) | はい |
リクエスト例
GET /nearest?lat=35.68&lon=139.76
レスポンス
{
"dataTime": 1739804400000,
"query": { "lat": 35.68, "lon": 139.76 },
"nearest": {
"index": 42,
"lat": 35.681,
"lon": 139.762,
"intensity": "j",
"estimatedIntensity": 0.0,
"rawRange": "-0.5以上0.0未満",
"distanceMeters": 120
}
}
エラーレスポンス
エラーが発生した場合は、HTTPステータスコードとエラーメッセージを含んだJSONが返ります。
{
"error": "Query params `lat` and `lon` are required and must be numbers."
}