본문 바로가기

Daum Developers

서비스

키워드로 장소검색

키워드로 장소검색

#api #reference

검색어를 이용하여 해당하는 장소를 반환하는 API입니다.

요청 주소 ( Request URL )

APIKey GET https://apis.daum.net/local/v1/search/keyword.{format}

요청 변수 ( Request Parameters )

요청 변수 정보
파라미터타입설명값의 범위예제
querystring

검색을 원하는 질의어

locationstring

중심 좌표. 특정 지역을 중심으로 검색하려고 할 경우 사용.

37.56331,126.97590

radiusinteger

중심 좌표부터의 반경거리.
특정 지역을 중심으로 검색하려고 할 경우 사용.
meter 단위

기본값 5000

최소값 0

최대값 20000

rectstring
imagestring

이미지 필터링 기능

기본값 all

선택가능값
  • only : 이미지 있는 것만
  • not : 이미지 없는 것만
  • all : 모두
countinteger

한 페이지 당 건수

기본값 15

최소값 1

최대값 15

pageinteger

페이지 번호

기본값 1

최소값 1

최대값 3

sortstring

실제 정확도, 인기순은 질의어에 따라 변화 편차가 있음. 실제 차이가 거의 없는 질의어도 있음.
단 거리순 정렬은 반드시 location 값이 있어야 함.

기본값 0

선택가능값
  • 0 : 정확도순
  • 1 : 인기순
  • 2 : 거리순
format string 포맷json, xml

출력 결과 ( Response Element )

출력 변수 설명
lastBuildDate string 검색 제목
info integer 전체 검색 결과의 수
totalCount integer 한 페이지에 보여질 결과 수
count integer 한 페이지에 보여질 결과 수
page integer 검색 결과의 페이지 번호
item string 검색어
id string 장소 ID
title string 장소명
latitude string 장소 위도
longitude string 장소 경도
category string 장소 카테고리
phone string 장소 전화번호
imageUrl string 장소 대표이미지 URL
address string 장소 지번주소
newAddress string 장소 도로명주소
addressBCode string 장소 법정동코드
placeUrl string 장소 페이지 URL
distance string 중심좌표까지의 거리 (m단위)
direction string 중심좌표으로부터의 방향 (동, 서, 남, 북, 남동, 북동, 남서, 북서)

출력 방식 ( Response type )

JSON XML JSONP

예제 실행하기 ( Examples )

예제를 선택하시고 예제에 따른 호출 URL과 결과값을 참조하세요.
선택하신 예제에 호출 URL입니다. {access_token} 또는 {apikey}는 콘솔페이지에서 발급 가능합니다. {access_token}은 OAuth2.0 인증 방법이며 OAuth2.0의 자세한 사용 방법은 OAuth 2.0 참조하기 문서를 확인 하시면 됩니다.
?
선택하신 예제를 실행 한 출력 결과입니다. Json 또는 XML로 출력되며 개발자는 재가공하여 원하시는 결과물을 만드시면 됩니다. 단, 한글 등의 입력에 대해서는 uriencode를 적용하여 호출하여야 합니다.