Transcription

1 openapi.naver.com

2

3 NAVER open API 검색결과서비스 / 지식IN 검색요청 URL 및변수 (request url and parameter) / 08 출력결과필드 (response field) / 08 Contents 09 블로그검색 요청 URL 및변수 (request url and parameter) / 09 출력결과필드 (response field) / 전문자료검색 요청 URL 및변수 (request url and parameter) / 10 출력결과필드 (response field) / 한국웹문서검색 요청 URL 및변수 (request url and parameter) / 11 출력결과필드 (response field) / 책검색요청 URL 및변수 (request url and parameter) / 12 상세검색요청 URL 및변수 (request url and parameter) / 12 책카테고리 / 13 출력결과필드 (response field) / 쇼핑검색 요청 URL 및변수 (request url and parameter) / 15 출력결과필드 (response field) / 국어사전검색 요청 URL 및변수 (request url and parameter) / 16 출력결과필드 (response field) / 일어사전검색 요청 URL 및변수 (request url and parameter) / 17 출력결과필드 (response field) / 영어사전검색 요청 URL 및변수 (request url and parameter) / 18 출력결과필드 (response field) / 18

4 19 내 PC 검색내 PC 검색에서사용되는공통요소 / 19 출력결과필드 (response field) 19 공통적으로사용되는카테고리정보 openapi_search 요청 URL 및변수 (request url and parameter) / 20 출력결과필드 (response field) / openapi_datacache 요청 URL 및변수 (request url and parameter) / 21 출력결과필드 (response field) / openapi_status 요청 URL 및변수 (request url and parameter) / 21 출력결과필드 (response field) / openapi_latestdoc 요청 URL 및변수 (request url and parameter) / 22 출력결과필드 (response field) / openapi_landmark 요청 URL 및변수 (request url and parameter) / 22 출력결과필드 (response field) / 23 검색관련기능 / 실시간검색어요청 URL 및변수 (request url and parameter) / 27 출력결과필드 (response field) / 추천검색어요청 URL 및변수 (request url and parameter) / 28 출력결과필드 (response field) / 성인검색어판별요청 URL 및변수 (request url and parameter) / 29 출력결과필드 (response field) / 오타변환요청 URL 및변수 (request url and parameter) / 30 출력결과필드 (response field) / 바로가기요청 URL 및변수 (request url and parameter) / 31 출력결과필드 (response field) / 31 에러메시지 / openapi_extinfo 요청 URL 및변수 (request url and parameter) / 23 출력결과필드 (response field) / openapi_property 요청 URL 및변수 (request url and parameter) / openapi_open 요청 URL 및변수 (request url and parameter) / openapi_readmail 요청 URL 및변수 (request url and parameter) / openapi_getoption 요청 URL 및변수 (request url and parameter) / 25 출력결과필드 (response field) / 에러메시지 지도 API / NMap Constructor / 35 NMap(container [,width] [,height]) 35 Method / 35 getbound() 35 setbound(left, top, right, bottom) 35 setcenterandzoom(point, zoom_level) 35 setcenter(point) 35 getcenter() 36 setzoom(zoom_level) 36 getzoom() 36 zoomin() 36 zoomout() 36 setminlevel(zoom_level) 36 setmaxlevel(zoom_level) 36 enabledrag() 37

5 disabledrag() 37 enablewheelzoom() 37 disablewheelzoom() 37 addcontrol(control) NEvent Static method / 43 addlistener(event_src, event_name, event_func) 43 removelistener(event_src, event_name, event_func) 43 removecontrol(control) 37 addoverlay(overlay,[ key]) 37 removeoverlay(overlay) 38 clearoverlays([key]) 38 pan(x, y) 38 Event / 38 move 38 drag 38 startdrag 38 enddrag 38 click 39 dblclick 39 mousemove 39 zoom 39 redraw NMark Constructor / 43 NMark(point, icon) 43 Method / 44 setzindex(zindex) 44 settargeturl(url) 44 unsettargeturl() 44 setpoint(point) 44 getpoint() 44 hide() 44 show() 44 Event / 45 click 45 mousedown 45 mouseup NSize Constructor / 39 NSize(width, height) 39 Method / 40 set(width, height) 40 setwidth(width) 40 mouseover 45 mouseout NIcon Constructor / 45 NIcon(src, size [,offset]) 45 setheight(height) 40 getwidth() 40 getheight() 40 add(width_dx, height_dx) 41 equals(size) 41 copy() NInfoWindow Constructor / 46 NInfoWindow() 46 Method / 46 setopacity(opacity) 46 set(point, content) NPoint Constructor / 41 NPoint(x, y) 41 Method / 41 set(x, y) 41 setx(x) 41 sety(y) 42 showwindow() 46 hidewindow() 46 getpoint() 46 delayhidewindow([delaytime]) 47 Event / 47 mouseover 47 mouseout 47 getx() 42 gety() 42 add(x_dx, y_dx) 42 distance(x, y) 42 equals(point) 42 copy() NPolyline Constructor / 47 NPolyline() 47 Method / 47 setweight(weight) 47

6 getweight() 47 addpoints(...) 48 getbound() 48 show() 48 hide() 주소좌표변환요청 URL 및변수 (request url and parameter) / 52 출력결과필드 (response field) / 52 에러메시지 / 52 setopacity(opacity) 48 getopacity() 48 setcolor(color) 49 getcolor() NXmlhttp Constructor / 49 NXmlhttp() 49 Method / 49 settype(type) 49 loadhttp(url, returnfunc,...) NZoomControl Constructor / 50 NZoomControl() 50 Method / 50 setalign(position) 50 setvalign(position) NSaveBtn Constructor / 50 NSaveBtn() 50 Method / 51 setalign(position) 51 setvalign(position) NIndexMap Constructor / 51 NIndexMap() 51 Method / 51 setalign(position) 51 setvalign(position) 51

7 표 1 지식iN 검색요청변수목록 08 표 2 지식iN 검색출력필드목록 08 표 3 블로그검색요청변수목록 09 표 4 블로그검색출력필드목록 09 표 5 전문자료검색요청변수목록 10 표 6 전문자료검색출력필드목록 10 표 7 한국웹문서검색요청변수목록 11 표 8 한국웹문서검색출력필드목록 11 표 9 책검색요청변수목록 12 표 10 책상세검색요청변수목록 12 표 11 책상세검색카테고리 13 표 12 책검색출력필드목록 14 표 13 한국웹문서검색요청변수목록 15 표 14 한국웹문서검색출력필드목록 15 표 15 국어사전검색요청변수목록 16 표 16 국어사전검색출력필드목록 16 표 17 일어사전검색요청변수목록 17 표 18 일어사전검색출력필드목록 17 표 19 영어사전검색요청변수목록 18 표 20 영어사전검색출력필드목록 18 표 21 내 PC 검색출력필드목록 19 표 22 내 PC 검색에서사용되는카테고리목록 19 표 23 내 PC 검색 openapi_search 요청변수목록 20 표 24 내 PC 검색 openapi_search 출력필드목록 20 표 25 내 PC 검색 openapi_datacache 요청변수목록 21 표 26 내 PC 검색 openapi_datacache 출력필드목록 21 표 27 내 PC 검색 openapi_status 출력필드목록 21 표 28 내 PC 검색 openapi_status 요청변수목록 21 표 29 내 PC 검색 openapi_latestdoc 출력필드목록 22 표 30 내 PC 검색 openapi_landmark 요청변수목록 22 표 31 내 PC 검색 openapi_landmark 출력필드목록 23 표 32 내 PC 검색 openapi_extinfo 요청변수목록 23 표 33 내 PC 검색 openapi_extinfo 출력필드목록 23 표 34 내 PC 검색 openapi_property 요청변수목록 24 표 35 내 PC 검색 openapi_open 요청변수목록 24 표 36 내 PC 검색 openapi_readmail 요청변수목록 24 표 37 내 PC 검색 openapi_getoption 요청변수목록 25 표 38 내 PC 검색 openapi_getoption 출력필드목록 25 표 39 실시간검색어요청변수목록 27 표 40 실시간검색어출력필드목록 27 표 41 추천검색어요청변수목록 28 표 42 추천검색어출력필드목록 28 표 43 성인검색어판별요청변수목록 29 표 44 성인검색어판별출력필드목록 29 표 45 오타변환요청변수목록 30 표 46 오타변환출력필드목록 30 표 47 바로가기요청변수목록 31 표 48 바로가기출력필드목록 31 표 49 공통에러메시지 33 표 50 주소좌표변환요청변수목록 52 표 51 주소좌표변환출력필드목록 52 표 52 주소좌표변환에러메시지 52

8 검색결과서비스

9 NAVER open API 검색결과서비스 지식 in 검색 지식 in 검색은지식인의데이터를검색할수있는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=kin&query= 검색하고자하는키워드 &display=10&start =1&sort=sim 변수명설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 지식iN을검색하기위해서이값은항상 kin 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. display 한번에반환되는검색결과의개수입니다. 기본값 : 10 최대값 : 100 start 검색의시작위치를지정합니다. 기본값 : 1 최대값 : 1000 sort 결과값이출력되는순서를정렬하기위한옵션입니다. sim: 유사도순 date: 날짜순 count: 조회수순 point: 평점순 표 1 지식 in 검색요청변수목록 출력결과필드 (response field) 필드명 형식 설명 rss 디버그를쉽게하고 RSS 리더기만으로이용할수있게하기위해만든 RSS 포맷의컨테이너이며그외의특별한의미는없습니다 channel 검색결과를포함하는컨테이너입니다. 이안에있는 title, link, description 등의항목은참고용으로무시해도무방합니다. lastbuilddate datetime 검색결과를생성한시간입니다. total integer 검색결과문서의총개수를의미합니다. start integer 검색결과문서중, 문서의시작점을의미합니다. display integer. item 개별검색결과이며 title, link, description 을포함합니다. title string 검색결과문서의제목을나타냅니다. 제목에서검색어와일치하는부분은 <b> 태그로감싸져있습니다. link string 검색결과문서의하이퍼텍스트 link를나타냅니다. description string 검색결과문서의내용을요약한정보입니다. 문서전체의내용은 link를따라가면읽을수있습니다. 검색어와일치하는부분은 <b> 태그로감싸져있습니다. 표 2 지식iN 검색출력필드목록 08

10 NAVER open API 검색결과서비스 블로그검색 블로그검색은블로그의데이터를검색할수있는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=blog&query= 검색하고자하는키워드 &display=10&star t=1&sort=sim 변수명설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 블로그를검색하기위해서이값은항상 blog 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. display 한번에반환되는검색결과의개수입니다. 기본값 : 10 최대값 : 100 start 검색의시작위치를지정합니다. 기본값 : 1 최대값 : 1000 sort 결과값이출력되는순서를정렬하기위한옵션입니다. sim: 유사도순 date: 날짜순 표 3 블로그검색요청변수목록 출력결과필드 (response field) 필드명 형식 설명 rss 디버그를쉽게하고 RSS 리더기만으로이용할수있게하기위해만든 RSS 포맷의컨테이너이며그외의특별한의미는없습니다. channel 검색결과를포함하는컨테이너입니다. 이안에있는 title, link, description 등의항목은참고용으로무시해도무방합니다. lastbuilddate datetime 검색결과를생성한시간입니다. total integer 검색결과문서의총개수를의미합니다. start integer 검색결과문서중, 문서의시작점을의미합니다. display integer item 개별검색결과이며 title, link, description 을포함합니다. title string 검색결과문서의제목을나타냅니다. 제목에서검색어와일치하는부분은 <b> 태그로감싸져있습니다. link string 검색결과문서의하이퍼텍스트 link를나타냅니다. description string 검색결과문서의내용을요약한정보입니다. 문서전체의내용은 link를따라가면읽을수있습니다. 검색어와일치하는부분은 <b> 태그로감싸져있습니다. 표 4 블로그검색출력필드목록 09

11 NAVER open API 검색결과서비스 전문자료검색 전문자료검색은전문자료의데이터를검색할수있는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=doc&query= 검색하고자하는키워드 &display=10&start=1 변수명설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 전문자료를검색하기위해서이값은항상 doc 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. display 한번에반환되는검색결과의개수입니다. 기본값 : 10 최대값 : 100 start 검색의시작위치를지정합니다. 기본값 : 1 최대값 : 1000 표 5 전문자료검색요청변수목록 출력결과필드 (response field) 필드명 형식 설명 rss 디버그를쉽게하고 RSS 리더기만으로이용할수있게하기위해만든 RSS 포맷의컨테이너이며그외의특별한의미는없습니다 channel 검색결과를포함하는컨테이너입니다. 이안에있는 title, link, description 등의항목은참고용으로무시해도무방합니다. lastbuilddate datetime 검색결과를생성한시간입니다. total integer 검색결과문서의총개수를의미합니다. start integer 검색결과문서중, 문서의시작점을의미합니다. display integer item 개별검색결과이며 title, link, description 을포함합니다. title string 검색결과문서의제목을나타냅니다. 제목에서검색어와일치하는부분은 <b> 태그로감싸져있습니다. link string 검색결과문서의하이퍼텍스트 link를나타냅니다. description string 검색결과문서의내용을요약한정보입니다. 문서전체의내용은 link를따라가면읽을수있습니다. 검색어와일치하는부분은 <b> 태그로감싸져있습니다. 표 6 전문자료검색출력필드목록 10

12 NAVER open API 검색결과서비스 한국웹문서검색 한국웹문서검색은한국웹문서의데이터를검색할수있는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=webkr&query= 검색하고자하는키워드 &display=10&start=1 변수명설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 한국웹문서를검색하기위해서이값은항상 webkr 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. display 한번에반환되는검색결과의개수입니다. 기본값 : 10 최대값 : 100 start 검색의시작위치를지정합니다. 기본값 : 1 최대값 : 1000 표 7 한국웹문서검색요청변수목록 출력결과필드 (response field) 필드명 형식 설명 rss 디버그를쉽게하고 RSS 리더기만으로이용할수있게하기위해만든 RSS 포맷의컨테이너이며그외의특별한의미는없습니다 channel 검색결과를포함하는컨테이너입니다. 이안에있는 title, link, description 등의항목은참고용으로무시해도무방합니다. lastbuilddate datetime 검색결과를생성한시간입니다. total integer 검색결과문서의총개수를의미합니다. start integer 검색결과문서중, 문서의시작점을의미합니다. display integer item 개별검색결과이며 title, link, description 을포함합니다. title string 검색결과문서의제목을나타냅니다. 제목에서검색어와일치하는부분은 <b> 태그로감싸져있습니다. link string 검색결과문서의하이퍼텍스트 link를나타냅니다. description string 검색결과문서의내용을요약한정보입니다. 문서전체의내용은 link를따라가면읽을수있습니다. 검색어와일치하는부분은 <b> 태그로감싸져있습니다. 표 8 한국웹문서검색출력필드목록 11

13 NAVER open API 검색결과서비스 책검색 책검색은책에대한데이터를검색할수있는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=book&query= 검색하고자하는키워드 &display=10&start=1 변수명설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 책을검색하기위해서이값은항상 book 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. display 한번에반환되는검색결과의개수입니다. 기본값 : 10 최대값 : 100 start 검색의시작위치를지정합니다. 기본값 : 1 최대값 : 1000 sort 결과값이출력되는순서를정렬하기위한옵션입니다. sim: 유사도순 date: 날짜순 count: 판매량순 표 9 책검색요청변수목록 상세검색요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=book_adv&query= 검색하고자하는키워드 &display=1 0&start=1&d_title=XXX&d_catg=YYY 변수명 설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 한국웹문서를검색하기위해서이값은항상 book_adv 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. d_titl 책제목에서의검색을의미합니다. d_auth 저자명에서의검색을의미합니다. d_cont 목차에서의검색을의미합니다. d_isbn ISBN에서의검색을의미합니다. d_publ 출판사에서의검색을의미합니다. d_dafr 검색을원하는책의출간범위를지정합니다. ( 시작일 ) (e.g ) d_dato 검색을원하는책의출간범위를지정합니다. ( 종료일 ) (e.g ) d_catg 검색을원하는카테고리를지정합니다. 12

14 NAVER open API 검색결과서비스 display 한번에반환되는검색결과의개수입니다. 기본값 : 10 최대값 : 100 start 검색의시작위치를지정합니다. 기본값 : 1 최대값 : 1000 sort 결과값이출력되는순서를정렬하기위한옵션입니다. sim: 유사도순 date: 날짜순 count: 판매량순 표 10 책상세검색요청변수목록 책카테고리 카테고리명 depth 1 depth 2 일반도서 1 철학 101 종교 / 신화 102 예술 / 대중문화 103 인문 / 교양 104 역사 / 지리학 105 인물 / 전기 / 평전 106 문학이론 / 문학연구 107 소설 / 시 / 희곡 108 산문 / 에세이 / 논픽션 109 사회과학 110 여성학 / 페미니즘 111 언론 / 미디어 / 광고 112 경영 / 비즈니스 114 컴퓨터 / 인터넷 115 순수과학 116 응용과학 117 장르소설 119 여행 / 해외정보 121 건강 / 취미 / 스포츠 122 가정 / 생활 / 요리 123 자기계발 124 외국어학습 125 취업 / 수험 / 자격증 126 청소년 128 참고서 129 사전 / 백과 / 연감 / 기타 130 출판사광장 150 어린이 2 아티누스국외서 4 큐레이터학 / 예술행정

15 NAVER open API 검색결과서비스 미술 402 건축 / 인테리어 403 디자인 404 공예 405 패션 406 사진 407 영화 408 애니메이션 / 만화 409 라이프스타일 410 기법서 / 사전 411 한국문화소개서 412 음악 413 아동미술 414 잡지 5 국내잡지 501 해외잡지 502 만화 6 표 11 책상세검색카테고리 출력결과필드 (response field) 필드명 형식 설명 rss 디버그를쉽게하고 RSS 리더기만으로이용할수있게하기위해만든 RSS 포맷의컨테이너이며그외의특별한의미는없습니다 channel 검색결과를포함하는컨테이너입니다. 이안에있는 title, link, description 등의항목은참고용으로무시해도무방합니다. lastbuilddate datetime 검색결과를생성한시간입니다. total integer 검색결과문서의총개수를의미합니다. start integer 검색결과문서중, 문서의시작점을의미합니다. display integer item 개별검색결과이며 title, link, description 을포함합니다. title string 검색결과문서의제목을나타냅니다. 제목에서검색어와일치하는부분은 <b> 태그로감싸져있습니다. link string 검색결과문서의하이퍼텍스트 link를나타냅니다. image string 썸네일이미지의 URL입니다. 이미지가있는경우만나타납니다. author string 저자정보입니다. price integer 가격정보입니다. 절판도서등으로가격이없으면나타나지않습니다. discount integer 할인가정보입니다. 절판도서등으로가격이없으면나타나지않습니다. publisher string 출판사정보입니다. pubdate date 출간일정보입니다. isbn integer ISBN 정보입니다. description string 검색결과문서의내용을요약한정보입니다. 문서전체의내용은 link를따라가면읽을수있습니다. 검색어와일치하는부분은 <b> 태그로감싸져있습니다. 표 12 책검색출력필드목록 14

16 NAVER open API 검색결과서비스 쇼핑검색 쇼핑검색은 NAVER 쇼핑에등록된상품의데이터를검색할수있는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=shop&query= 검색하고자하는키워드 &display=10&start=1 변수명설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 쇼핑데이터를검색하기위해서이값은항상 shop 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. display 한번에반환되는검색결과의개수입니다. 기본값 : 10 최대값 : 100 start 검색의시작위치를지정합니다. 기본값 : 1 최대값 : 1000 sort 결과값이출력되는순서를정렬하기위한옵션입니다. sim: 유사도순 date: 날짜순 asc: 가격오름차순 dsc: 가격내림차순 표 13 한국웹문서검색요청변수목록 출력결과필드 (response field) 필드명 형식 설명 rss 디버그를쉽게하고 RSS 리더기만으로이용할수있게하기위해만든 RSS 포맷의컨테이너이며그외의특별한의미는없습니다 channel 검색결과를포함하는컨테이너입니다. 이안에있는 title, link, description 등의항목은참고용으로무시해도무방합니다. lastbuilddate datetime 검색결과를생성한시간입니다. total integer 검색결과문서의총개수를의미합니다. start integer 검색결과문서중, 문서의시작점을의미합니다. display integer item 개별검색결과이며 title, link, description 을포함합니다. title string 검색결과문서의제목을나타냅니다. 제목에서검색어와일치하는부분은 <b> 태그로감싸져있습니다. link string 검색결과문서의하이퍼텍스트 link를나타냅니다. image string 썸네일이미지의 URL입니다. 이미지가있는경우에만나타납니다. lprice integer 최저가정보입니다. 가격정보가있는경우에만나타납니다. hprice integer 최고가정보입니다. 가격정보가있는경우에만나타납니다. 표 14 한국웹문서검색출력필드목록 15

17 NAVER open API 검색결과서비스 국어사전검색 국어사전검색은 NAVER 의국어사전을검색할수있는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=krdic&query= 검색하고자하는키워드 &display=10&start=1 변수명설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 국어사전을검색하기위해서이값은항상 krdic 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. display 한번에반환되는검색결과의개수입니다. 기본값 : 10 최대값 : 100 start 검색의시작위치를지정합니다. 기본값 : 1 최대값 : 1000 표 15 국어사전검색요청변수목록 출력결과필드 (response field) 필드명 형식 설명 rss 디버그를쉽게하고 RSS 리더기만으로이용할수있게하기위해만든 RSS 포맷의컨테이너이며그외의특별한의미는없습니다 channel 검색결과를포함하는컨테이너입니다. 이안에있는 title, link, description 등의항목은참고용으로무시해도무방합니다. lastbuilddate datetime 검색결과를생성한시간입니다. total integer 검색결과문서의총개수를의미합니다. start integer 검색결과문서중, 문서의시작점을의미합니다. display integer item 개별검색결과이며 title, link, description 을포함합니다. title string 검색결과문서의제목을나타냅니다. 제목에서검색어와일치하는부분은 <b> 태그로감싸져있습니다. link string 검색결과문서의하이퍼텍스트 link를나타냅니다. 표 16 국어사전검색출력필드목록 16

18 NAVER open API 검색결과서비스 일어사전검색 일어사전검색은 NAVER 의일어사전을검색할수있는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=jpdic&query= 검색하고자하는키워드 &display=10&start=1 변수명설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 일어사전을검색하기위해서이값은항상 jpdic 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. display 한번에반환되는검색결과의개수입니다. 기본값 : 10 최대값 : 100 start 검색의시작위치를지정합니다. 기본값 : 1 최대값 : 1000 표 17 일어사전검색요청변수목록 출력결과필드 (response field) 필드명 형식 설명 rss 디버그를쉽게하고 RSS 리더기만으로이용할수있게하기위해만든 RSS 포맷의컨테이너이며그외의특별한의미는없습니다 channel 검색결과를포함하는컨테이너입니다. 이안에있는 title, link, description 등의항목은참고용으로무시해도무방합니다. lastbuilddate datetime 검색결과를생성한시간입니다. total integer 검색결과문서의총개수를의미합니다. start integer 검색결과문서중, 문서의시작점을의미합니다. display integer item 개별검색결과이며 title, link, description 을포함합니다. title string 검색결과문서의제목을나타냅니다. 제목에서검색어와일치하는부분은 <b> 태그로감싸져있습니다. link string 검색결과문서의하이퍼텍스트 link를나타냅니다. 표 18 일어사전검색출력필드목록 17

19 NAVER open API 검색결과서비스 영어사전검색 영어사전검색은 NAVER 의영어사전을검색할수있는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=endic&query= 검색하고자하는키워드 &display=10&start=1 변수명설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 영어사전을검색하기위해서이값은항상 endic 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. display 한번에반환되는검색결과의개수입니다. 기본값 : 10 최대값 : 100 start 검색의시작위치를지정합니다. 기본값 : 1 최대값 : 1000 표 19 영어사전검색요청변수목록 출력결과필드 (response field) 필드명 형식 설명 rss 디버그를쉽게하고 RSS 리더기만으로이용할수있게하기위해만든 RSS 포맷의컨테이너이며그외의특별한의미는없습니다 channel 검색결과를포함하는컨테이너입니다. 이안에있는 title, link, description 등의항목은참고용으로무시해도무방합니다. lastbuilddate datetime 검색결과를생성한시간입니다. total integer 검색결과문서의총개수를의미합니다. start integer 검색결과문서중, 문서의시작점을의미합니다. display integer item 개별검색결과이며 title, link, description 을포함합니다. title string 검색결과문서의제목을나타냅니다. 제목에서검색어와일치하는부분은 <b> 태그로감싸져있습니다. link string 검색결과문서의하이퍼텍스트 link를나타냅니다. 표 20 영어사전검색출력필드목록 18

20 NAVER open API 검색결과서비스 내 PC 검색 내 PC 검색은내 PC 검색 ( 을설치했을경우 내 PC 의자료를검색할수있는 API 입니다. 내 PC 검색에서사용되는공통요소 출력결과필드 (response field) 출력은표준형식인 RSS 2.0 형식 ( 을따릅니다. 표준 RSS 에내 PC 검색 API 용으로추가 된태그는 nns XML namespace 를가집니다. 필드명 형식 설명 rss 디버그를쉽게하고 RSS 리더기만으로이용할수있게하기위해만든 RSS 포맷의컨테이너이며그외의특별한의미는없습니다 channel 검색결과를포함하는컨테이너입니다. 이안에있는 title, link, description 등의항목은참고용으로무시해도무방합니다. title string 제목 link url 요청 url description string 설명 nns:total integer 검색결과문서의총개수를의미합니다. nns:start integer 검색결과문서중, 문서의시작점을의미합니다. nns:display integer nns:errorcode integer 오류발생시에러코드입니다. 정상일때는 0입니다. nns:result compound tag 응답결과 item compound tag 검색결과아이템표 21 내 PC 검색출력필드목록 공통적으로사용되는카테고리정보 ID 카테고리 설명 0 desktop 전체카테고리 1 webpage 웹히스토리 2 doc 문서 3 image 이미지 4 music 음악 5 movie 동영상 6 dir 폴더 7 이메일 8 etc 기타파일 9 timeline 타임라인 표 22 내 PC 검색에서사용되는카테고리목록 19

21 NAVER open API 검색결과서비스 openapi_serch 검색을요청합니다. 요청 URL 및변수 (request url and parameter) 변수명설명 where 검색할카테고리를지정합니다. 기본값 : desktop query 검색할질의어를입력합니다. URL encoding 이되어있어야합니다. start 검색의시작위치를지정합니다. 기본값 : 1 display 한번에반환되는검색결과의개수입니다. 기본값 : 환경설정에지정된개수 ds 검색시작일자 (e.g ) de 검색종료일자 (e.g ) st 검색영역을지정합니다. 제목 (URL, 파일명, 폴더명 ) + 본문 (0: 기본값 ), 제목상세 (1) so 검색결과의정렬방법을지정합니다. 0: 시간순 ( 기본값 ) 1: 정확도 et 검색에포함시킬확장자목록입니다. 로항목구분을합니다. (e.g. txt doc ppt) tp 지정폴더내검색을합니다. cat 카테고리를지정합니다. where가 timeline 일경우 timeline 카테고리를지정합니다. tl where가 timeline 일경우날짜를지정합니다. 표 23 내 PC 검색 openapi_search 요청변수목록 출력결과필드 (response field) 필드명 형식 설명 title string item의제목 link URL 웹페이지또는파일의위치를나타내는 URL description string 검색결과. 검색어가강조표시됩니다. nns:docid integer 문서의고유 ID nns:hightlightedurl URL 강조되어표시된 URL nns:maindocoffset integer 문서의 offset nns:maindocsize integer 문서의크기 nns:subdocoffset integer 썸네일등포함된문서의 offset nns:subdocsize integer 썸네일등포함된문서의크기 nns:itemtime epoch time 문서의수정된날짜또는색인시간 nns:category 카테고리 ID 카테고리 nns:extentionid extention ID 문서의확장자타입. 타입 id는 openapi_extinfo 로받아올수있습니다. nns:metainfo item에대한세부적인정보를담고있습니다. 표 24 내 PC 검색 openapi_search 출력필드목록 20

22 NAVER open API 검색결과서비스 openapi_datacache 썸네일데이터를 Base64 인코딩형태로가져옵니다. 요청 URL 및변수 (request url and parameter) 변수명설명 h 데이터의 offset. 검색결과의값 (nns:subdocoffset) 을사용합니다. l 데이터의 size. 검색결과의값 (nns:subdocoffset) 을사용합니다. 표 25 내 PC 검색 openapi_datacache 요청변수목록 출력결과필드 (response field) 필드명형식설명 nns:thumbnail Base 64 encoded string 인코딩된 thumbnail 이미지 표 26 내 PC 검색 openapi_datacache 출력필드목록 openapi_status 현재색인상태에대한정보를가져옵니다. 요청 URL 및변수 (request url and parameter) 출력결과필드 (response field) 필드명 형식 설명 nns:progress percent 색인진행률 nns:totaldocnum integer 전체색인문서개수 nns:catstatus compound tag 각카테고리별색인상태. catid: 카테고리 ID nns:docnum integer 카테고리별문서개수 nns:docdate docdate 마지막문서갱신날짜표 27 내 PC 검색 openapi_status 출력필드목록 21

23 NAVER open API 검색결과서비스 openapi_latestdoc 최근문서에대한정보를가져옵니다. 요청 URL 및변수 (request url and parameter) 변수명설명 where 카테고리를지정합니다. 기본값 : desktop display 출력건수를지정합니다. 기본값 : 환경설정에지정된개수 표 28 내 PC 검색 openapi_status 요청변수목록 출력결과필드 (response field) 필드명 형식 설명 title string item의제목 link URL 웹페이지또는파일의위치를나타내는 URL description string 검색속도향상을위해이값은출력되지않습니다. nns:docid integer 문서의고유 ID nns:hightlightedurl URL 강조되어표시된 URL nns:maindocoffset integer 문서의 offset nns:maindocsize integer 문서의크기 nns:subdocoffset integer 썸네일등포함된문서의 offset nns:subdocsize integer 썸네일등포함된문서의크기 nns:itemtime epoch time 문서의수정된날짜또는색인시간 nns:category 카테고리 ID 카테고리 nns:extentionid extention ID 문서의확장자타입. 타입 id는 openapi_extinfo 로받아올수있습니다. nns:metainfo item에대한세부적인정보를담고있습니다. 표 29 내 PC 검색 openapi_latestdoc 출력필드목록 openapi_landmark 랜드마크정보를가져옵니다. 요청 URL 및변수 (request url and parameter) 변수명 설명 doc 기준문서의 ID 표 30 내 PC 검색 openapi_landmark 요청변수목록 22

24 NAVER open API 검색결과서비스 출력결과필드 (response field) 필드명 형식 설명 title string item의제목 link URL 웹페이지또는파일의위치를나타내는 URL description string 검색결과. 검색어가강조표시됩니다. nns:docid integer 문서의고유 ID nns:hightlightedurl URL 강조되어표시된 URL nns:maindocoffset integer 문서의 offset nns:maindocsize integer 문서의크기 nns:subdocoffset integer 썸네일등포함된문서의 offset nns:subdocsize integer 썸네일등포함된문서의크기 nns:itemtime epoch time 문서의수정된날짜또는색인시간 nns:category 카테고리 ID 카테고리 nns:extentionid extension ID 문서의확장자타입. 타입 id는 openapi_extinfo 로받아올수있습니다. nns:metainfo item에대한세부적인정보를담고있습니다. 표 31 내 PC 검색 openapi_landmark 출력필드목록 openapi_extinfo 카테고리별로색인되는확장자목록을가져옵니다. 요청 URL 및변수 (request url and parameter) 변수명 설명 where 카테고리를지정합니다. 기본값 : desktop 표 32 내 PC 검색 openapi_extinfo 요청변수목록 출력결과필드 (response field) 필드명 형식 설명 nns:extinfo compound tag 각카테고리별확장자정보 catid: 카테고리 ID nns:ext string 색인되는확장자 id: 확장자의 ID 표 33 내 PC 검색 openapi_extinfo 출력필드목록 23

25 NAVER open API 검색결과서비스 openapi_property 파일의속성창을엽니다. 요청 URL 및변수 (request url and parameter) 변수명 설명 path 속성창을열파일의절대경로표 34 내 PC 검색 openapi_property 요청변수목록 openapi_open 파일을엽니다. 파일오픈프로그램은탐색기의연결프로그램설정을따릅니다. 요청 URL 및변수 (request url and parameter) 변수명 설명 path 열파일의절대경로표 35 내 PC 검색 openapi_open 요청변수목록 openapi_readmail 이메일문서를 Outlook, OutlookExpress 등의이메일클라이언트프로그램으로엽니다. 요청 URL 및변수 (request url and parameter) 변수명 설명 eid 열문서의 entry ID. 검색결과의 <nns:metainfo name= entry_id > 의값을사용합니다. 표 36 내 PC 검색 openapi_readmail 요청변수목록 24

26 NAVER open API 검색결과서비스 openapi_getoption 환경설정정보를가져옵니다. 요청 URL 및변수 (request url and parameter) 변수명 type 설명가져올항목. all, cat_order, displayno, disablefo, disablefe, disablenexearch 기본값 : all 표 37 내 PC 검색 openapi_getoption 요청변수목록 출력결과필드 (response field) 필드명 형식 설명 nns:cat_order category list 검색영역에포함된카테고리 ID의목록. 로구분합니다. nns:displayno integer 결과출력건수 nns:disablefo boolean value 파일열기바막음여부 nns:disablefe boolean value 폴더검색바막음여부 nns:disablenexearch boolean value NAVER 통합검색연동출력여부표 38 내 PC 검색 openapi_getoption 출력필드목록 25

27 검색관련기능

28 NAVER open API 검색관련기능 실시간검색어 실시간검색어는현재 NAVER 에서많이검색되고있는검색어들을 순서대로 10 위까지보여주는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=rank&query= 검색어분류 변수명설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 실시간검색어를이용하기위해서이값은항상 rank 이어야합니다. query 보기를원하는분류를입력합니다. nexearch: 통합검색 cafeblog: 카페, 블로그검색 dic: 사전검색 image: 이미지검색 kin: 지식iN 검색 music: 음악검색 video: 동영상검색 webkr: 웹문서검색 news: 뉴스검색 표 39 실시간검색어요청변수목록 출력결과필드 (response field) 필드명 형식 설명 R숫자 R1 ~ R10은순위를나타냅니다. R1: 1위 R10: 10위 K string 키워드 S string 순위의증감여부 +: 증가 -: 감소 new: 새로운순위 V integer 변동값. 0 인경우새로운순위를의미합니다. 표 40 실시간검색어출력필드목록 27

29 NAVER open API 검색관련기능 추천검색어 추천검색어는입력한검색어에대해서 NAVER 에서추천하는검색어들의목록을 보여주는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=recmd&query= 검색하고자하는키워드 변수명 설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 추천검색어를이용하기위해서이값은항상 recmd 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. 표 41 추천검색어요청변수목록 출력결과필드 (response field) 필드명 형식 설명 item string 추천검색어입니다. 이엘리먼트를반복적으로읽어다수의추천검색어를얻을수있습니다. 표 42 추천검색어출력필드목록 28

30 NAVER open API 검색관련기능 성인검색어판별 성인검색어판별은입력한검색어에대해서 NAVER 에서성인키워드해당여부를 알려주는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=adult&query= 검색하고자하는키워드 변수명 설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 성인검색어판별을이용하기위해서이값은항상 adult 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. 표 43 성인검색어판별요청변수목록 출력결과필드 (response field) 필드명 형식 설명 adult integer 성인키워드의해당여부입니다. 0: 비성인키워드 1: 성인키워드 표 44 성인검색어판별출력필드목록 29

31 NAVER open API 검색관련기능 오타변환 오타변환은입력한검색어가맞춤법에맞지않을경우맞춤법에맞는단어를추천하는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=errata&query= 검색하고자하는키워드 변수명 설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 오타변환을이용하기위해서이값은항상 errata 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. 표 45 오타변환요청변수목록 출력결과필드 (response field) 필드명형식설명 errata string 오타변환결과. 결과가없으면빈문자열이됩니다. 표 46 오타변환출력필드목록 30

32 NAVER open API 검색관련기능 바로가기 바로가기는입력한검색어에서바로연결될수있는사이트의정보를가져올수있는 API 입니다. 요청 URL 및변수 (request url and parameter) 검색용 OpenAPI 키 &target=shortcut&query= 검색하고자하는키워드 변수명 설명 key OpenAPI를사용하기위해 NAVER에서발급받은 key입니다. target 바로가기를이용하기위해서이값은항상 shortcut 이어야합니다. query 검색하려는질의문입니다. UTF-8 형식이어야합니다. 표 47 바로가기요청변수목록 출력결과필드 (response field) 필드명 형식 설명 shortcut string 결과가없으면빈문자열이됩니다. label string 바로가기로연결될사이트명입니다. url string 바로가기로열릴사이트 url 입니다. 표 48 바로가기출력필드목록 31

33 에러메시지

34 NAVER open API 에러메시지 에러메시지 지식 in 검색, 블로그검색, 전문자료검색, 한국웹문서검색, 책검색, 쇼핑검색, 국어사전검색, 일어사전검색, 영어사전검색, 실시 간검색어, 추천검색어, 성인검색어판별, 오타변환, 바로가기에서사용되는에러메시지는모두동일하며그내용은아래의표에서확 인할수있습니다. 에러코드 에러메시지 설명 000 System error 시스템에러 010 Your query request 쿼리요청제한을초과하였습니다. 일반적으로는 5,000개이상의쿼리에대하여 count is over the limit 이에러메시지가발생되나, 쿼리제한이다르게설정된경우에는이에준하여발생됩니다. 011 Incorrect query 잘못된쿼리요청입니다. 쿼리 (query=) 필드자체가없는경우발생하는 request 에러메시지입니다....&query=& 식으로입력하는경우정상적인쿼리요청으로보고, 에러메시지를발생하지않으며, " 에대한검색을수행합니다. 020 Unregistered key 등록되지않은키입니다. 021 Your key is temporary 사용할수없는키입니다. OpenAPI에등록되었으나, 일시적으로사용중지된 unavailable 키를통하여쿼리를검색하는경우발생하는에러입니다. 100 Invalid target value 부적절한 target 값입니다. 필드설명에없는 target이름을사용한경우, 혹은 target필드가없는경우발생하는메시지입니다. 101 Invalid display value 부적절한 display 값입니다. display필드자체가없는경우에는정상적인쿼리요청으로보고에러메시지를발생하지않으며, 기본값인 display=10 으로처리됩니다. display값이 100을초과하는경우나 0이하의값일때, 혹은 '...&display=&' 와같이값을입력하지않은경우에는에러메시지를발생합니다. 102 Invalid start value 부적절한 start 값입니다. start필드자체가없는경우에는정상적인쿼리요청으로보고에러메시지를발생하지않으며, 기본값인 start=1으로처리됩니다. start값이 1000을초과하거나 0이하의경우, 혹은 '...&start=&' 와같이값을입력하지않은경우에는에러메시지를발생합니다. 110 Undefined sort value 정의되지않은 sort값입니다. sort필드자체가없는경우는정상적인쿼리요청으로보고에러메시지를발생하지않으며, sort 옵션을사용하는서비스 API인경우기본값인 sort=sim 으로처리됩니다. sort값이해당하는서비스의정렬옵션이외의값을가지는경우혹은 '...&sort=&' 와같이값을입력하지않은경우에러메시지를발생합니다. ( 예, 지식iN 검색쿼리요청에서쇼핑검색의정렬옵션인 sort=asc 를사용하는경우 ) 200 Reserved 900 Undefined error 정의되지않은오류가발생하였습니다. occured 표 49 공통에러메시지 33

35 지도 API

36 NAVER open API 지도 API NMap Constructor NMap(container [,width] [,height]) 새로운지도객체를생성합니다. 파라미터 container 는지도를표시할 HTML container 이며일반적으로 DIV 요소 (element) 입니다. width는지도의너비, height 는지도의높이입니다. 만약 width와 height의값이제공되지않으면 container 의 width와 height의값을사용합니다. var mapobj = new NMap(document.getElementById( mapcontainer ), 300, 300); Method getbound() 현재지도의경계 (boundary) 영역정보를가지고있는배열 (Array) 을반환합니다. 반환값 Array(left, top, right, bottom) left, top, right, bottom 은각각현재경계영역의좌측, 정상, 우측, 바닥가장자리의좌표값입니다. var boundary = mapobj.getbound(); setbound(left, top, right, bottom) 현재지도의경계 (boundary) 영역을설정합니다. 설정이완료되면현재지도의경계와지도크기를이용해서지도의중앙점 (center point) 과축적수준 (zoom level) 을설정합니다. 파라미터 left, top, right, bottom 은각각경계영역의좌측, 정상, 우측, 바닥가장자리의좌표값을설정하는데사용됩니다. mapobj.setbound(1000, 1000, 5000, 5000); setcenterandzoom(point, zoom_level) 현재지도의중앙점 (center point) 과축적수준 (zoom level) 을설정합니다. 파라미터 point는 NPoint 클래스의객체이며 zoom_level 은 1~11 사이의자연수입니다. zoom_level 이 1에가까울수록지도가확대됩니다. mapobj.setcenterandzoom(new NPoint(1000, 1000), 5); setcenter(point) 현재지도의중앙점 (center point) 을설정합니다. 파라미터 point 는 NPoint 클래스의객체입니다. mapobj.setcenter(new NPoint(1000, 1000)); 35

37 NAVER open API 지도 API getcenter() 현재지도의중앙점 (center point) 를반환합니다. 반환값 NPoint / 지도의중앙점의위치입니다. var centerpoint = mapobj.getcenter(); setzoom(zoom_level) 현재지도의축적수준 (zoom level) 을설정합니다. 파라미터 zoom_level 은 1~11 사이의자연수입니다. zoom_level 이 1 에가까울수록지도가확대됩니다. mapobj.setzoom(5); getzoom() 현재지도의축적수준 (zoom level) 을반환합니다. 반환값 Number / 현재의축적수준의값 (1 ~ 11) 입니다. var zoomlevel = mapobj.getzoom(); zoomin() 현재지도의축적수준 (zoom level) 을한단계확대합니다. ( 실제 zoom level 값은 1 만큼감소합니다.) mapobj.zoomin(); zoomout() 현재지도의축적수준 (zoom level) 을한단계축소합니다. ( 실제 zoom level 값은 1 만큼증가합니다.) mapobj.zoomout(); setminlevel(zoom_level) 현재지도의최소축적수준 (zoom level) 을설정합니다. 기본값은 1 입니다. 파라미터 zoom_level 은 1~11 사이의자연수입니다. zoom_level 이 1 에가까울수록지도가확대됩니다. mapobj.setminlevel(2); setmaxlevel(zoom_level) 현재지도의최대축적수준 (zoom level) 을설정합니다. 기본값은 11 입니다. 파라미터 zoom_level 은 1~11 사이의자연수입니다. zoom_level 이 1 에가까울수록지도가확대됩니다. mapobj.setmaxlevel(10); 36

38 NAVER open API 지도 API enabledrag() 현재지도의 drag 모드를활성화합니다. 활성화가기본값입니다. drag 모드란사용자가마우스를통해지도를이동시킬수있는상태를 의미합니다. mapobj.enabledrag(); disabledrag() 현재지도의 drag 모드를비활성화합니다. drag 모드란사용자가마우스를통해지도를이동시킬수있는상태를의미합니다. mapobj.disabledrag(); enablewheelzoom() 현재지도의마우스휠 (wheel) 과지도줌 (zoom) 간의연동모드를활성화합니다. 마우스휠 (wheel) 과지도줌 (zoom) 간의연동모드란 사용자가마우스휠을사용하여지도의축적수준을변경할수있는상태를의미합니다. mapobj.enablewheelzoom(); disablewheelzoom() 현재지도의마우스휠 (wheel) 과지도줌 (zoom) 간의연동모드를비활성화합니다. 비활성화가기본값입니다. 마우스휠 (wheel) 과지 도줌 (zoom) 간의연동모드란사용자가마우스휠을사용하여지도의축적수준을변경할수있는상태를의미합니다. mapobj.disablewheelzoom(); addcontrol(control) 현재지도에 control 을추가합니다. 파라미터 control 은 NZoomControl, NSaveBtn, NIndexMap 클래스의객체입니다. mapobj.addcontrol(new NZoomControl()); removecontrol(control) 현재지도에서지정된 control 을제거합니다. 파라미터 control 은 NZoomControl, NSaveBtn, NIndexMap 클래스의객체입니다. mapobj.remove(controlobj); addoverlay(overlay,[ key]) 현재지도에 overlay 을추가합니다. key 값이있을경우 key 값과 overlay 를연결합니다. 파라미터 overlay 란지도위에표시되는객체를지칭하는용어입니다. overlay 는 NMark, NInfo indow 또는 NPolyline 클래스 의객체입니다. key 는 String 형이며여러개의 overlay 에연결해서사용할수있습니다. mapobj.addoverlay(new NInfo indow; 37

39 NAVER open API 지도 API removeoverlay(overlay) 현재지도에서지정된 overlay 을제거합니다. 파라미터 overlay 는 NMark, NInfo indow 또는 NPolyline 클래스의객체입니다. mapobj.removeoverlay(overlayobj); clearoverlays([key]) 현재지도에서추가된모든 overlay 들을제거합니다. key 값이있을경우 key 값과연결된 overlay 들만제거합니다. 파라미터 key 는 String 형이며여러개의 overlay 에연결해서사용할수있습니다. mapobj.clearoverlays(); pan(x, y) 현재지도를이동시킵니다. 파라미터 x 는이동할 X 좌표거리입니다. y 는이동할 Y 좌표거리입니다. mapobj.pan(1000, 1000); Event move 현재지도를이동할때발생합니다. 전달값 NSize 이동된전체값입니다. drag 현재지도를 drag 할때발생합니다. 일반적으로 drag 를하면 move 이벤트가연동해서발생합니다. startdrag 현재지도에서 drag 를시작할때발생합니다. 이이벤트핸들러는이벤트발생시점의경계 (boundary) 정보를담고있는배열을파라미 터로받습니다 전달값 Array(left, top, right, bottom) left, top, right, bottom 은각각현재경계영역의좌측, 정상, 우측, 바닥가장자리의좌표값입니다. enddrag 현재지도에서 drag 를종료할때발생합니다. 이이벤트핸들러는이벤트발생시점의경계 (boundary) 정보를담고있는배열을파라미 터로받습니다. 전달값 Array(left, top, right, bottom) left, top, right, bottom 은각각현재경계영역의좌측, 정상, 우측, 바닥가장자리의좌표값입니다. 38

40 NAVER open API 지도 API click 현재지도를마우스로클릭하였을때발생합니다. 이이벤트핸들러는클릭된점의좌표정보를담고있는 NPoint 객체를파라미터로받 습니다. 전달값 NPoint / 클릭이일어났을때클릭된점의좌표정보입니다. dblclick 현재지도를마우스로더블클릭하였을때발생합니다. 이이벤트핸들러는더블클릭된점의좌표정보를담고있는 NPoint 객체를파라 미터로받습니다. 전달값 NPoint / 더블클릭이일어났을때클릭된점의좌표정보입니다. mousemove 현재지도위에서마우스를이동할때발생합니다. 이이벤트핸들러는이벤트발생시점에서마우스가가리킨점좌표정보를담고있는 NPoint 객체를파라미터로받습니다. 전달값 NPoint / 이벤트발생시점에서마우스가가리킨점의좌표정보입니다. zoom 현재지도의축척이변하였을때발생합니다. 이이벤트핸들러는지도의새로운축적수준 (zoom level) 과이전축적수준정보를파라미 터로받습니다 전달값 new_level,old_level / new_level 은새로운축적수준입니다. old_level 은이전축적수준입니다. redraw 현재지도가다시그려질때발생합니다. 이이벤트는중앙점 (center point) 의변경이나축적수준 (zoom level) 의변경시발생합니다. NSize Constructor NSize(width, height) 새로운사이즈 (size) 객체를생성합니다. 파라미터 width 는사이즈의너비입니다. height 는사이즈의높이입니다. var sizeobj = new NSize(400, 300); 39

41 NAVER open API 지도 API Method set(width, height) 현재사이즈 (size) 의너비와높이를설정합니다. 파라미터 width 는사이즈의너비입니다. height 는사이즈의높이입니다. sizeobj.set(640, 480); setwidth(width) 현재사이즈 (size) 의너비를설정합니다. 파라미터 width 는사이즈의너비입니다. sizeobj.setwidth(640); setheight(height) 현재사이즈 (size) 의높이를설정합니다. 파라미터 height 는사이즈의높이입니다. sizeobj.setheight(480); getwidth() 현재사이즈 (size) 의너비를반환합니다. 반환값 Number / 현재사이즈의너비입니다. var width = sizeobj.getwidth(); getheight() 현재사이즈 (size) 의높이를반환합니다. 반환값 Number / 현재사이즈의높이입니다. var height = sizeobj.getheight(); add(width_dx, height_dx) 기존의 width, height 값에 width_dx, height_dx 값을더합니다. 파라미터 width_dx 는더해질너비입니다. height_dx 는더해질높이입니다. sizeobj.add(1000, 1000); 40

42 NAVER open API 지도 API equals(size) 현재사이즈 (size) 와파라미터로제공된사이즈객체의값이같은지판단합니다. 파라미터 size 는 NSize 클래스의객체입니다. 반환값 Boolean / 같으면 true, 그렇지않으면 false 를반환합니다. var result = sizeobj.equals(new NSize(1000, 1000)); copy() 현재사이즈 (size) 와동일한객체를생성합니다. 반환값 NSize / 현재사이즈와동일한객체입니다. var newsizeobj = sizeobj.copy(); NPoint Constructor NPoint(x, y) 새로운포인트 (point) 객체를생성합니다. 파라미터 x 는포인트의 X 좌표입니다. y 는포인트의 Y 좌표입니다. var pointobj = new NPoint(1000, 1000); Method set(x, y) 현재포인트 (point) 의 X,Y 좌표를설정합니다. 파라미터 x 는포인트의 X 좌표입니다. y 는포인트의 Y 좌표입니다. pointobj.set(2000, 2000); setx(x) 현재포인트 (point) 의 X 좌표를설정합니다. 파라미터 x 는포인트의 X 좌표입니다. pointobj.setx(2000); 41

43 NAVER open API 지도 API sety(y) 현재포인트 (point) 의 Y 좌표를설정합니다. 파라미터 y 는포인트의 Y 좌표입니다. pointobj.sety(2000); getx() 현재포인트 (point) 의 X 좌표를반환합니다. 반환값 Number / 현재포인트의 X 좌표입니다. var xpos = pointobj.getx(); gety() 현재포인트 (point) 의 Y 좌표를반환합니다. 반환값 Number / 현재포인트의 Y 좌표입니다. var ypos = pointobj.gety(); add(x_dx, y_dx) 기존의 x, y 값에 x_dx, y_dx 값을더합니다. 파라미터 x_dx 는더해질 X 좌표입니다. y_dx 는더해질 Y 좌표입니다. pointobj.add(1500, 1500); distance(x, y) 현재포인트 (point) 의 X, Y 좌표에서제공된 x, y 좌표사이의거리값을반환합니다. x 는포인트의 X 좌표입니다. y 는포인트의 Y 좌표입 니다. 파라미터 x 는포인트의 X 좌표입니다. y 는포인트의 Y 좌표입니다. 반환값 Number / 현재포인트와파라미터로제공된포인트사이의거리입니다. var distance = pointobj.distance(4000, 4000); equals(point) 현재포인트 (point) 와파라미터로제공된포인트객체의값이같은지판단합니다. 파라미터 point 는 NPoint 클래스의객체입니다. 반환값 Boolean / 현재포인트와파라미터로제공된포인트의값이같으면 true, 그렇지않으면 false 를반환합니다. var result = pointobj.equals(new Point(1500, 1500)); 42

44 NAVER open API 지도 API copy() 현재포인트 (point) 와동일한객체를생성합니다. 반환값 NPoint / 현재포인트와동일한객체입니다. var newpoint = pointobj.copy(); NEvent Static method addlistener(event_src, event_name, event_func) event_src 객체의 event_name 이벤트에 event_func 를등록합니다. 파라미터 event_src 는이벤트를포함하고있는 NMap, NMark, NInfoWindow 의객체입니다. event_name 은각클래스에있는이벤트이름입니다. ( 각각의이벤트들은각클래스의 Event 설명을참고해주시기바랍니다.) event_func 은사용자가정의한이벤트함수로써해당이벤트가실행되면이함수가호출됩니다. NEvent.addListener(mapObj, click, clicked); removelistener(event_src, event_name, event_func) event_src 객체에 event_name 이벤트로등록된 event_func 을제거합니다. 파라미터 event_src 는이벤트를포함하고있는 NMap, NMark, NInfoWindow 의객체입니다. event_name 은각클래스에있는이벤트이름입니다. ( 각각의이벤트들은각클래스의 Event 설명을참고해주시기바랍니다..) event_func 은사용자가정의한이벤트함수입니다. NEvent.removeListener(mapObj, click, clicked); NMark Constructor NMark(point, icon) 새로운마크 (mark) 객체를생성합니다. 파라미터 point는 NPoint의객체입니다. icon은 NIcon의객체입니다. var iconurl = ; var iconsize = new NSize(30, 30); var markobj = new NMark(new Point(1000, 1000), new NIcon(iconurl, iconsize)); 43

45 NAVER open API 지도 API Method setzindex(zindex) 현재마크 (mark) 의 CSS z_index 값을설정합니다. 파라미터 zindex 는마크간의출력순서를정하는정수입니다. zindex 값이클수록앞에출력됩니다. markobj.setzindex(100); settargeturl(url) 현재마크 (mark) 를클릭할때띄울새창의 URL 을설정합니다. 만일이값이설정되어있지않으면클릭해도아무런반응을하지않습니다. 파라미터 url 은새창의 URL 입니다. markobj.settargeturl( ); unsettargeturl() 현재마크에설정된새창의 URL 값을삭제합니다. markobj.unsettargeturl(); setpoint(point) 현재마크 (mark) 의위치를주어진 point 객체로설정하고마크의위치를화면에반영합니다. 파라미터 point 는 NPoint 클래스의객체입니다. markobj.setpoint(new Point(1000, 1000)); getpoint() 현재마크의 (mark) 의위치를 NPoint 클래스의객체로반환합니다. 반환값 NPoint / 현재마크의위치입니다. var newpoint = markobj.getpoint(); hide() 현재마크 (mark) 를화면에서숨깁니다. markobj.hide(); show() 현재마크 (mark) 를화면에출력합니다. markobj.show(); 44

46 NAVER open API 지도 API Event click 현재마크 (mark) 를마우스로클릭하였을때발생합니다. mousedown 현재마크 (mark) 위에서마우스가아래로이동할때발생합니다. mouseup 현재마크 (mark) 위에서마우스가위로이동할때발생합니다. mouseover 현재마크 (mark) 위에마우스가위치할때발생합니다. 이이벤트핸들러는현재마우스가위치한포인트값을파라미터로받습니다. 전달값 NPoint / 현재마우스가위치한포인트입니다. mouseout 현재마크 (mark) 밖으로마우스가이동할때발생합니다. NIcon Constructor NIcon(src, size [,offset]) 새로운아이콘 (icon) 객체를생성합니다. 파라미터 src는아이콘에사용할이미지의 URL입니다. size는 NSize 클래스의객체로아이콘객체의사이즈입니다. offset은아이콘이출력될위치의사이즈입니다. 이값이설정되지않으면 size의값의 1/2로 offset값을설정합니다. var iconobj = new NIcon( new Size(50, 50) 45

47 NAVER open API 지도 API NInfoWindow Constructor NInfoWindow() 새로운정보창객체를생성합니다. var winobj = new NInfoWindow(); Method setopacity(opacity) 현재정보창의투명도를설정합니다. 파라미터 opacity 는 0 과 1 사이의실수입니다. 0 에가까울수록투명해집니다. winobj.setopacity(0.5); set(point, content) 현재정보창의위치와내용을설정합니다. 파라미터 point 는 NPoint 클래스의객체입니다. content 는정보창을설명하는 String 형입니다. winobj.set(new Point(1000, 1000), NAVER OpenAPI ); showwindow() 해당정보창을지도위에출력합니다. winobj.showwindow(); hidewindow() 해당정보창을지도에서숨깁니다. winobj.hidewindow(); getpoint() 현재정보창의위치값을반환합니다. 반환값 NPoint / 현재정보창의위치값입니다. var point = winobj.getpoint(); 46

48 NAVER open API 지도 API delayhidewindow([delaytime]) 현재정보창을지정된 delaytime 이지난후에숨깁니다. 파라미터 delaytime 은지연시간입니다. 단위는 ms 입니다. delaytime 값이설정되지않으면기본값은 500ms 입니다. winobj.delayhidewindow(500); Event mouseover 현재정보창위에마우스가위치할때발생합니다. mouseout 현재정보창밖으로마우스가이동할때발생합니다. NPolyline Constructor NPolyline() 새로운폴리라인 (polyline) 객체를생성합니다. var plobj = new Polyline(); Method setweight(weight) 현재폴리라인 (polyline) 의선굵기를설정합니다. 파라미터 weight 은정수인픽셀값입니다. plobj.setweight(5); getweight() 현재폴리라인 (polyline) 의선굵기를반환합니다. 반환값 Number / 현재폴리라인의선굵기입니다. var weight = plobj.getweight(); 47

49 NAVER open API 지도 API addpoints(...) 현재폴리라인 (polyline) 에여러개의 point 객체를추가합니다. 폴리라인은여러개의점을선으로연결한도형입니다. 따라서제한없이여러개의 point 객체를추가할수있습니다. 즉 addpoint(new NPoint(100,100)) 과같은한개의 point 객체만추가할수있고 addpoint(new NPoint(100,100), new NPoint(200,200), new NPoint(100,0)) 와같이여러개의 point 객체를추가할수있습니다. 파라미터여러개의 point 객체입니다. plobj.addpoints(new NPoint(0, 0), new NPoint(100, 0)); getbound() 현재폴리라인 (polyline) 에추가된 point 객체들을가지고가장작게그려지는직사각형의경계 (boundary) 를배열 (Array) 형태로반환 합니다. 반환값 Array(left, top, right, bottom) left, top, right, bottom 은각각경계영역의좌측, 정상, 우측, 바닥가장자리의좌표값입니다. var bounds = plobj.getbound(); show() 현재지도에폴리라인 (polyline) 을출력합니다. plobj.show(); hide() 현재지도에서폴리라인 (polyline) 을숨깁니다. plobj.hide(); setopacity(opacity) 현재폴리라인객체의투명도를설정합니다. 파라미터 opacity 는 0 과 1 사이의실수입니다. 0 에가까울수록투명해집니다. plobj.setopacity(0.5); getopacity() 현재폴리라인객체의투명도값을 0 과 1 사이의실수로반환합니다. 반환값 Number / 현재폴리라인객체의투명도값입니다. var opacity = plojb.getopacity(); 48

50 NAVER open API 지도 API setcolor(color) 현재폴리라인객체의선색깔을설정합니다. 파라미터 color 은선색깔을표현하는 RGB 값인문자열입니다. 예를들어 '#FF0000', '#00FF00' 와같이사용합니다. plobj.setcolo ( #FFFF00 ); getcolor() 현재폴리라인객체의선색깔을 RGB 값으로표현된문자열로반환합니다. 반환값 String / RGB 값으로표현된현재폴리라인객체의선색깔입니다. var color = plobj.getcolor(); NXmlhttp Constructor NXmlhttp() 새로운 NXmlhttp 클래스의객체를생성합니다. var xmlobj = new NXmlhttp(); Method settype(type) 특정 URL 로부터반환받을문서의유형을설정합니다. 파라미터 type 은 0 또는 1 인정수입니다. 0 이면 text, 1 이면 xml 형식으로반환합니다. xmlobj.settype(1); loadhttp(url, returnfunc,...) url 로제공된 URL 에서문서를요청하여, 그결과를 returnfunc 전달합니다. 추가파라미터들은 returnfunc 에전달할때, 같이전달됩 니다. 주의 ) 스크립트를실행하는서버의도메인과 url 의도메인이일치하여야만값을가져올수있습니다. 파라미터 url 을호출하여그결과를 returnfunc 에전달합니다. 추가파라미터들은 returnfunc 에전달할때, 파라미터로전달됩니다. xmlobj.loadhttp( processxml ); 49

51 NAVER open API 지도 API NZoomControl Constructor NZoomControl() 새로운 NZoomControl 클래스의객체를생성합니다. 이객체는 NMap 클래스의객체에 addcontrol method를통해추가되어사용될수있습니다. var zcobj = new NZoomControl(); Method setalign(position) 현재컨트롤의지도내에서의수평위치를지정합니다. 파라미터 position 은미리지정된문자열입니다. "left", "center", "right" 의세가지값이있으며각각왼쪽, 중앙, 오른쪽위치를지 정합니다. zcobj.setalign( center ); setvalign(position) 현재컨트롤의지도내에서의수직위치를지정합니다. 파라미터 position 은미리지정된문자열입니다. "top", "center", "bottom" 의세가지값이있으며각각위, 중앙, 아래위치를지정 합니다. zcobj.setvalign( center ); NSaveBtn Constructor NSaveBtn() 새로운 NSaveBtn 클래스의객체를생성합니다. 이객체는 NMap 클래스의객체에 addcontrol method를통해추가되어사용될수있습니다. var sbobj = new SaveBtn() 50

52 NAVER open API 지도 API Method setalign(position) 현재컨트롤의지도내에서의수평위치를지정합니다. 파라미터 position 은미리지정된문자열입니다. "left", "center", "right" 의세가지값이있으며각각왼쪽, 중앙, 오른쪽위치를지 정합니다. sbobj.setalign( center ); setvalign(position) 현재컨트롤의지도내에서의수직위치를지정합니다. 파라미터 position 은미리지정된문자열입니다. "top", "center", "bottom" 의세가지값이있으며각각위, 중앙, 아래위치를지정 합니다. sbobj.setvalign( center ); NIndexMap Constructor NIndexMap() 새로운 NIndexMap 클래스의객체를생성합니다. 이객체는 NMap 클래스의객체에 addcontrol method를통해추가되어사용될수있습니다. 추가되면지도에인덱스맵을보여줍니다. var imobj = new NIndexMap(); Method setalign(position) 현재컨트롤의지도내에서의수평위치를지정합니다. 파라미터 position 은미리지정된문자열입니다. "left", "center", "right" 의세가지값이있으며각각왼쪽, 중앙, 오른쪽위치를지 정합니다. imobj.setalign( center ); setvalign(position) 현재컨트롤의지도내에서의수직위치를지정합니다. 파라미터 position 은미리지정된문자열입니다. "top", "center", "bottom" 의세가지값이있으며각각위, 중앙, 아래위치를지정 합니다. imobj.setvalign( center ); 51

53 NAVER open API 지도 API 주소좌표변환 주소좌표변환은주소를입력할경우그에해당하는좌표를반환하는기능입니다. 이기능은지도 API 의다른 class 들과는달리서버에 서동작합니다. 따라서아래에제공되는 url 에요청변수를넣어서획득한결과 xml 파일을활용하여좌표정보를구해야합니다. 요청 URL 및변수 (request url and parameter) 지도용 OpenAPI 키 &query= 경기도성남시정자 1 동 25-1 변수명 설명 key 이용등록을통해받은지도용 OpenAPI 키입니다. query 좌표변환을원하는주소를입력합니다. 표 50 주소좌표변환요청변수목록 출력결과필드 (response field) 필드명 형식 설명 geocode 전체주소목록을포함하는컨테이너입니다. userquery string 사용자가질의한주소입니다. total integer 사용자가질의한주소에해당되는주소목록의개수입니다. item 전체주소목록에포함되는개별주소를포함하는컨테이너입니다. point 개별주소의 x, y좌표값을포함하는컨테이너입니다. x integer 개별주소의 x좌표값입니다. y integer 개별주소의 y좌표값입니다. address string 개별주소전체를제공합니다. addrdetail 개별주소를분리하여제공하는항목들을포함하는컨테이너입니다. sido string 개별주소가속한특별시 / 광역시 / 도정보입니다. sigugun string 개별주소가속한시 / 구 / 군정보입니다. dongmyun string 개별주소가속한동 / 면정보입니다. rest string 개별주소의나머지정보입니다. 표 51 주소좌표변환출력필드목록 에러메시지 에러코드 에러메시지 설명 010 Your query request 쿼리요청제한을초과하였습니다. 일반적으로는 5,000개이상의쿼리에대하여 count is over the limit 이에러메시지가발생되나, 쿼리제한이다르게설정된경우에는이에준하여발생됩니다. 011 Incorrect query 잘못된쿼리요청입니다. 쿼리 (query=) 필드자체가없는경우발생하는 request 에러메시지입니다....&query=& 식으로입력하는경우정상적인쿼리요청으로보고, 에러메시지를발생하지않으며, " 에대한검색을수행합니다. 020 Unregistered key 등록되지않은키입니다. 200 Reserved 표 52 주소좌표변환에러메시지 52

54