Version 1.0 야후! 주소 ↔ 좌표 변환 API

요청 URL

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

요청 파라미터들

파라미터	값	설명
appid	문자 (필수)	지도 API키(Key) 값. 지도 API키 신청/확인하기
latitude	수치값 (필수)	WGS84 위도 좌표값
longitude	수치값 (필수)	WGS84 경도 좌표값
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/rgc.php?appid=YahooDemo&latitude=37.4997677193116&longitude=127.0294189453125&output=xml

응답 항목들

항목	설명
publisher	배포자 이름
Error	0보다 큰 경우 에러가 1가지 이상 존재한다는 의미임. 0또는 음수 인 경우 성공.
ErrorMessage	오류에 대한 상세 메시지
Found	결과물의 개수
country	국가 이름
state	주 또는 특별/광역시 명칭
county	시/군/구 명칭
town	읍/면/동 명칭

샘플 응답

아래의 xml샘플은 위도 : 37.4997677193116, 경도 : 127.0294189453125의 좌표에 대한 지역명을 리버스지오코더를 이용하여 구하는 것에대한 응답 결과 입니다. [확인하기]

<?xml version="1.0" encoding="UTF-8" ?> 
  <root>
    <ResultSet>
      <head>
        <publisher>YahooKorea GUGI</publisher> 
        <Error>0</Error> 
        <ErrorMessage>No Error</ErrorMessage> 
        <Found>1</Found> 
      </head>
    <location>
      <country>대한민국(Korea)</country> 
      <state>서울특별시</state> 
      <county>강남구</county> 
      <town>역삼1동</town> 
    </location>
  </ResultSet>
</root>

제약사항

야후! 주소 ↔ 좌표 변환 API는 한 IP당 1일 50,000회의 질의로 제한되어 있습니다.