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

시설물명, 상호, 시설 유형, 주소, 전화번호를 검색어로 지정합니다. 장소 통합 검색 API는 지정한 검색어와 일치하는 항목을 결과로 제공합니다.
- 명칭 검색 시 UTF-8 기반의 URL 인코딩 처리 필수
- 전화번호는 지역번호, 통신 식별자(01X)를 포함 필수
- 지역번호, 국번, 개별 번호 사이에는 하이픈(-) 또는 공백을 넣거나 숫자만 입력 가능

예)
- 시설물명: 'SK T 타워'인 경우 searchKeyword=SK%20T%20%ED%83%80%EC%9B%8C
- 상호: 'SK텔레콤'인 경우 searchKeyword=SK%ED%85%94%EB%A0%88%EC%BD%A4
- 시설 유형: '음식점'인 경우 searchKeyword=%EC%9D%8C%EC%8B%9D%EC%A0%90
- 주소: '서울 중구 을지로 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
- 전화번호: '02-6100-2114'인 경우 searchKeyword=02-6100-2114, '02 6100 2114'인 경우 searchKeyword=02%206100%202114, '0261002114'인 경우 searchKeyword=0261002114

장소 통합 검색 API는 all(통합), name(명칭), telno(전화번호)로 총 3가지 검색 유형을 지원합니다.

all(통합)(기본값)
- 시설물명, 상호, 시설 유형, 주소, 전화번호를 검색어(searchKeyword)로 모두 사용
- 명칭 또는 전화번호로 검색 유형을 반드시 특정해야 하는 경우가 아니라면 이 유형을 사용 권장

name(명칭)
- 시설물명, 상호, 시설 유형, 주소를 검색어로 사용
- '서울 중구'와 같이 지역을 특정하여 검색
- 이 유형을 사용하는 경우 법정동 코드(areaLLCode, areaLMCode) 적용 필수

telno(전화번호)
- 전화번호를 검색어로 사용

검색 유형 중 명칭(searchType=name)을 사용하는 경우에는 areaLLCode(지역 대분류 코드)와 areaLMCode(지역중분류코드)를 반드시 적용해야 합니다. 법정동 코드는 행정 표준 코드 관리 시스템의 법정동 코드 목록 조회를 통해 확인할 수 있으며, 또한 지역 분류 코드 검색 API를 이용해 조회할 수 있습니다.

지역 대분류 코드를 지정합니다.(시/구/군의 '시'에 해당)
- 법정동 코드의 맨 앞 두 자릿수

예) areaLLCode=11
- '서울특별시 종로구 청운동'의 법정동 코드 '1111010100'에서 대분류 '서울특별시'의 코드는 11

지역 중분류 코드를 지정합니다.(시/구/군의 '구' 또는 '군'에 해당)
- 법정동 코드의 앞 3번째부터 5번째까지의 세 자릿수

예) areaLMCode=110
- '서울특별시 종로구 청운동'의 법정동 코드 '1111010100'에서 중분류 '종로구'의 코드는 110

검색 결과 정렬 순서를 정확도순 또는 거리순으로 지정합니다.

A(기본값)
- 정확도순

R
- 거리순

검색 결과 정렬 순서를 거리순(searchtypCd=R)으로 적용하는 경우에는 radius(검색 반경), centerLon(중심 경도), centerLat(중심 위도)를 반드시 설정해야 합니다.

요청 좌표계를 지정할 수 있으며, 3가지 좌표계를 지원합니다.

WGS84GEO
-WGS84 경위도 좌표계

EPSG3857
- 구글 메카토르(Google Mercator)

KATECH
- TM128(Transverse Mercator, 횡메카토르), 한국 표준

예) WGS84 경위도 좌표계를 설정하는 경우: reqCoordType=WGS84GEO

응답 좌표계를 지정할 수 있으며, 3가지 좌표계를 지원합니다.

WGS84GEO
-WGS84 경위도 좌표계

EPSG3857
- 구글 메카토르(Google Mercator)

KATECH
- TM128(Transverse Mercator, 횡메카토르), 한국 표준

예) WGS84 경위도 좌표계를 설정하는 경우: resCoordType=WGS84GEO

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

Y
- 기본 결괏값만 반환

N(기본값)
- 모든 결괏값을 반환

예) multiPoint=Y

검색할 관심 장소(POI)의 부속 시설물에 대한 정보가 있는 경우 그 결괏값을 반환할지 지정합니다.

Y
- 관심 장소(POI)의 부속 시설물 정보가 있는 경우 결괏값을 반환(응답 메시지의 groupSubLists에서 확인)

N(기본값)
- 관심 장소(POI)의 부속 시설물 정보 미반환

예) poiGroupYn=Y

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

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

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

application/json(기본값)
- JSON 형식

application/xml
- XML 형식

application/javascript
- JSONP(Javascript) 형식