Version 1.0 야후! 검색 API

요청 URL

http://kr.open.gugi.yahoo.com/service/poi.php

요청 파라미터들

파라미터	값	설명
appid	문자 (필수)	지도 API키(Key) 값. 지도 API키 신청/확인하기
q	문자 (필수)	검색할 지명에 대한 키워드(검색어)
encoding	문자: utf-8 (기본값), euc-kr	검색어의 언어코드를 지정한다. 지정되어 있지 않을 때는 기본값으로 utf-8을 사용한다.
results	수치값 (필수), 1~100.	결과로 보여줄 최대 개수
output	문자: xml (default), json, php	리턴 받고자 하는 데이터의 형식
callback	문자	JSON 데이터를 감싸는 콜벡 함수의 이름. 값은 A-Z a-z 0-9사이의 값이 허용된다. output이 json이 아닌 경우는 결과에 아무런 영향을 끼치지 않는다.

Sample Request Url:
http://kr.open.gugi.yahoo.com/service/poi.php?appid=YahooDemo&q=코엑스&encoding=euc-kr&output=xml&results=50

응답 항목들

항목	설명
publisher	배포자 이름
Error	0보다 큰 경우 에러가 1가지 이상 존재한다는 의미임. 0또는 음수 인 경우 성공.
ErrorMessage	오류에 대한 상세 메시지
Found	결과물의 개수
num	아이템 별 고유 번호
latitude	위도
longitude	경도
name	POI 대표 명칭
street	거리
city	읍/면/동 명칭
county	시/군/구 명칭
state	주 또는 특별/광역시 명칭
country	국가 이름

샘플 응답

아래의 xml샘플은 코엑스로 검색했을 때, 검색어 '코엑스'에 해당하는 지역 POI 리스트를 보여주는 결과 입니다. [확인하기]

<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet>
  <head>
	<publisher>YahooKorea GUGI</publisher>
	<Error>0</Error>
	<ErrorMessage>No Error</ErrorMessage>
	<Found>4</Found>
  </head>
  <locations>
	<item>
	  <num>1</num>
	  <latitude>37.512754552385</latitude>
	  <longitude>127.05724129401</longitude>
	  <name>코엑스인터컨티넨탈호텔</name>
	  <street />
	  <city>삼성1동</city>
	  <county>강남구</county>
	  <state>서울</state>
	  <country>South Korea</country>
	  </item>
	<item>
	  <num>2</num>
	  <latitude>37.510861457332</latitude>
	  <longitude>127.05940021529</longitude>
	  <name>메가박스코엑스</name>
	  <street />
	  <city>삼성1동</city>
	  <county>강남구</county>
	  <state>서울</state>
	  <country>South Korea</country>
	  </item>
	<item>
	  <num>3</num>
	  <latitude>37.512023545876</latitude>
	  <longitude>127.05979696287</longitude>
	  <name>코엑스아쿠아리움</name>
	  <street />
	  <city>삼성1동</city>
	  <county>강남구</county>
	  <state>서울</state>
	  <country>South Korea</country>
	</item>
  </locations>
</ResultSet>

제약사항

1. 야후! 지명 검색 API는 한 IP당 1일 50,000회의 질의로 제한되어 있습니다.

Version 1.0 야후! 검색 API

POI키워드로 지명 검색하기

요청 URL

요청 파라미터들

응답 항목들

샘플 응답

제약사항