맞춤형 API 상세

한국문화정보원_전국 시티투어 코스와 함께하는 맛집 정보

기본정보

URL

http://api.kcisa.kr/openapi/API_CNV_063/request
설명

공공데이터포털에서 제공 "전국시티투어정보표준데이터" 와 문화빅데이터플랫폼에서 제공하는 "국내 지역별 문화체육관광시설 인근 음식점(한식, 일식, 양식, 외국식 등)" 정보를 통합하여 제공하는 맟춤형 API 입니다.
* 전국시티투어정보표준데이터
- ⌜관광진흥법⌟에 따라 지방자치단체에서 운영하고 있는 문화유적, 관광지, 시정현장 등을 순회하며 도시의 문화와 역사 및 관광지 등을 둘러볼 수 있도록 하는 순회관광에 대한 정보
* 국내 지역별 문화체육관광시설 인근 음식점(한식, 일식, 양식, 외국식 등) 정보
- 문화향유와 함께 식사를 즐기기 편한 지역 정보, 전국 문화체육관광시설 인근 음식점의 밀집지수 및 위치, 주소, 분류코드, 건물번호 등 현황 통계 데이터
제공기관

한국문화정보원

갱신주기

연간
서비스 분류
API유형

REST
데이터 등록일

2024-03-26

호출건수

660
데이터 수정일

2024-05-03

오픈 API

요청인자

서비스키
- 변수명serviceKey
- 타입string
- 필수여부true
세션당 요청레코드수
- 변수명numOfRows
- 타입string
- 필수여부false
페이지수
- 변수명pageNo
- 타입string
- 필수여부false
시군구명(2자이상)[필수값]
- 변수명areaNm
- 타입string
- 필수여부true
식당분류명 [필수값 아님] (예) 한식, 보쌈, 치킨, 피자 등
- 변수명clNm
- 타입string
- 필수여부true

출력 값

출력 값 상세표
No	변수명	출력설명
1	title	시씨투어명
2	description	시티투어 운행정보
3	subDescription	시티투어 운행부가정보
4	reference	시티투어 문의처
5	rights	시티투어 지자체 담당부서
6	source	시티투어 홈페이지
7	spatial	시티투어 담당 시군구
8	dataStdDt	데이터기준일자
9	dataOfferInst	정보제공기관명
10	rstrNm	시티투어 주변 맛집 식당명
11	rstrBhfNm	시티투어 주변맛집식당 지점명
12	rstrAsstnNm	시티투어 주변맛집식당 보조명
13	rstrClNm	시티투어 주변맛집식당 분류명
14	rstrRoadAddr	시티투어 주변맛집식당 도로명 주소
15	rstrLnbrAddr	시티투어 주변맛집식당 지번 주소
16	rstrPnu	시티투어 주변맛집식당 지번고유코드
17	rstrLatPos	시티투어 주변맛집식당 위치정보, 위도
18	rstrLotPos	시티투어 주변맛집식당 위치정보, 경도
19	rstrGidCd	시티투어 주변맛집식당 위치정보, 격자코드
20	rstrInfoStdDt	시티투어 주변 맛집 식당 정보 업데이트 일자

메시지 설명

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/API_CNV_063/request"); /*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("areaNm","UTF-8") + "=" + URLEncoder.encode("시군구명(2자이상)[필수값]", "UTF-8")); /*시군구명(2자이상)[필수값]*/
urlBuilder.append("&" + URLEncoder.encode("clNm","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");
//json type으로 응답받고 싶을 때는 아래 주석을 제거하시고 사용바랍니다.
//conn.setRequestProperty("Accept","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/API_CNV_063/request'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + encodeURIComponent('페이지수'); /*페이지수*/
queryParams += '&' + encodeURIComponent('areaNm') + '=' + encodeURIComponent('시군구명(2자이상)[필수값]'); /*시군구명(2자이상)[필수값]*/
queryParams += '&' + encodeURIComponent('clNm') + '=' + 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("title" + $(this).find("title").text());
console.log("description" + $(this).find("description").text());
console.log("subDescription" + $(this).find("subDescription").text());
console.log("reference" + $(this).find("reference").text());
console.log("rights" + $(this).find("rights").text());
console.log("source" + $(this).find("source").text());
console.log("spatial" + $(this).find("spatial").text());
console.log("dataStdDt" + $(this).find("dataStdDt").text());
console.log("dataOfferInst" + $(this).find("dataOfferInst").text());
console.log("rstrNm" + $(this).find("rstrNm").text());
console.log("rstrBhfNm" + $(this).find("rstrBhfNm").text());
console.log("rstrAsstnNm" + $(this).find("rstrAsstnNm").text());
console.log("rstrClNm" + $(this).find("rstrClNm").text());
console.log("rstrRoadAddr" + $(this).find("rstrRoadAddr").text());
console.log("rstrLnbrAddr" + $(this).find("rstrLnbrAddr").text());
console.log("rstrPnu" + $(this).find("rstrPnu").text());
console.log("rstrLatPos" + $(this).find("rstrLatPos").text());
console.log("rstrLotPos" + $(this).find("rstrLotPos").text());
console.log("rstrGidCd" + $(this).find("rstrGidCd").text());
console.log("rstrInfoStdDt" + $(this).find("rstrInfoStdDt").text());

});

};

}
xhr.send('');

맞춤형 API 상세

한국문화정보원_전국 시티투어 코스와 함께하는 맛집 정보

기본정보

오픈 API

요청인자

출력 값

메시지 설명

활용 명세

샘플 데이터

샘플코드

연관 오픈API

한국문화정보원_전국 시티투어 코스와 함께하는 맛집 정보

한국문화정보원_전국 관광지 주변_전기차 충전소

한국문화정보원_전국 박물관 미술관_공연행사

한국문화정보원_초중고등학교 주변 도서관 정보

한국문화정보원_전통시장 주변 공영주차장 정보

한국문화정보원 외_공연정보(통합)

한국문화정보원_국립공원 주변 문화시설 POI 정보

한국문화정보원 외_공연과 함께하는 CO2 줄이기

한국문화정보원 외_역사가 있는 여행 이야기

국민체육진흥공단 외_어디서 운동할까

국립국어원 외_한국이 좋아요

제주특별자치도청 외_씽씽 자전거와 함께 하는 여행

한국문화정보원 외_가족과 함께하는 농어촌 체험일기

서울특별시청_반려 동물을 위한 지역 생활정보

한국문화예술위원회 외_길 위의 작은 가게

한국문화관광연구원 외_맑은 하늘과 함께 하는 여행

문화체육관광부 외_사서의 책장

해외문화홍보원 외_이벤트 알림이

국립중앙박물관 외_문화교육의 시작

인천문화재단 외_여행은 체험하는 것

서울문화재단 외_문화부문 채용정보

한국문화정보원_어린이를 위한 공연정보

한국문화정보원_공공미술 작품을 찾아서

한국문화정보원_소소하지만 확실한 여행

한국문화정보원_관광지 안전정보

한국문화정보원_문화기반시설 통계정보

문화체육관광부_일자리정보-일자리뉴스

문화체육관광부_일자리정보-시험정보

국립중앙박물관 외_지도로 보는 문화재 탐방

국립중앙도서관 외_도서정보조회 서비스

한국문화정보원_장애인을 위한 시설정보

국립국어원 외_외국인을 위한 우리말 배우기

한국학중앙연구원 외_한국의 향토문화

영상물등급위원회 외_무비갤러리

한국문화정보원_방방곳곳 트래킹 안내 서비스

한국정책방송원_역사기록정보

문화체육관광부_일자리정보-채용정보