지진/화산

국내·외에서 발생한 지진의 위치, 규모, 진도, 발생시각 등의 데이터와 화산의 분화시각, 위치, 분연주높이 등의 데이터를 제공합니다.

api 상세
개요

지진정보는 국내에서 규모 2.0 이상인 지진이 발생한 경우 발표한 자료입니다.
국외지진정보는 구역 내 지역에서 규모 5.0 이상, 해역에 5.5 이상일 경우와 구역 외 지역에서 규모 6.0 이상, 해역에서 7.0 이상의 지진이 발생했을 경우 발표한 자료입니다.

요 소

(국내)발생시각, 발생위치, 규모, 발생깊이, 계기진도
(국외)발생시각, 발생위치, 규모, 발생깊이

지 점

(국내)국내에서 발생한 지진
(국외)구역내(북위 21°~45°, 동경 110°~145°) 및 그 외 국외지진

보유기간

2001년 3월 ~ 현재

생산주기

지진 발생시

1. 지진정보(최근의 지진정보) 조회

호출URL정보

https://apihub.kma.go.kr/api/typ01/url/eqk_now.php?tm=201311231215&disp=0&help=1&authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 의미 설명

tm

기준시간

기준시간에서 과거 가장 가까운 지진 (없으면 최근 10일이내)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합
2 : 구분자(|)로 구분

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

TP

3(국내지진통보), 2(국외지진정보)

TM_FC

발표사간

SEQ

발표일련번호

TM_EQK

진앙시(년월일시분초)

MSC

진앙시(초 미만)

MT

규모

LAT

진앙 위도 (deg.)

LON

진앙 경도 (deg.)

LOC

진앙 위치

INT

진도

REM

참고사항

COR

수정사항

2. 지진목록(임의기간의 지진정보) 조회

호출URL정보

https://apihub.kma.go.kr/api/typ01/url/eqk_list.php?tm1=201211231215&tm2=201311231215&disp=0&help=1&authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 의미 설명

tm1

시작시간

기간의 시작(년월일시분)

tm2

종료시간

기간의 끝(년월일시분)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

TP

3(국내지진통보), 2(국외지진정보)

TM_FC

발표사간

SEQ

발표일련번호

TM_EQK

진앙시(년월일시분초)

MSC

진앙시(초 미만)

MT

규모

LAT

진앙 위도 (deg.)

LON

진앙 경도 (deg.)

LOC

진앙 위치

INT

진도

REM

참고사항

COR

수정사항

3. 지진통보문 조회

호출URL정보

지진통보문 목록조회

https://apihub.kma.go.kr/api/typ02/openApi/EqkInfoService/getEqkMsgList?pageNo=1&numOfRows=10&dataType=XML&fromTmFc=20171101&toTmFc=20171129&authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

fromTmFc

발표시각(From)

시간(년월일)

toTmFc

발표시각(To)

시간(년월일)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

value

발표

code

발표종류코드

호출URL정보

지진통보문조회

https://apihub.kma.go.kr/api/typ02/openApi/EqkInfoService/getEqkMsg?pageNo=1&numOfRows=10&dataType=XML&fromTmFc=20171101&toTmFc=20171129&authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

fromTmFc

발표시각(From)

시간(년월일)

toTmFc

발표시각(To)

시간(년월일)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stnId

지점코드

fcTp

통보종류

img

지도 이미지

tmFc

발표시각

tmSeq

발표 일련번호

cnt

참조번호

tmEqk

진앙시(년월일시분초)

tmMsc

진앙시(초 미만)

lat

위도(deg.)

lon

경도(deg.)

loc

진앙 위치

mt

규모

inT

진도

dep

깊이

rem

참고사항

cor

수정사항

4. 국내·외 지진정보 조회

호출URL정보

최근 발표 정보·속보(마지막 발표된 지진정보)

https://apihub.kma.go.kr/api/typ09/url/eqk/urlNewNotiEqk.do?orderTy=xml&orderCm=L&authKey=hrQs0zeMSfq0LNM3jLn6RA

기간별 조건별 조회

https://apihub.kma.go.kr/api/typ09/url/eqk/urlNewNotiEqk.do?orderTy=xml&frDate=20190101&laDate=20211019&msgCode=102,212&cntDiv=Y&arDiv=A&eqArCd=A14&nkDiv=N&authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 의미 설명

frDate

시작시간

검색 시작시간 : 연월일+시(yyyymmdd+hh)(입력예: &frDate=20191001 또는 &frDate=2019100123)

laDate

종료시간

검색 종료시간 : 연월일+시(yyyymmdd+hh)(입력예: &laDate=20191002 또는 &laDate=2019100223)

msgCode

지진종류

전체 : 미입력, 111 : 지진조기경보, 212 : 지진속보, 102 : 지진정보, 103 : 지진정보(재통보), 104 : 국외지진정보,
213 : 국외지진조기경보(시범)(입력예: &msgCode=111,212)

cntDiv

국내여부

전체 : 미입력, Y : "국내", N : "국외" (입력예 : &cntDiv=Y)

arDiv

지역구분

전체 : 미입력, A : "지역", S : "해역" (입력예 : &arDiv=A)

eqArCd

지역상세

전체 : 미입력, A02 : 서울, A03 : 부산, A04 : 인천, A05 : 대전, A06 : 대구, A07 : 광주, A08 : 울산, A09 : 경기,
A10 : 강원, A11 : 충남, A12 : 충북, A13 : 경남, A14 : 경북, A15 : 전남, A16 : 전북
A17 : 제주, A18 : 세종, A99 : 기타, S02 : 동해, S04 : 서해, S03 : 남해, S99 : 기타해역 (입력예 : &eqArCd=A09)

nkDiv

북한여부

전체 : 미입력, Y : "북한", N : "북한아님" (입력예 : &nkDiv=N)

orderTy

데이터 타입

xml, xls(다운로드)

authKey

인증키

발급된 API 인증키

5. 경주, 포항 지진 조회

호출URL정보

경주지역 지진정보

https://apihub.kma.go.kr/api/typ09/url/eqk/urlSecEqkList.do?orderTy=xml&mTeqId=2016000291&frDate=20160912&laDate=20211020&afDiv=F,A&frMagMl=0&laMagMl=8&type=raw&authKey=hrQs0zeMSfq0LNM3jLn6RA

포항지역 지진정보

https://apihub.kma.go.kr/api/typ09/url/eqk/urlSecEqkList.do?orderTy=xml&mTeqId=2017000407&frDate=20171115&laDate=20211020&afDiv=F,A&frMagMl=0&laMagMl=8&type=raw&authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 의미 설명

frDate

시작시간

검색 시작시간 : YYYYMMDD(입력예: &frDate=20160912)

laDate

종료시간

검색 종료시간 : YYYYMMDD(입력예: &laDate=20191030)

afDiv

여진구분

전체 : 미입력, F : 전진, A : 여진, I : 유발 (입력예 : &afDiv=F,A)

frMagMl

규모범위(이상)

검색 규모 범위(최소값 ML) : 0 이상 (입력예: &frMagMl=0)

laMagMl

규모범위(이하)

검색 규모 범위(최대값 ML) : 9.9이하 (입력예: &laMagMl=8)

type

표기구분

raw : DB에 있는 값 그대로 산출 (입력예: &type=raw)
noti : 규모 소수점1자리/위경도 소수점2자리/깊이 정수로 산출 (입력예: 미입력 또는 &type=noti)

orderTy

데이터 타입

xml, xls(다운로드)

authKey

인증키

발급된 API 인증키