맞춤형 API 상세

방방곳곳 트래킹 안내 서비스

  • URL

    http://api.kcisa.kr/openapi/service/rest/convergence2017/conver2

  • 설명

    우리나라 국토의 70%가 산으로 구성되어 있고 매년 아름다운 풍경과 자연휴양을 즐기는 사람들이 늘고 있음. 요약 운동을 목적으로 하거나 즐기기 위해 걷는 산책을 위한 장소안내 및 주요 등산로 서비스를 제공. 전국 120여개의 등산로 지도를 공간정보(지도)로 표현할 수 있도록 오픈API 형태로 제공. 등산로, 등산로시설, 둘레길링크, 산책로분기점, 자전거길노드, 자전거길, 자전거보관소 정보를 WMS/WFS OGC 표준 공간정보로 제공
    방방곳곳 트래킹 안내 서비스

  • 기관명

    한국문화정보원

    갱신주기

    연간

  • 서비스 분야/주체

    API유형

    REST

  • 등록일

    Dec 1, 2017

    활용도

    3,529

오픈 API

요청인자

요청인자 상세표
변수명 타입 변수설명 필수여부
serviceKey string 서비스키 true
numOfRows string 세션당 요청레코드수 false
pageNo string 페이지수 false
keyword string 검색어 false

출력 값

출력 값 상세표
No 변수명 출력설명
1 rnum 번호
2 title 자원의 명칭
3 description 내용
4 abstractDesc 자원의 대한 요약
5 affiliation 소속
6 alternativeTitle 대체
7 charge 요금 정보
8 collectionDb 소속(통제)DB
9 contributor 기여자
10 copyrightOthers 저작권
11 coverage 내용의범위
12 createdDate 제작일
13 creator 주된 책임을 진 개체
14 digitalizedDate 디지털화 데이터
15 extent 자원의 크기나 재생시간
16 format 자원의 물리적, 디지털 구현형
17 grade 등급 정보
18 venue 장소
19 spatial 공간
20 temporal 시간적범위
21 time 시간
22 type 해당자원의 성격, 장르
23 identifier 자원의식별
24 issuedDate 발행일
25 medium 자원의물리적(물질적)상태
26 period 기간
27 person 사람
28 publisher 발행기관
29 reference 참조한자원
30 regDate 등록일
31 relation 관련자원
32 rights 자원에 대한 권리
33 source 유래자원에 대한 참조
34 subjectCategory 기관별주제분류체계
35 subjectKeyword 핵심주제어(키워드)
36 subDescription 보조 서술
37 tableOfContents 목차정보
38 uci 지식정보자원식별체계
39 url 지식정보자원위치정보
40 localarea 지역코드
41 tm10m 10m 기온 (℃)
42 hm10m 10m 습도 (%)
43 wd10m 10m 풍향
44 ws10m 10m 풍속 (m/s)
45 rn 전도식 강우량 (mm)
46 cpRn 무게식 강우량 (mm)
47 pa 기압 (hPa)
48 ts 지면온도 (℃)
49 tm2m 2m 기온 (℃)
50 hm2m 2m 습도 (%)
51 wd2m 2m 풍향
52 ws2m 2m 풍속 (m/s)
53 insertDate 자원이용일(수집일)
54 wd10mstr 10m풍향
55 wd2mstr 2m 풍향

메시지 설명

메시지 설명 상세표
0000 정상 처리
F2013 서비스 주소 호출 실패
9999 서비스 점검중(내부 서비스 호출 장애)

활용 명세

샘플 데이터

>샘플 데이터 상세

샘플코드

/* Java Sample */
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.io.BufferedReader;
import java.io.IOException;

public class openApi {
public static void main(String[] args) throws IOException {

StringBuilder urlBuilder = new StringBuilder("http://api.kcisa.kr/openapi/service/rest/convergence2017/conver2"); /*URL*/
urlBuilder.append("?" + URLEncoder.encode("serviceKey","UTF-8") + "=서비스키"); /*서비스키*/
urlBuilder.append("&" + URLEncoder.encode("numOfRows","UTF-8") + "=" + URLEncoder.encode("세션당 요청레코드수", "UTF-8")); /*세션당 요청레코드수*/
urlBuilder.append("&" + URLEncoder.encode("pageNo","UTF-8") + "=" + URLEncoder.encode("페이지수", "UTF-8")); /*페이지수*/
urlBuilder.append("&" + URLEncoder.encode("keyword","UTF-8") + "=" + URLEncoder.encode("검색어", "UTF-8")); /*검색어*/

URL url = new URL(urlBuilder.toString());
HttpURLConnection conn = (HttpURLConnection) url.openConnection();

conn.setRequestMethod("GET");
conn.setRequestProperty("Content-type", "application/json");
System.out.println("Response code: " + conn.getResponseCode());

BufferedReader rd;
if(conn.getResponseCode() >= 200 && conn.getResponseCode() <= 300) {

rd = new BufferedReader(new InputStreamReader(conn.getInputStream()));

} else {

rd = new BufferedReader(new InputStreamReader(conn.getErrorStream()));

}

StringBuilder sb = new StringBuilder();
String line;
while ((line = rd.readLine()) != null) {

sb.append(line);

}
rd.close();
conn.disconnect();
System.out.println(sb.toString());

}

}
/* Javascript Sample*/
var xhr = new XMLHttpRequest();
var url = 'http://api.kcisa.kr/openapi/service/rest/convergence2017/conver2'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + encodeURIComponent('페이지수'); /*페이지수*/
queryParams += '&' + encodeURIComponent('keyword') + '=' + encodeURIComponent('검색어'); /*검색어*/

xhr.open('GET', url + queryParams);
xhr.onreadystatechange = function () {
if (this.readyState == 4) {

console.log('status: ' + this.status);
console.log('resultCode: ' + $(this.responseText).find('resultCode').text());
console.log('resultMsg: ' + $(this.responseText).find('resultMsg').text());

var item = $(this.responseText).find('item');
$(item).each(function(){

console.log("rnum" + $(this).find("rnum").text());
console.log("title" + $(this).find("title").text());
console.log("description" + $(this).find("description").text());
console.log("abstractDesc" + $(this).find("abstractDesc").text());
console.log("affiliation" + $(this).find("affiliation").text());
console.log("alternativeTitle" + $(this).find("alternativeTitle").text());
console.log("charge" + $(this).find("charge").text());
console.log("collectionDb" + $(this).find("collectionDb").text());
console.log("contributor" + $(this).find("contributor").text());
console.log("copyrightOthers" + $(this).find("copyrightOthers").text());
console.log("coverage" + $(this).find("coverage").text());
console.log("createdDate" + $(this).find("createdDate").text());
console.log("creator" + $(this).find("creator").text());
console.log("digitalizedDate" + $(this).find("digitalizedDate").text());
console.log("extent" + $(this).find("extent").text());
console.log("format" + $(this).find("format").text());
console.log("grade" + $(this).find("grade").text());
console.log("venue" + $(this).find("venue").text());
console.log("spatial" + $(this).find("spatial").text());
console.log("temporal" + $(this).find("temporal").text());
console.log("time" + $(this).find("time").text());
console.log("type" + $(this).find("type").text());
console.log("identifier" + $(this).find("identifier").text());
console.log("issuedDate" + $(this).find("issuedDate").text());
console.log("medium" + $(this).find("medium").text());
console.log("period" + $(this).find("period").text());
console.log("person" + $(this).find("person").text());
console.log("publisher" + $(this).find("publisher").text());
console.log("reference" + $(this).find("reference").text());
console.log("regDate" + $(this).find("regDate").text());
console.log("relation" + $(this).find("relation").text());
console.log("rights" + $(this).find("rights").text());
console.log("source" + $(this).find("source").text());
console.log("subjectCategory" + $(this).find("subjectCategory").text());
console.log("subjectKeyword" + $(this).find("subjectKeyword").text());
console.log("subDescription" + $(this).find("subDescription").text());
console.log("tableOfContents" + $(this).find("tableOfContents").text());
console.log("uci" + $(this).find("uci").text());
console.log("url" + $(this).find("url").text());
console.log("localarea" + $(this).find("localarea").text());
console.log("tm10m" + $(this).find("tm10m").text());
console.log("hm10m" + $(this).find("hm10m").text());
console.log("wd10m" + $(this).find("wd10m").text());
console.log("ws10m" + $(this).find("ws10m").text());
console.log("rn" + $(this).find("rn").text());
console.log("cpRn" + $(this).find("cpRn").text());
console.log("pa" + $(this).find("pa").text());
console.log("ts" + $(this).find("ts").text());
console.log("tm2m" + $(this).find("tm2m").text());
console.log("hm2m" + $(this).find("hm2m").text());
console.log("wd2m" + $(this).find("wd2m").text());
console.log("ws2m" + $(this).find("ws2m").text());
console.log("insertDate" + $(this).find("insertDate").text());
console.log("wd10mstr" + $(this).find("wd10mstr").text());
console.log("wd2mstr" + $(this).find("wd2mstr").text());

});

};

}
xhr.send('');