장소(POI) 통합 검색

API 서비스의 지원 오퍼레이션 버전을 지정합니다. 현재 버전 1을 지원하며, 버전에 따라 응답 결과로 표출되는 내용이 다를 수 있습니다.

시설물명, 상호, 시설 유형, 주소, 전화번호를 검색어로 지정합니다. 장소 통합 검색 API는 지정한 검색어와 일치하는 항목을 결과로 제공합니다.<br>- 명칭 검색 시 UTF-8 기반의 URL 인코딩 처리 필수<br>- 전화번호는 지역번호, 통신 식별자(01X)를 포함 필수<br>- 지역번호, 국번, 개별 번호 사이에는 하이픈(-) 또는 공백을 넣거나 숫자만 입력 가능<br><br>예)<br>- 시설물명: 'SK T 타워'인 경우 searchKeyword=SK%20T%20%ED%83%80%EC%9B%8C<br>- 상호: 'SK텔레콤'인 경우 searchKeyword=SK%ED%85%94%EB%A0%88%EC%BD%A4<br>- 시설 유형: '음식점'인 경우 searchKeyword=%EC%9D%8C%EC%8B%9D%EC%A0%90<br>- 주소: '서울 중구 을지로 65' 경우 searchKeyword=%EC%84%9C%EC%9A%B8%20%EC%A4%91%EA%B5%AC%20%EC%9D%84%EC%A7%80%EB%A1%9C%2065<br>- 전화번호: '02-6100-2114'인 경우 searchKeyword=02-6100-2114, '02 6100 2114'인 경우 searchKeyword=02%206100%202114, '0261002114'인 경우 searchKeyword=0261002114

장소 통합 검색 API는 all(통합), name(명칭), telno(전화번호)로 총 3가지 검색 유형을 지원합니다.<br><br>all(통합)(기본값)<br>- 시설물명, 상호, 시설 유형, 주소, 전화번호를 검색어(searchKeyword)로 모두 사용<br>- 명칭 또는 전화번호로 검색 유형을 반드시 특정해야 하는 경우가 아니라면 이 유형을 사용 권장<br><br>name(명칭)<br>- 시설물명, 상호, 시설 유형, 주소를 검색어로 사용<br>- '서울 중구'와 같이 지역을 특정하여 검색<br>- 이 유형을 사용하는 경우 법정동 코드(areaLLCode, areaLMCode) 적용 필수<br><br>telno(전화번호)<br>- 전화번호를 검색어로 사용<br><br>검색 유형 중 명칭(searchType=name)을 사용하는 경우에는 areaLLCode(지역 대분류 코드)와 areaLMCode(지역중분류코드)를 반드시 적용해야 합니다. 법정동 코드는 행정 표준 코드 관리 시스템의 법정동 코드 목록 조회를 통해 확인할 수 있으며, 또한 지역 분류 코드 검색 API를 이용해 조회할 수 있습니다.

지역 대분류 코드를 지정합니다.(시/구/군의 '시'에 해당)<br>- 법정동 코드의 맨 앞 두 자릿수<br><br>예) areaLLCode=11<br>- '서울특별시 종로구 청운동'의 법정동 코드 '1111010100'에서 대분류 '서울특별시'의 코드는 11

지역 중분류 코드를 지정합니다.(시/구/군의 '구' 또는 '군'에 해당)<br>- 법정동 코드의 앞 3번째부터 5번째까지의 세 자릿수<br><br>예) areaLMCode=110<br>- '서울특별시 종로구 청운동'의 법정동 코드 '1111010100'에서 중분류 '종로구'의 코드는 110

검색 결과 정렬 순서를 정확도순 또는 거리순으로 지정합니다. <br><br>A(기본값)<br>- 정확도순<br><br>R<br>- 거리순<br><br>검색 결과 정렬 순서를 거리순(searchtypCd=R)으로 적용하는 경우에는 radius(검색 반경), centerLon(중심 경도), centerLat(중심 위도)를 반드시 설정해야 합니다.

반경 검색에서 사용하는 중심 경도를 지정합니다.<br><br>예) centerLon=126.98502043

반경 검색에서 사용하는 중심 위도(centerLat)를 지정합니다.<br><br>예) centerLat=37.56648210

요청 좌표계를 지정할 수 있으며, 3가지 좌표계를 지원합니다.<br><br>WGS84GEO<br>-WGS84 경위도 좌표계<br><br>EPSG3857<br>- 구글 메카토르(Google Mercator)<br><br>KATECH<br>- TM128(Transverse Mercator, 횡메카토르), 한국 표준<br><br>예) WGS84 경위도 좌표계를 설정하는 경우: reqCoordType=WGS84GEO

응답 좌표계를 지정할 수 있으며, 3가지 좌표계를 지원합니다.<br><br>WGS84GEO<br>-WGS84 경위도 좌표계<br><br>EPSG3857<br>- 구글 메카토르(Google Mercator)<br><br>KATECH<br>- TM128(Transverse Mercator, 횡메카토르), 한국 표준<br><br>예) WGS84 경위도 좌표계를 설정하는 경우: resCoordType=WGS84GEO

검색 반경(radius)을 지정합니다.<br>- 검색 반경: 1~33<br>- 단위: km<br>- 전국 검색 시 '0'으로 지정<br><br>예) 검색 반경 5 km 이내인 경우: radius=5

검색 결과 페이지 번호를 지정합니다.<br>- 최소: 1<br>- 최대: 200<br>- 기본값: 1<br><br>예) 페이지 번호가 1인 경우: page=1

페이지당 검색 결과 수를 지정합니다.<br>- 최소: 1<br>- 최대: 200<br>- 기본값: 20<br><br>예) 페이지 당 검색 결과 수가 20인 경우: count=20

검색할 관심 장소(POI)가 정문, 후문 등 입구가 여러 개인 건물인 경우 기본 건물에 대한 결괏값만 반환할지, 모든 결괏값을 반환할지 지정합니다.<br><br>Y<br>- 기본 결괏값만 반환<br><br>N(기본값)<br>- 모든 결괏값을 반환<br><br>예) multiPoint=Y

검색할 관심 장소(POI)의 부속 시설물에 대한 정보가 있는 경우 그 결괏값을 반환할지 지정합니다.<br><br>Y<br>- 관심 장소(POI)의 부속 시설물 정보가 있는 경우 결괏값을 반환(응답 메시지의 groupSubLists에서 확인)<br><br>N(기본값)<br>- 관심 장소(POI)의 부속 시설물 정보 미반환<br><br>예) poiGroupYn=Y

콜백(callback) 함수명 정보를 지정합니다. 콜백값은 Accept 값으로 지정한 application/javascript 포맷의 함수명을 뜻하며, 임의의 값을 지정할 수 있습니다.

마이페이지 > 앱에서 발급 받은 앱키(appKey)를 지정합니다. 계정 신청 및 앱 키 발급 등의 자세한 내용은 시작하기를 참고하세요.

응답 형식은 JSON(기본값), XML, JSONP을 지원합니다. 헤더의 Accept값이 application/javascript인 경우에는 callback(콜백) 함수명 정보를 반드시 설정해야 합니다.<br><br>application/json(기본값)<br>- JSON 형식<br><br>application/xml<br>- XML 형식<br><br>application/javascript<br>- JSONP(Javascript) 형식