openapi.navercfs5.tistory.com/upload_control/download.blog?fhandle... · 2015-01-22 · 24...

openapi.naver.com

검색 결과 서비스 / 07

08 지식IN 검색

요청 URL 및 변수 (request url and parameter) / 08

출력 결과 필드 (response field) / 08

09 블로그 검색



10 전문 자료 검색



11 한국 웹 문서 검색



12 책 검색


상세 검색 요청 URL 및 변수

(request url and parameter) / 12

책 카테고리 / 13


15 쇼핑 검색



16 국어 사전 검색



17 일어 사전 검색



18 영어 사전 검색



Contents

NAVER open API

19 내 PC 검색

내 PC 검색에서 사용되는 공통 요소 / 19

출력 결과 필드 (response field) 19

공통적으로 사용되는 카테고리 정보 19

20 openapi_search



21 openapi_datacache



21 openapi_status



22 openapi_latestdoc



22 openapi_landmark



23 openapi_extinfo



24 openapi_property


24 openapi_open


24 openapi_readmail


25 openapi_getoption



검색 관련 기능 / 26

27 실시간 검색어



28 추천 검색어



29 성인 검색어 판별



30 오타 변환



31 바로 가기



에러 메시지 / 32

33 에러 메시지

지도 API / 34

35 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

disableDrag() 37

enableWheelZoom() 37

disableWheelZoom() 37

addControl(control) 37

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 39

39 NSize

Constructor / 39

NSize(width, height) 39

Method / 40

set(width, height) 40

setWidth(width) 40

setHeight(height) 40

getWidth() 40

getHeight() 40

add(width_dx, height_dx) 41

equals(size) 41

copy() 41

41 NPoint

Constructor / 41

NPoint(x, y) 41

Method / 41

set(x, y) 41

setX(x) 41

setY(y) 42

getX() 42

getY() 42

add(x_dx, y_dx) 42

distance(x, y) 42

equals(point) 42

copy() 43

43 NEvent

Static method / 43

addListener(event_src, event_name, event_func) 43

removeListener(event_src, event_name, event_func) 43

43 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 45

mouseover 45

mouseout 45

45 NIcon

Constructor / 45

NIcon(src, size [,offset]) 45

46 NInfoWindow

Constructor / 46

NInfoWindow() 46

Method / 46

setOpacity(opacity) 46

set(point, content) 46

showWindow() 46

hideWindow() 46

getPoint() 46

delayHideWindow([delayTime]) 47

Event / 47

mouseover 47

mouseout 47

47 NPolyline

Constructor / 47

NPolyline() 47

Method / 47

setWeight(weight) 47

getWeight() 47

addPoints(...) 48

getBound() 48

show() 48

hide() 48

setOpacity(opacity) 48

getOpacity() 48

setColor(color) 49

getColor() 49

49 NXmlhttp

Constructor / 49

NXmlhttp() 49

Method / 49

setType(type) 49

loadhttp(url, returnFunc, ...) 49

50 NZoomControl

Constructor / 50

NZoomControl() 50

Method / 50

setAlign(position) 50

setValign(position) 50

50 NSaveBtn

Constructor / 50

NSaveBtn() 50

Method / 51



51 NIndexMap

Constructor / 51

NIndexMap() 51

Method / 51



52 주소 좌표 변환



에러 메시지 / 52

표 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

검색 결과 서비스

요청 URL 및 변수 (request url and parameter)

http://openapi.naver.com/search?key=검색용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 검색 출력 필드 목록

지식iN 검색

지식iN 검색은 지식인의 데이터를 검색할 수 있는 API 입니다.

NAVER open API | 검색 결과 서비스

08


http://openapi.naver.com/search?key=검색용OpenAPI키&target=blog&query=검색하고자하는키워드&display=10&star

t=1&sort=sim

변수 명 설명


target 블로그를 검색하기 위해서 이 값은 항상 blog 이어야 합니다.



기본값: 10

최대값: 100


기본값: 1

최대값: 1000


sim: 유사도순

date: 날짜순

표 3 블로그 검색 요청 변수 목록




RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다.













표 4 블로그 검색 출력 필드 목록

블로그 검색

블로그 검색은 블로그의 데이터를 검색할 수 있는 API 입니다.


09


http://openapi.naver.com/search?key=검색용OpenAPI키&target=doc&query=검색하고자하는키워드

&display=10&start=1

변수 명 설명


target 전문 자료를 검색하기 위해서 이 값은 항상 doc 이어야 합니다.



기본값: 10

최대값: 100


기본값: 1

최대값: 1000

표 5 전문 자료 검색 요청 변수 목록

















표 6 전문 자료 검색 출력 필드 목록

전문 자료 검색

전문 자료 검색은 전문 자료의 데이터를 검색할 수 있는 API 입니다.


10


http://openapi.naver.com/search?key=검색용OpenAPI키&target=webkr&query=검색하고자하는키워드

&display=10&start=1

변수 명 설명


target 한국 웹 문서를 검색하기 위해서 이 값은 항상 webkr 이어야 합니다.



기본값: 10

최대값: 100


기본값: 1

최대값: 1000

표 7 한국 웹 문서 검색 요청 변수 목록

















표 8 한국 웹 문서 검색 출력 필드 목록

한국 웹 문서 검색

한국 웹 문서 검색은 한국 웹 문서의 데이터를 검색할 수 있는 API 입니다.


11


http://openapi.naver.com/search?key=검색용OpenAPI키&target=book&query=검색하고자하는키워드

&display=10&start=1

변수 명 설명


target 책을 검색하기 위해서 이 값은 항상 book 이어야 합니다.



기본값: 10

최대값: 100


기본값: 1

최대값: 1000


sim: 유사도 순

date: 날짜 순

count: 판매량 순

표 9 책 검색 요청 변수 목록

상세 검색 요청 URL 및 변수 (request url and parameter)

http://openapi.naver.com/search?key=검색용OpenAPI키&target=book_adv&query=검색하고자하는키워드&display=1

0&start=1&d_title=XXX&d_catg=YYY

변수 명 설명


target 한국 웹 문서를 검색하기 위해서 이 값은 항상 book_adv 이어야 합니다.


d_titl 책 제목에서의 검색을 의미합니다.

d_auth 저자명에서의 검색을 의미합니다.

d_cont 목차에서의 검색을 의미합니다.

d_isbn ISBN에서의 검색을 의미합니다.

d_publ 출판사에서의 검색을 의미합니다.

d_dafr 검색을 원하는 책의 출간 범위를 지정합니다. (시작일) (e.g. 20000101)

d_dato 검색을 원하는 책의 출간 범위를 지정합니다. (종료일) (e.g. 20061231)

d_catg 검색을 원하는 카테고리를 지정합니다.

책 검색

책 검색은 책에 대한 데이터를 검색할 수 있는 API 입니다.


12


기본값: 10

최대값: 100


기본값: 1

최대값: 1000


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

큐레이터학/예술행정 401


13

미술 402

건축/인테리어 403

디자인 404

공예 405

패션 406

사진 407

영화 408

애니메이션/만화 409

라이프 스타일 410

기법서/사전 411

한국문화 소개서 412

음악 413

아동 미술 414

잡지 5

국내잡지 501

해외잡지 502

만화 6 표 11 책 상세 검색 카테고리















image string 썸네일 이미지의 URL입니다. 이미지가 있는 경우만 나타납니다.

author string 저자정보입니다.

price integer 가격정보입니다. 절판도서 등으로 가격이 없으면 나타나지 않습니다.

discount integer 할인가 정보입니다. 절판도서 등으로 가격이 없으면 나타나지 않습니다.

publisher string 출판사 정보입니다.

pubdate date 출간일 정보입니다.

isbn integer ISBN 정보입니다.



표 12 책 검색 출력 필드 목록


14


http://openapi.naver.com/search?key=검색용OpenAPI키&target=shop&query=검색하고자하는키워드

&display=10&start=1

변수 명 설명


target 쇼핑 데이터를 검색하기 위해서 이 값은 항상 shop 이어야 합니다.



기본값: 10

최대값: 100


기본값: 1

최대값: 1000


sim: 유사도 순

date: 날짜 순

asc: 가격 오름차순

dsc: 가격 내림차순

표 13 한국 웹 문서 검색 요청 변수 목록















image string 썸네일 이미지의 URL입니다. 이미지가 있는 경우에만 나타납니다.

lprice integer 최저가 정보입니다. 가격 정보가 있는 경우에만 나타납니다.

hprice integer 최고가 정보입니다. 가격 정보가 있는 경우에만 나타납니다.

표 14 한국 웹 문서 검색 출력 필드 목록

쇼핑 검색

쇼핑 검색은 NAVER 쇼핑에 등록된 상품의 데이터를 검색할 수 있는 API 입니다.


15


http://openapi.naver.com/search?key=검색용OpenAPI키&target=krdic&query=검색하고자하는키워드

&display=10&start=1

변수 명 설명


target 국어 사전을 검색하기 위해서 이 값은 항상 krdic 이어야 합니다.



기본값: 10

최대값: 100


기본값: 1

최대값: 1000

표 15 국어 사전 검색 요청 변수 목록















표 16 국어 사전 검색 출력 필드 목록

국어 사전 검색

국어 사전 검색은 NAVER의 국어 사전을 검색할 수 있는 API 입니다.


16


http://openapi.naver.com/search?key=검색용OpenAPI키&target=jpdic&query=검색하고자하는키워드

&display=10&start=1

변수 명 설명


target 일어 사전을 검색하기 위해서 이 값은 항상 jpdic 이어야 합니다.



기본값: 10

최대값: 100


기본값: 1

최대값: 1000

표 17 일어 사전 검색 요청 변수 목록















표 18 일어 사전 검색 출력 필드 목록

일어 사전 검색

일어 사전 검색은 NAVER의 일어 사전을 검색할 수 있는 API 입니다.


17


http://openapi.naver.com/search?key=검색용OpenAPI키&target=endic&query=검색하고자하는키워드

&display=10&start=1

변수 명 설명


target 영어 사전을 검색하기 위해서 이 값은 항상 endic 이어야 합니다.



기본값: 10

최대값: 100


기본값: 1

최대값: 1000

표 19 영어 사전 검색 요청 변수 목록















표 20 영어 사전 검색 출력 필드 목록

영어 사전 검색

영어 사전 검색은 NAVER의 영어 사전을 검색할 수 있는 API 입니다.


18

내 PC 검색에서 사용되는 공통 요소


출력은 표준 형식인 RSS 2.0 형식(http://blogs.law.harvard.edu/tech/rss)을 따릅니다. 표준 RSS에 내PC검색 API용으로 추가

된 태그는 nns XML namespace를 가집니다.






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 email 이메일

8 etc 기타파일

9 timeline 타임라인 표 22 내 PC 검색에서 사용되는 카테고리 목록

내 PC 검색

내 PC 검색은 내PC검색(http://mypc.naver.com)을 설치했을 경우

내 PC의 자료를 검색할 수 있는 API 입니다.


19

openapi_serch

검색을 요청합니다.


http://127.0.0.1:3001/openapi_search?where=desktop&query=nhn&start=1&display=10

변수 명 설명

where 검색할 카테고리를 지정합니다.

기본값: desktop

query 검색할 질의어를 입력합니다. URL encoding이 되어 있어야 합니다.


기본값: 1


기본값: 환경설정에 지정된 개수

ds 검색 시작일자 (e.g. 20060101)

de 검색 종료일자 (e.g. 20061231)

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 요청 변수 목록



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

openapi_datacache

썸네일 데이터를 Base64 인코딩 형태로 가져옵니다.


http://127.0.0.1:3001/openapi_datacache?h=1&l=1

변수 명 설명

h 데이터의 offset. 검색 결과의 값(nns:subdocoffset)을 사용합니다.

l 데이터의 size. 검색결과의 값(nns:subdocoffset)을 사용합니다.

표 25 내 PC 검색 openapi_datacache 요청 변수 목록



nns:thumbnail Base 64 encoded string 인코딩된 thumbnail 이미지

표 26 내 PC 검색 openapi_datacache 출력 필드 목록

openapi_status

현재 색인 상태에 대한 정보를 가져옵니다.


http://127.0.0.1:3001/openapi_status



nns:progress percent 색인 진행률

nns:totaldocnum integer 전체 색인 문서 개수

nns:catstatus compound tag 각 카테고리별 색인 상태. catid: 카테고리 ID

nns:docnum integer 카테고리별 문서 개수

nns:docdate docdate 마지막 문서 갱신 날짜

표 27 내 PC 검색 openapi_status 출력 필드 목록


21

openapi_latestdoc

최근 문서에 대한 정보를 가져옵니다.


http://127.0.0.1:3001/openapi_latestdoc

변수 명 설명

where 카테고리를 지정합니다.

기본값: desktop

display 출력건수를 지정합니다.

기본값: 환경 설정에 지정된 개수

표 28 내 PC 검색 openapi_status 요청 변수 목록




link URL 웹 페이지 또는 파일의 위치를 나타내는 URL

description string 검색 속도 향상을 위해 이 값은 출력되지 않습니다.









nns:extentionid extention ID 문서의 확장자 타입. 타입 id는 openapi_extinfo로 받아올 수 있습니다.


표 29 내 PC 검색 openapi_latestdoc 출력 필드 목록

openapi_landmark

랜드마크 정보를 가져옵니다.


http://127.0.0.1:3001/openapi_landmark

변수 명 설명

doc 기준 문서의 ID 표 30 내 PC 검색 openapi_landmark 요청 변수 목록


22




link URL 웹페이지 또는 파일의 위치를 나타내는 URL

description string 검색결과. 검색어가 강조 표시됩니다.









nns:extentionid extension ID 문서의 확장자 타입. 타입 id는 openapi_extinfo로 받아올 수 있습니다.


표 31 내 PC 검색 openapi_landmark 출력 필드 목록

openapi_extinfo

카테고리별로 색인되는 확장자 목록을 가져옵니다.


http://127.0.0.1:3001/openapi_extinfo

변수 명 설명

where 카테고리를 지정합니다.

기본값: desktop 표 32 내 PC 검색 openapi_extinfo 요청 변수 목록



nns:extinfo compound tag 각 카테고리별 확장자 정보

catid: 카테고리 ID

nns:ext string 색인되는 확장자

id: 확장자의 ID 표 33 내 PC 검색 openapi_extinfo 출력 필드 목록


23

openapi_property

파일의 속성 창을 엽니다.


http://127.0.0.1:3001/openapi_property

변수 명 설명

path 속성 창을 열 파일의 절대 경로 표 34 내 PC 검색 openapi_property 요청 변수 목록

openapi_open

파일을 엽니다. 파일 오픈 프로그램은 탐색기의 연결 프로그램 설정을 따릅니다.


http://127.0.0.1:3001/openapi_open

변수 명 설명

path 열 파일의 절대 경로 표 35 내 PC 검색 openapi_open 요청 변수 목록

openapi_readmail

이메일 문서를 Outlook, OutlookExpress 등의 이메일 클라이언트 프로그램으로 엽니다.


http://127.0.0.1:3001/openapi_readmail

변수 명 설명

eid 열 문서의 entry ID. 검색 결과의 <nns:metainfo name=”entry_id”>의 값을 사용합니다.

표 36 내 PC 검색 openapi_readmail 요청 변수 목록


24

openapi_getoption

환경설정 정보를 가져옵니다.


http://127.0.0.1:3001/openapi_getoption

변수 명 설명

type 가져올 항목. all, cat_order, displayno, disablefo, disablefe, disablenexearch

기본값: all

표 37 내 PC 검색 openapi_getoption 요청 변수 목록



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

검색 관련 기능


http://openapi.naver.com/search?key=검색용OpenAPI키&target=rank&query=검색어분류

변수 명 설명


target 실시간 검색어를 이용하기 위해서 이 값은 항상 rank 이어야 합니다.

query 보기를 원하는 분류를 입력합니다.

nexearch: 통합검색

cafeblog: 카페, 블로그 검색

dic: 사전 검색

image: 이미지 검색

kin: 지식iN 검색

music: 음악 검색

video: 동영상 검색

webkr: 웹 문서 검색

news: 뉴스 검색

표 39 실시간 검색어 요청 변수 목록



R숫자 R1 ~ R10은 순위를 나타냅니다.

R1: 1위

R10: 10위

K string 키워드

S string 순위의 증감 여부

+: 증가

-: 감소

new: 새로운 순위

V integer 변동 값. 0 인 경우 새로운 순위를 의미합니다.

표 40 실시간 검색어 출력 필드 목록

NAVER open API | 검색 관련 기능

실시간 검색어

실시간 검색어는 현재 NAVER에서 많이 검색되고 있는 검색어들을

순서대로 10위까지 보여주는 API 입니다.

27


http://openapi.naver.com/search?key=검색용OpenAPI키&target=recmd&query=검색하고자하는키워드

변수 명 설명


target 추천 검색어를 이용하기 위해서 이 값은 항상 recmd 이어야 합니다.


표 41 추천 검색어 요청 변수 목록



item string 추천 검색어입니다. 이 엘리먼트를 반복적으로 읽어 다수의 추천 검색어를

얻을 수 있습니다.

표 42 추천 검색어 출력 필드 목록


추천 검색어

추천 검색어는 입력한 검색어에 대해서 NAVER에서 추천하는 검색어들의 목록을

보여주는 API입니다.

28


http://openapi.naver.com/search?key=검색용OpenAPI키&target=adult&query=검색하고자하는키워드

변수 명 설명


target 성인 검색어 판별을 이용하기 위해서 이 값은 항상 adult 이어야 합니다.


표 43 성인 검색어 판별 요청 변수 목록



adult integer 성인 키워드의 해당 여부입니다.

0: 비성인 키워드

1: 성인 키워드

표 44 성인 검색어 판별 출력 필드 목록


성인 검색어 판별

성인 검색어 판별은 입력한 검색어에 대해서 NAVER에서 성인 키워드 해당 여부를

알려주는 API입니다.

29


http://openapi.naver.com/search?key=검색용OpenAPI키&target=errata&query=검색하고자하는키워드

변수 명 설명


target 오타 변환을 이용하기 위해서 이 값은 항상 errata 이어야 합니다.


표 45 오타 변환 요청 변수 목록



errata string 오타 변환 결과. 결과가 없으면 빈 문자열이 됩니다.

표 46 오타 변환 출력 필드 목록


오타 변환

오타 변환은 입력한 검색어가 맞춤법에 맞지 않을 경우 맞춤법에 맞는 단어를 추천하는 API입니다.

30

바로 가기

바로 가기는 입력한 검색어에서 바로 연결될 수 있는 사이트의 정보를 가져올 수 있는 API입니다.


http://openapi.naver.com/search?key=검색용OpenAPI키&target=shortcut&query=검색하고자하는키워드

변수 명 설명


target 바로 가기를 이용하기 위해서 이 값은 항상 shortcut 이어야 합니다.


표 47 바로 가기 요청 변수 목록



shortcut string 결과가 없으면 빈 문자열이 됩니다.

label string 바로 가기로 연결될 사이트 명 입니다.

url string 바로 가기로 열릴 사이트 url 입니다.

표 48 바로 가기 출력 필드 목록


31

에러 메시지

에러 메시지

지식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 공통 에러 메시지

NAVER open API | 에러 메시지

33

지도 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));

NAVER open API | 지도 API

35

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입니다.


예제 mapObj.setMinLevel(2);

setMaxLevel(zoom_level)현재 지도의 최대 축적 수준(zoom level)을 설정합니다. 기본 값은 11입니다.


예제 mapObj.setMaxLevel(10);


36

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, NInfoWindow 또는 NPolyline 클래스

의 객체입니다. key는 String형이며 여러 개의 overlay에 연결해서 사용할 수 있습니다.

예제 mapObj.addOverlay(new NInfoWindow;


37

removeOverlay(overlay)현재 지도에서 지정된 overlay을 제거합니다.

파라미터 overlay는 NMark, NInfoWindow 또는 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

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

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

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좌표를 설정합니다.


예제 pointObj.set(2000, 2000);

setX(x)현재 포인트(point)의 X좌표를 설정합니다.

파라미터 x는 포인트의 X좌표입니다.

예제 pointObj.setX(2000);


41

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좌표입

니다.


반환값 Number / 현재 포인트와 파라미터로 제공된 포인트 사이의 거리입니다.

예제 var distance = pointObj.distance(4000, 4000);

equals(point)현재 포인트(point)와 파라미터로 제공된 포인트 객체의 값이 같은지 판단합니다.


반환값 Boolean / 현재 포인트와 파라미터로 제공된 포인트의 값이 같으면 true, 그렇지 않으면 false를 반환합니다.

예제 var result = pointObj.equals(new NPoint(1500, 1500));


42

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 = ‘http://openapi.naver.com/sample.gif’;

var iconSize = new NSize(30, 30);

var markObj = new NMark(new NPoint(1000, 1000), new NIcon(iconurl, iconSize));


43

Method

setZindex(zindex)현재 마크(mark)의 CSS z_index 값을 설정합니다.

파라미터 zindex는 마크 간의 출력순서를 정하는 정수입니다. zindex 값이 클수록 앞에 출력됩니다.

예제 markObj.setZIndex(100);

setTargeturl(url)현재 마크(mark)를 클릭할 때 띄울 새 창의 URL을 설정합니다. 만일 이 값이 설정되어 있지 않으면 클릭해도 아무런 반응을 하지 않습니다.

파라미터 url은 새 창의 URL입니다.

예제 markObj.setTargeturl(‘http://openapi.naver.com’);

unsetTargeturl()현재 마크에 설정된 새 창의 URL 값을 삭제합니다.

예제 markObj.unsetTargeturl();

setPoint(point)현재 마크(mark)의 위치를 주어진 point 객체로 설정하고 마크의 위치를 화면에 반영합니다.


예제 markObj.setPoint(new NPoint(1000, 1000));

getPoint()현재 마크의(mark)의 위치를 NPoint 클래스의 객체로 반환합니다.

반환값 NPoint / 현재 마크의 위치입니다.

예제 var newPoint = markObj.getPoint();

hide()현재 마크(mark)를 화면에서 숨깁니다.

예제 markObj.hide();

show()현재 마크(mark)를 화면에 출력합니다.

예제 markObj.show();


44

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(‘http://openapi.naver.com/sample.gif’, new NSize(50, 50)


45

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 NPoint(1000, 1000), ‘NAVER OpenAPI’);

showWindow()해당 정보 창을 지도 위에 출력합니다.

예제 winObj.showWindow();

hideWindow()해당 정보 창을 지도에서 숨깁니다.

예제 winObj.hideWindow();

getPoint()현재 정보 창의 위치 값을 반환합니다.

반환값 NPoint / 현재 정보창의 위치 값입니다.

예제 var point = winObj.getPoint();


46

delayHideWindow([delayTime])현재 정보 창을 지정된 delayTime이 지난 후에 숨깁니다.

파라미터 delayTime은 지연시간입니다. 단위는 ms입니다. delayTime 값이 설정되지 않으면 기본값은 500ms입니다.

예제 winObj.delayHideWindow(500);

Event

mouseover현재 정보 창 위에 마우스가 위치할 때 발생합니다.

mouseout현재 정보 창 밖으로 마우스가 이동할 때 발생합니다.

NPolyline

Constructor

NPolyline()새로운 폴리라인(polyline) 객체를 생성합니다.

예제 var plObj = new NPolyline();

Method

setWeight(weight)현재 폴리라인(polyline)의 선 굵기를 설정합니다.

파라미터 weight은 정수인 픽셀 값입니다.

예제 plObj.setWeight(5);

getWeight()현재 폴리라인(polyline)의 선 굵기를 반환합니다.

반환값 Number / 현재 폴리라인의 선 굵기입니다.

예제 var weight = plObj.getWeight();


47

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

setColor(color)현재 폴리라인 객체의 선 색깔을 설정합니다.

파라미터 color은 선 색깔을 표현하는 RGB 값인 문자열입니다. 예를 들어 '#FF0000', '#00FF00'와 같이 사용합니다.

예제 plObj.setColor(‘#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(‘http://openapi.naver.com/test’, ‘processXML’);


49

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 NSaveBtn()


50

Method



정합니다.

예제 sbObj.setAlign(‘center’);



합니다.

예제 sbObj.setValign(‘center’);

NIndexMap

Constructor

NIndexMap()새로운 NIndexMap 클래스의 객체를 생성합니다. 이 객체는 NMap 클래스의 객체에 addControl method를 통해 추가되어 사용될 수

있습니다. 추가되면 지도에 인덱스 맵을 보여줍니다.

예제 var imObj = new NIndexMap();

Method



정합니다.

예제 imObj.setAlign(‘center’);



합니다.

예제 imObj.setValign(‘center’);


51


http://maps.naver.com/api/geocode.php?key=지도용OpenAPI키&query=경기도성남시정자1동25-1

변수 명 설명

key 이용 등록을 통해 받은 지도용 OpenAPI 키 입니다.

query 좌표 변환을 원하는 주소를 입력합니다.

표 50 주소 좌표 변환 요청 변수 목록



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

주소 좌표 변환

주소 좌표 변환은 주소를 입력할 경우 그에 해당하는 좌표를 반환하는 기능입니다. 이 기능은 지도 API의 다른 class들과는 달리 서버에

서 동작합니다. 따라서 아래에 제공되는 url에 요청 변수를 넣어서 획득한 결과 xml 파일을 활용하여 좌표 정보를 구해야 합니다.

openapi.navercfs5.tistory.com/upload_control/download.blog?fhandle... · 2015-01-22 · 24...

Documents

Transcript of openapi.navercfs5.tistory.com/upload_control/download.blog?fhandle... · 2015-01-22 · 24...