서비스 개요
TourAPI 소개
한국관광공사는 국가정보자원의 개방 및 공유 정책에 부흥하여 아래와 같은 OpenAPI 서비스를 제공합니다.
- 약 7만여 건의 다국어 관광정보 제공 (국문, 영문, 일문, 중문간체, 중문번체, 독일어, 불어, 스페인어, 러시아어)
- 약 1만 4천여건의 관광용어 외국어 용례표기사전 정보제공
- 한국관광공사 포털 사이트인 VisitKorea(www.visitkorea.or.kr)와 동일한 최신의 관광정보 제공
- 앱, 웹서비스 대상의 Application을 개발할 수 있도록 제공 (XML, Json 응답지원)
TourAPI 제공 서비스
TourAPI에서 제공하는 서비스 내용은 아래와 같습니다.

TourAPI 제공 서비스
국문, 영문, 일문, 중문간체, 중문번체, 독일어, 불어, 스페인어, 러시아어 관광정보/ 무장애여행정보
- 지역코드 : 지역코드, 시군구코드 제공
- 분류코드 : 숙박>숙박시설>관광호텔 등의 분류코드 제공
- 지역기반 관광정보 : 각 지역을 기반으로 관광정보 제공
- 위치기반관광정보 : GPS 좌표 기반의 내 주변 중심의 관광정보 제공
- 통합검색 : 키워드를 통한 검색 서비스 제공
- (행사)날짜검색 : 날짜 기준의 행사공연 축제 정보 제공
- (숙박)특화검색 : 숙박 타입에서 베니키아, 한옥, 굿스테이 정보 제공
- (무장애여행정보)무장애여행 상세정보 : 점자블록, 휠체어, 장애인 화장실 등 정보 제공
- 상세1-공통정보 : 주소, 전화, 좌표, 개요 등의 공통적 정보를 제공
- 상세2-공통정보 : 휴무일, 안내정보 등 각 관광 타입의 고유정보 제공
- 상세3-반복정보 : 1:N 반복 구조의 각 관광타입의 고유정보 제공
- 상세4-이미지 : 1:N 반복 구조의 이미지 정보 제공
- 관광용어 외국어 용례사전
- 사전코드 : 외국어 용례사전 코드(분류) 제공
- 사전정보 : 사전 리스트 및 사전 정보 제공
- 생태관광정보
- 지역코드 : 지역코드, 시군구코드 제공
- 지역기반 정보 : 각 지역을 기반으로 생태관광정보 제공
- 관광사진갤러리
- 목록조회 : 관광사진 갤러리 목록 제공
- 키워드 검색 : 키워드를 통한 검색 서비스 제공
- 상세 목록 조회 : 관광사진 상세정보 목록 제공
관광정보 표출 방법
제공되는 각 API를 활용하여 관광정보 목록 및 상세정보 화면을 기획/개발하는 흐름을 설명합니다.
※ 관광정보 API 활용 가이드 : http://api.visitkorea.or.kr/guide/inforArea.do
지역기반 관광정보 서비스
아래 그림은 지역기반의 관광정보 목록을 서비스 하기 위해 API 활용 및 파라미터 전달하는 방법을 표현합니다.
[선택]적인 API 조회를 통해 다양하게 조합하여 목록을 표현할 수 있습니다.

-
지역코드 조회
- (필수) 지역코드 조회를 통해 지역명을 화면에 표현
- 지역코드 전달
- (선택) 지역코드 조회를 통해 시군구명을 화면에 표현
- 지역코드와 시군구코드 전달
-
관광타입 선택
- (선택) 타입 코드표 활용
- 지역코드와 관광타입 전달
-
서비스 분류코드 조회 (대>중>소분류)
- (선택) 서비스를 활용하여 소분류 중심의 “국립공원”, “수목원” 등의 분류별 단위 서비스도 가능합니다. 관광타입에 따라, 분류코드, 코드명이 변하기 때문에 관광타입을 필수 값으로 요청하셔야 합니다.
-
지역기반 관광정보 조회
- 제목순, 수정일(최신순), 등록순, 인기순으로 목록 정렬을 제공합니다.
※ 파라미터의 조합에 따라 아래와 같이 표현이 가능합니다.
- 지역별 관광정보 : 지역정보(필수) > 타입정보(선택) > 분류정보(선택) > 관광정보 목록
- 타입별관광정보 : 타입정보(필수) > 지역정보(선택) > 분류정보(선택) > 관광정보 목록
- 분류별관광정보 : 타입정보(필수) > 분류정보(선택) > 지역정보(선택) > 관광정보 목록
- 통합(키워드) 검색 : 지역정보(선택) > 타입정보(선택) > 분류정보(선택) > 검색된 정보 목록
- 내주변관광정보 : 타입정보(선택) > 관광정보 목록
- 날짜별행사축제 : 지역정보(선택) > 행사공연축제 목록
- 베니키아, 한옥, 굿스테이숙박 검색 : 지역정보(선택) > 각 숙박 정보 목록
상세정보 화면

- 관광정보 목록
- 공통정보 조회 - 대표이미지, 주소, 좌표, 전화, 개요정보 등을 제공합니다.
- 소개정보/반복정보 조회 - 각 관광타입의 휴무일, 안내정보 등의 소개정보를 제공합니다. 1:N 구조의 반복적인 상세 정보를 제공합니다.
- 이미지정보 조회 - 1:N 구조의 반복적인 이미지정보를 원본 및 썸네일 형식으로 제공합니다.
관광용어 외국어 용례사전 표출 방법
외국어 용례사전 분류 조회
아래 그림은 외국어 용례사전 분류 조회를 서비스 하기 위해 API 활용 및 파라미터 전달하는 방법을 표현합니다.

- 관광지(A) 선택
- 자연관광(A01)선택
- 설명
- Dapth=1은대분류, Dapth=2는중분류, Dapth=3은소분류입니다. 대분류에서 관광지(A)를 선택하고 중분류에서 자연관광(A01)을 선택하게 되면 소분류에 대한 결과값이 조회가 됩니다.
- URL예시
-
- 1. http://api.visitkorea.or.kr/openapi/service/rest/TransService/transCode?_type=xml&MobileOS=AND&MobileApp=어플리케이션명 &pageNo=1&numOfRows=10&ServiceKey=ServiceKey&depth=1
- 2. http://api.visitkorea.or.kr/openapi/service/rest/TransService/transCode?_type=xml&MobileOS=AND&MobileApp=어플리케이션명 &pageNo=1&numOfRows=10&ServiceKey=ServiceKey&depth=2&code=A
- 3. http://api.visitkorea.or.kr/openapi/service/rest/TransService/transCode?_type=xml&MobileOS=AND&MobileApp=어플리케이션명 &pageNo=1&numOfRows=10&ServiceKey=ServiceKey&depth=3&code=A01
외국어 용례사전 목록 조회
아래 그림은 외국어 용례사전 목록 조회를 서비스 하기 위해 API 활용 및 파라미터 전달하는 방법을 표현합니다.

- 위 xml 그룹으로 여러 개의 목록 노출
- 가산으로 검색
- 설명
- 검색의 기본값은 KOR이고 검색하고자 하는 언어에 따라 KOR, ENG, JPN, CHS, CHT로 선택 할 수 있습니다. 검색값을 넣지 않을 경우 전체 목록이 노출되며 검색 값을 호출할 경우 검색 값과 일치하는 항목의 결과값이 검색 됩니다.
- URL예시
-
- 1. http://api.visitkorea.or.kr/openapi/service/rest/TransService/transWord?_type=xml&MobileOS=AND&MobileApp=어플리케이션명 &pageNo=1&numOfRows=10&ServiceKey=ServiceKey&langSe=KOR (조회가능 언어:KOR, ENG, JPN, CHS, CHT)
- 2. http://api.visitkorea.or.kr/openapi/service/rest/TransService/transWord?_type=xml&MobileOS=AND&MobileApp=어플리케이션명 &pageNo=1&numOfRows=10&ServiceKey=ServiceKey&langSe=KOR&word=가산&cat1=A&cat2=A01&cat3=A01001
서비스 호출방법
인증키 활용 및 API 호출 방법
- 개발계정은 일 1,000건의 트래픽을 제공합니다.
- 개발계정은 자동승인으로 활용 신청 후, 약 30분 이후에 사용이 가능합니다.
(공공데이터포털과 한국관광공사 동기화)
REST방식의 URL 요청 예시
응답 표준은 XML 이며, JSON을 요청할 경우“&_type=json”을 추가하여 요청합니다.
- Json요청 : http://api.visitkorea.or.kr/openapi/service/rest/KorService/areaCode?ServiceKey=ServiceKey&numOfRows=10&pageNo=1&MobileOS=ETC&MobileApp=TestApp&_type=json
서비스키(인증키) 인코딩 방법
- 2015년 1월 이전에 공공데이터포털에서 받은 인증키 경우,
String myKey = “발급받은 인증키”;
String ServiceKey = URLEncoder.encode(myKey, "UTF-8");
(TourAPI의 모든 Character Set은 UTF-8 설정)
- 2015년 1월 이후에 공공데이터포털에서 받은 인증키 경우, 인코딩 불필요
요청 파라미터에서 서비스명 기재
-
MobileApp파라미터는 서비스(웹,앱 등)별로 활용 통계를 산출하기 위한 항목입니다.
URL요청 시 반드시 기재 부탁드립니다.
- //====== 파라미터인코딩 예시(JSP 기준)
-
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>>
//=== 서비스명이 영문인 경우 (인코딩 불필요)
String appName = “KoreaTourismOrganization”;
//=== 서비스명이 한글(일문, 중문 등)인 경우 (인코딩 필수)
String appName = URLEncoder.encode(“한국관광공사”, "UTF-8");
http://api.visitkorea.or.kr/openapi/service/rest/KorService/areaCode?ServiceKey=ServiceKey&numOfRows=10&pageNo=1&MobileOS=AND&MobileApp=appName