본문 바로가기

산불위험지수 - 산불위험지수 - OpenAPI 서비스명세

관련문의 | 산불산사태연구과 권춘근, 02-961-2685

사용설명

산불위험지수 (시도,시군구,읍면동)

요청 URL(request url)

http://know.nifos.go.kr/openapi/forestPoint/forestPointListSearch.do?요청변수=값

요청 변수(request parameter)

요청 변수
No 요청변수 설명
1 keyValue String(필수) 발급된 인증키
2 version String(필수) OpenAPI 버전 (현재 1.1)
3 gubun String 조회구분
조회구분
jeongug : 전국
sido : 시도
sigungu : 시군구
emd : 읍면동
4 localArea String 검색하려는 지역코드
검색하려는 지역코드
sido : 시도 정보 2자리
sigungu : 시군구 정보 5자리
emd : 시군구읍면동 정보 8자리
검색하려는 지역코드, 중복선택 가능
검색하려는 지역코드
11 서울특별시
26 부산광역시
27 대구광역시
28 인천광역시
29 광주광역시
30 대전광역시
31 울산광역시
36 세종특별자치시
41 경기도
42 강원도
43 충청북도
44 충청남도
45 전라북도
46 전라남도
47 경상북도
48 경상남도
50 제주특별자치도
※ 지역코드 다운로드
5 excludeForecast String 출력결과에서 예보정보를 제외할지 여부
출력결과에서 예보정보를 제외할지 여부
1 : 제외
0 : 포함

샘플 URL

산악기상 정보 검색:
http://know.nifos.go.kr/openapi/forestPoint/forestPointListSearch.do?localArea=&gubun=jeongug&keyValue=발급된_인증키정보&version=1.1&excludeForecast=1
※ URL(한글)은 반드시 인코딩해야 함

출력결과 필드(response field)

출력결과 필드 (response field)
No 항목 Xpath 설명
1 /metadata/resultSummary/totalCnt 결과건수
2 /metadata/inputData/keyValue 인증키 (Parameter)
3 /metadata/inputData/version 버젼 (Parameter)
4 /metadata/inputData/localarea 지역코드 (Parameter)
5 /metadata/inputData/gubun 조회구분 (Parameter)
6 /metadata/outputData/items/regioncode 산불위험최상위 지역코드
7 /metadata/outputData/items/doname 산불위험지역 시도 명칭
8 /metadata/outputData/items/sigun 산불위험지역 시군구 명칭
9 /metadata/outputData/items/gungu 산불위험지역 시군구 명칭
(조회구분 읍면동 선택 시)
10 /metadata/outputData/items/emd 산불위험지역 읍면동 명칭
11 /metadata/outputData/items/area 면적
12 /metadata/outputData/items/std 산불위험예보지수 표준편차
13 /metadata/outputData/items/maxi 산불위험예보지수 최댓값
14 /metadata/outputData/items/meanavg 산불위험예보지수 평균
15 /metadata/outputData/items/mini 산불위험예보지수 최솟값
16 /metadata/outputData/items/analdate 데이터기준일자
17 /metadata/outputData/items/d1 산불위험예보지수 낮음
18 /metadata/outputData/items/d2 산불위험예보지수 다소높음
19 /metadata/outputData/items/d3 산불위험예보지수 높음
20 /metadata/outputData/items/d4 산불위험예보지수 매우높음

출력 결과 XML

<MetaData>
<resultSummary>
<totalCnt>1</totalCnt>
<inputData>
<keyValue>인증키 신청을 통해 발급받은 인증키 번호</keyValue>
<version>1.1</version>
<localarea>11</localarea>
<gubun>sido</gubun>
</inputData>
<outputData>
<items doname="서울특별시" regioncode="11">
<area>60,571<area>
<analdate>2016/04/26/12<analdate>
<mini>68<mini>
<maxi>90<maxi>
<meanavg>77.3<meanavg>
<std>4.4<std>
<d1>0<d1>
<d2>0<d2>
<d3>94<d3>
<d4>6<d4>
</items>
</outputData>
</MetaData>