Portfolio

키워드로 장소 검색하기

Request

Name	Type	Description	Required
query	String	검색을 원하는 질의어	O
category_group_code	String	카테고리 그룹 코드 카테고리로 결과 필터링을 원하는 경우 사용	X
x	String	중심 좌표의 X 혹은 경도(longitude) 값 특정 지역을 중심으로 검색할 경우 radius와 함께 사용 가능	X
y	String	중심 좌표의 Y 혹은 위도(latitude) 값 특정 지역을 중심으로 검색할 경우 radius와 함께 사용 가능	X
radius	Integer	중심 좌표부터의 반경거리. 특정 지역을 중심으로 검색하려고 할 경우 중심좌표로 쓰일 x,y와 함께 사용 (단위: 미터(m), 최소: 0, 최대: 20000)	X
rect	String	사각형의 지정 범위 내 제한 검색을 위한 좌표 지도 화면 내 검색 등 제한 검색에서 사용 가능 좌측 X 좌표, 좌측 Y 좌표, 우측 X 좌표, 우측 Y 좌표 형식	X
page	Integer	결과 페이지 번호(최소: 1, 최대: 45, 기본값: 1)	X
size	Integer	한 페이지에 보여질 문서의 개수 (최소: 1, 최대: 45, 기본값: 15)	X
sort	String	결과 정렬 순서 distance 정렬을 원할 때는 기준 좌표로 쓰일 x, y와 함께 사용 distance 또는 accuracy(기본값: accuracy)	X

Response

meta

Name	Type	Description
total_count	Integer	검색어에 검색된 문서 수
pageable_count	Integer	total_count 중 노출 가능 문서 수 (최대: 45)
is_end	Boolean	현재 페이지가 마지막 페이지인지 여부 값이 false면 다음 요청 시 page 값을 증가시켜 다음 페이지 요청 가능
same_name	RegionInfo	질의어의 지역 및 키워드 분석 정보

same_name

Name	Type	Description
region	String[]	질의어에서 인식된 지역의 리스트 예: '중앙로 맛집' 에서 중앙로에 해당하는 지역 리스트
keyword	String	질의어에서 지역 정보를 제외한 키워드 예: '중앙로 맛집' 에서 '맛집'
selected_region	String	인식된 지역 리스트 중, 현재 검색에 사용된 지역 정보

documents

Name	Type	Description
id	String	장소 ID
place_name	String	장소명, 업체명
category_name	String	카테고리 이름
category_group_code	String	중요 카테고리만 그룹핑한 카테고리 그룹 코드
category_group_name	String	중요 카테고리만 그룹핑한 카테고리 그룹명
phone	String	전화번호
address_name	String	전체 지번 주소
road_address_name	String	전체 도로명 주소
x	String	X 좌표값, 경위도인 경우 longitude (경도)
y	String	Y 좌표값, 경위도인 경우 latitude(위도)
place_url	String	장소 상세페이지 URL
distance	String	중심좌표까지의 거리 (단, x,y 파라미터를 준 경우에만 존재) 단위 meter

객체 정보 (”카카오프렌즈”로 검색했을 경우)


HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "meta": {
    "same_name": {
      "region": [],
      "keyword": "카카오프렌즈",
      "selected_region": ""
    },
    "pageable_count": 14,
    "total_count": 14,
    "is_end": true
  },
  "documents": [
    {
      "place_name": "카카오프렌즈 코엑스점",
      "distance": "418",
      "place_url": "http://place.map.kakao.com/26338954",
      "category_name": "가정,생활 > 문구,사무용품 > 디자인문구 > 카카오프렌즈",
      "address_name": "서울 강남구 삼성동 159",
      "road_address_name": "서울 강남구 영동대로 513",
      "id": "26338954",
      "phone": "02-6002-1880",
      "category_group_code": "",
      "category_group_name": "",
      "x": "127.05902969025047",
      "y": "37.51207412593136"
    },
    ...
  ]
}

API format