SlideShare una empresa de Scribd logo
1 de 54
Descargar para leer sin conexión
openapi.naver.com
Naver Open Api Reference Manual
NAVER open API




검색 결과 서비스 / 07
                                               Contents
08 지식IN 검색
요청 URL 및 변수 (request url and parameter) / 08
출력 결과 필드 (response field) / 08


09 블로그 검색
요청 URL 및 변수 (request url and parameter) / 09
출력 결과 필드 (response field) / 09


10 전문 자료 검색
요청 URL 및 변수 (request url and parameter) / 10
출력 결과 필드 (response field) / 10


11 한국 웹 문서 검색
요청 URL 및 변수 (request url and parameter) / 11
출력 결과 필드 (response field) / 11


12 책 검색
요청 URL 및 변수 (request url and parameter) / 12
상세 검색 요청 URL 및 변수
(request url and parameter) / 12
책 카테고리 / 13
출력 결과 필드 (response field) / 14


15 쇼핑 검색
요청 URL 및 변수 (request url and parameter) / 15
출력 결과 필드 (response field) / 15


16 국어 사전 검색
요청 URL 및 변수 (request url and parameter) / 16
출력 결과 필드 (response field) / 16


17 일어 사전 검색
요청 URL 및 변수 (request url and parameter) / 17
출력 결과 필드 (response field) / 17


18 영어 사전 검색
요청 URL 및 변수 (request url and parameter) / 18
출력 결과 필드 (response field) / 18
19 내 PC 검색                                     검색 관련 기능 / 26
내 PC 검색에서 사용되는 공통 요소 / 19
    출력 결과 필드 (response field)     19           27 실시간 검색어
    공통적으로 사용되는 카테고리 정보            19           요청 URL 및 변수 (request url and parameter) / 27
                                               출력 결과 필드 (response field) / 27
20 openapi_search
요청 URL 및 변수 (request url and parameter) / 20   28 추천 검색어
출력 결과 필드 (response field) / 20                 요청 URL 및 변수 (request url and parameter) / 28
                                               출력 결과 필드 (response field) / 28
21 openapi_datacache
요청 URL 및 변수 (request url and parameter) / 21   29 성인 검색어 판별
출력 결과 필드 (response field) / 21                 요청 URL 및 변수 (request url and parameter) / 29
                                               출력 결과 필드 (response field) / 29
21 openapi_status
요청 URL 및 변수 (request url and parameter) / 21   30 오타 변환
출력 결과 필드 (response field) / 21                 요청 URL 및 변수 (request url and parameter) / 30
                                               출력 결과 필드 (response field) / 30
22 openapi_latestdoc
요청 URL 및 변수 (request url and parameter) / 22   31 바로 가기
출력 결과 필드 (response field) / 22                 요청 URL 및 변수 (request url and parameter) / 31
                                               출력 결과 필드 (response field) / 31
22 openapi_landmark
요청 URL 및 변수 (request url and parameter) / 22
출력 결과 필드 (response field) / 23                 에러 메시지 / 32

23 openapi_extinfo                             33 에러 메시지
요청 URL 및 변수 (request url and parameter) / 23
출력 결과 필드 (response field) / 23

                                               지도 API / 34
24 openapi_property
요청 URL 및 변수 (request url and parameter) / 24   35 NMap
                                               Constructor / 35
24 openapi_open                                    NMap(container [,width] [,height])    35

요청 URL 및 변수 (request url and parameter) / 24   Method / 35
                                                   getBound()                            35

24 openapi_readmail                                setBound(left, top, right, bottom)    35

요청 URL 및 변수 (request url and parameter) / 24       setCenterAndZoom(point, zoom_level)   35

                                                   setCenter(point)                      35

25 openapi_getoption                               getCenter()                           36

요청 URL 및 변수 (request url and parameter) / 25       setZoom(zoom_level)                   36

출력 결과 필드 (response field) / 25                     getZoom()                             36

                                                   zoomIn()                              36

                                                   zoomOut()                             36

                                                   setMinLevel(zoom_level)               36

                                                   setMaxLevel(zoom_level)               36

                                                   enableDrag()                          37
disableDrag()                37   43 NEvent
    enableWheelZoom()            37   Static method / 43
    disableWheelZoom()           37       addListener(event_src, event_name, event_func)      43

    addControl(control)          37       removeListener(event_src, event_name, event_func)   43

    removeControl(control)       37

    addOverlay(overlay,[ key])   37   43 NMark
    removeOverlay(overlay)       38   Constructor / 43
    clearOverlays([key])         38       NMark(point, icon)                      43

    pan(x, y)                    38   Method / 44
Event / 38                                setZindex(zindex)                       44

    move                         38       setTargeturl(url)                       44

    drag                         38       unsetTargeturl()                        44

    startDrag                    38       setPoint(point)                         44

    endDrag                      38       getPoint()                              44

    click                        39       hide()                                  44

    dblclick                     39       show()                                  44

    mousemove                    39   Event / 45
    zoom                         39       click                                   45

    redraw                       39       mousedown                               45

                                          mouseup                                 45

39 NSize                                  mouseover                               45

Constructor / 39                          mouseout                                45

    NSize(width, height)         39

Method / 40                           45 NIcon
    set(width, height)           40   Constructor / 45
    setWidth(width)              40       NIcon(src, size [,offset])              45

    setHeight(height)            40

    getWidth()                   40   46 NInfoWindow
    getHeight()                  40   Constructor / 46
    add(width_dx, height_dx)     41       NInfoWindow()                           46

    equals(size)                 41   Method / 46
    copy()                       41       setOpacity(opacity)                     46

                                          set(point, content)                     46

41 NPoint                                 showWindow()                            46

Constructor / 41                          hideWindow()                            46

    NPoint(x, y)                 41       getPoint()                              46

Method / 41                               delayHideWindow([delayTime])            47

    set(x, y)                    41   Event / 47
    setX(x)                      41       mouseover                               47

    setY(y)                      42       mouseout                                47

    getX()                       42

    getY()                       42   47 NPolyline
    add(x_dx, y_dx)              42   Constructor / 47
    distance(x, y)               42       NPolyline()                             47

    equals(point)                42   Method / 47
    copy()                       43       setWeight(weight)                       47
getWeight()                      47   52 주소 좌표 변환
    addPoints(...)                   48   요청 URL 및 변수 (request url and parameter) / 52
    getBound()                       48   출력 결과 필드 (response field) / 52
    show()                           48   에러 메시지 / 52
    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
    setAlign(position)               51

    setValign(position)              51



51 NIndexMap
Constructor / 51
    NIndexMap()                      51

Method / 51
    setAlign(position)               51

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




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




요청 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 검색 출력 필드 목록



08
NAVER open API | 검색 결과 서비스




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




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

http://openapi.naver.com/search?key=검색용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
NAVER open API | 검색 결과 서비스




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




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

http://openapi.naver.com/search?key=검색용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
NAVER open API | 검색 결과 서비스




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




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

http://openapi.naver.com/search?key=검색용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
NAVER open API | 검색 결과 서비스




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




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

http://openapi.naver.com/search?key=검색용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)

http://openapi.naver.com/search?key=검색용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. 20000101)
d_dato                검색을 원하는 책의 출간 범위를 지정합니다. (종료일) (e.g. 20061231)
d_catg                검색을 원하는 카테고리를 지정합니다.




12
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
큐레이터학/예술행정                   401




13
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
NAVER open API | 검색 결과 서비스




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



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

http://openapi.naver.com/search?key=검색용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
NAVER open API | 검색 결과 서비스




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




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

http://openapi.naver.com/search?key=검색용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
NAVER open API | 검색 결과 서비스




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




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

http://openapi.naver.com/search?key=검색용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
NAVER open API | 검색 결과 서비스




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




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

http://openapi.naver.com/search?key=검색용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
NAVER open API | 검색 결과 서비스




내 PC 검색
내 PC 검색은 내PC검색(http://mypc.naver.com)을 설치했을 경우
내 PC의 자료를 검색할 수 있는 API 입니다.




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

출력 결과 필드 (response field)

출력은 표준 형식인 RSS 2.0 형식(http://blogs.law.harvard.edu/tech/rss)을 따릅니다. 표준 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                email             이메일
8                etc               기타파일
9                timeline          타임라인                            표 22 내 PC 검색에서 사용되는 카테고리 목록




19
NAVER open API | 검색 결과 서비스




openapi_serch
검색을 요청합니다.


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

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


변수 명                  설명
where                 검색할 카테고리를 지정합니다.
                      기본값: desktop
query                 검색할 질의어를 입력합니다. URL encoding이 되어 있어야 합니다.
start                 검색의 시작위치를 지정합니다.
                      기본값: 1
display               한번에 반환되는 검색 결과의 개수입니다.
                      기본값: 환경설정에 지정된 개수
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 요청 변수 목록




출력 결과 필드 (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
NAVER open API | 검색 결과 서비스




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


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

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


변수 명                 설명
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)

http://127.0.0.1:3001/openapi_status


출력 결과 필드 (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
NAVER open API | 검색 결과 서비스




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


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

http://127.0.0.1:3001/openapi_latestdoc


변수 명                  설명
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)

http://127.0.0.1:3001/openapi_landmark


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




22
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)

http://127.0.0.1:3001/openapi_extinfo


변수 명                  설명
where                 카테고리를 지정합니다.
                      기본값: desktop                                  표 32 내 PC 검색 openapi_extinfo 요청 변수 목록




출력 결과 필드 (response field)

필드 명                  형식                설명
nns:extinfo           compound tag      각 카테고리별 확장자 정보
                                        catid: 카테고리 ID
nns:ext               string            색인되는 확장자
                                        id: 확장자의 ID                 표 33 내 PC 검색 openapi_extinfo 출력 필드 목록




23
NAVER open API | 검색 결과 서비스




openapi_property
파일의 속성 창을 엽니다.


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

http://127.0.0.1:3001/openapi_property


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




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


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

http://127.0.0.1:3001/openapi_open


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




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


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

http://127.0.0.1:3001/openapi_readmail


변수 명                  설명
eid                   열 문서의 entry ID. 검색 결과의 <nns:metainfo name=”entry_id”>의 값을 사용합니다.
                                                                  표 36 내 PC 검색 openapi_readmail 요청 변수 목록




24
NAVER open API | 검색 결과 서비스




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


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

http://127.0.0.1:3001/openapi_getoption


변수 명                   설명
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
검색 관련 기능
NAVER open API | 검색 관련 기능




실시간 검색어
실시간 검색어는 현재 NAVER에서 많이 검색되고 있는 검색어들을
순서대로 10위까지 보여주는 API 입니다.



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

http://openapi.naver.com/search?key=검색용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
NAVER open API | 검색 관련 기능




추천 검색어
추천 검색어는 입력한 검색어에 대해서 NAVER에서 추천하는 검색어들의 목록을
보여주는 API입니다.



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

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


변수 명             설명
key              OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다.
target           추천 검색어를 이용하기 위해서 이 값은 항상 recmd 이어야 합니다.
query            검색하려는 질의문 입니다. UTF-8 형식이어야 합니다.
                                                                        표 41 추천 검색어 요청 변수 목록




출력 결과 필드 (response field)

필드 명             형식               설명
item             string           추천 검색어입니다. 이 엘리먼트를 반복적으로 읽어 다수의 추천 검색어를
                                  얻을 수 있습니다.
                                                                        표 42 추천 검색어 출력 필드 목록




28
NAVER open API | 검색 관련 기능




성인 검색어 판별
성인 검색어 판별은 입력한 검색어에 대해서 NAVER에서 성인 키워드 해당 여부를
알려주는 API입니다.



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

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


변수 명             설명
key              OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다.
target           성인 검색어 판별을 이용하기 위해서 이 값은 항상 adult 이어야 합니다.
query            검색하려는 질의문 입니다. UTF-8 형식이어야 합니다.
                                                                      표 43 성인 검색어 판별 요청 변수 목록




출력 결과 필드 (response field)

필드 명             형식                설명
adult            integer           성인 키워드의 해당 여부입니다.
                                   0: 비성인 키워드
                                   1: 성인 키워드
                                                                      표 44 성인 검색어 판별 출력 필드 목록




29
NAVER open API | 검색 관련 기능




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




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

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


변수 명             설명
key              OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다.
target           오타 변환을 이용하기 위해서 이 값은 항상 errata 이어야 합니다.
query            검색하려는 질의문 입니다. UTF-8 형식이어야 합니다.
                                                                           표 45 오타 변환 요청 변수 목록




출력 결과 필드 (response field)

필드 명             형식                설명
errata           string            오타 변환 결과. 결과가 없으면 빈 문자열이 됩니다.
                                                                           표 46 오타 변환 출력 필드 목록




30
NAVER open API | 검색 관련 기능




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




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

http://openapi.naver.com/search?key=검색용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
에러 메시지
NAVER open API | 에러 메시지




에러 메시지
지식iN 검색, 블로그 검색, 전문 자료 검색, 한국 웹 문서 검색, 책 검색, 쇼핑 검색, 국어 사전 검색, 일어 사전 검색, 영어 사전 검색, 실시
간 검색어, 추천 검색어, 성인 검색어 판별, 오타변환, 바로 가기에서 사용되는 에러 메시지는 모두 동일하며 그 내용은 아래의 표에서 확
인할 수 있습니다.




에러 코드          에러 메시지                    설명
000            System error              시스템 에러
010            Your query request        쿼리요청 제한을 초과하였습니다. 일반적으로는 5,000개 이상의 쿼리에 대하여
               count is over the limit   이 에러 메시지가 발생되나, 쿼리 제한이 다르게 설정된 경우에는 이에 준하여
                                         발생됩니다.
011            Incorrect query           잘못된 쿼리요청입니다. 쿼리(query=)필드 자체가 없는 경우 발생하는
               request                   에러 메시지 입니다. ‘...&query=&’ 식으로 입력하는 경우 정상적인
                                         쿼리 요청으로 보고, 에러 메시지를 발생하지 않으며, quot;에 대한 검색을 수행합니다.
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
지도 API
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
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
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
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
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
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
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
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
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 = ‘http://openapi.naver.com/sample.gif’;
         var iconSize = new NSize(30, 30);
         var markObj = new NMark(new Point(1000, 1000), new NIcon(iconurl, iconSize));




43
NAVER open API | 지도 API




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 객체로 설정하고 마크의 위치를 화면에 반영합니다.


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




45
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
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
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
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(‘http://openapi.naver.com/test’, ‘processXML’);




49
NAVER open API | 지도 API




NZoomControl

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


예제        var zcObj = new NZoomControl();




Method
setAlign(position)
현재 컨트롤의 지도 내에서의 수평 위치를 지정합니다.


파라미터      position은 미리 지정된 문자열입니다. quot;leftquot;, quot;centerquot;, quot;rightquot;의 세 가지 값이 있으며 각각 왼쪽, 중앙, 오른쪽 위치를 지
          정합니다.
예제        zcObj.setAlign(‘center’);




setValign(position)
현재 컨트롤의 지도 내에서의 수직 위치를 지정합니다.


파라미터      position은 미리 지정된 문자열입니다. quot;topquot;, quot;centerquot;, quot;bottomquot;의 세 가지 값이 있으며 각각 위, 중앙, 아래 위치를 지정
          합니다.
예제        zcObj.setValign(‘center’);




NSaveBtn

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


예제        var sbObj = new    SaveBtn()




50
NAVER open API | 지도 API




Method
setAlign(position)
현재 컨트롤의 지도 내에서의 수평 위치를 지정합니다.


파라미터    position은 미리 지정된 문자열입니다. quot;leftquot;, quot;centerquot;, quot;rightquot;의 세 가지 값이 있으며 각각 왼쪽, 중앙, 오른쪽 위치를 지
        정합니다.
예제      sbObj.setAlign(‘center’);




setValign(position)
현재 컨트롤의 지도 내에서의 수직 위치를 지정합니다.


파라미터    position은 미리 지정된 문자열입니다. quot;topquot;, quot;centerquot;, quot;bottomquot;의 세 가지 값이 있으며 각각 위, 중앙, 아래 위치를 지정
        합니다.
예제      sbObj.setValign(‘center’);




NIndexMap

Constructor
NIndexMap()
새로운 NIndexMap 클래스의 객체를 생성합니다. 이 객체는 NMap 클래스의 객체에 addControl method를 통해 추가되어 사용될 수
있습니다. 추가되면 지도에 인덱스 맵을 보여줍니다.


예제      var imObj = new NIndexMap();




Method
setAlign(position)
현재 컨트롤의 지도 내에서의 수평 위치를 지정합니다.


파라미터    position은 미리 지정된 문자열입니다. quot;leftquot;, quot;centerquot;, quot;rightquot;의 세 가지 값이 있으며 각각 왼쪽, 중앙, 오른쪽 위치를 지
        정합니다.
예제      imObj.setAlign(‘center’);




setValign(position)
현재 컨트롤의 지도 내에서의 수직 위치를 지정합니다.


파라미터    position은 미리 지정된 문자열입니다. quot;topquot;, quot;centerquot;, quot;bottomquot;의 세 가지 값이 있으며 각각 위, 중앙, 아래 위치를 지정
        합니다.
예제      imObj.setValign(‘center’);


51
NAVER open API | 지도 API




주소 좌표 변환
주소 좌표 변환은 주소를 입력할 경우 그에 해당하는 좌표를 반환하는 기능입니다. 이 기능은 지도 API의 다른 class들과는 달리 서버에
서 동작합니다. 따라서 아래에 제공되는 url에 요청 변수를 넣어서 획득한 결과 xml 파일을 활용하여 좌표 정보를 구해야 합니다.




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

http://maps.naver.com/api/geocode.php?key=지도용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=&’ 식으로 입력하는 경우 정상적인
                                          쿼리 요청으로 보고, 에러 메시지를 발생하지 않으며, quot;에 대한 검색을 수행합니다.
020             Unregistered key          등록되지 않은 키입니다.
200             Reserved
                                                                             표 52 주소 좌표 변환 에러 메시지



52
Naver Open Api Reference Manual

Más contenido relacionado

Destacado

Hoodpub 기술 발표
Hoodpub 기술 발표Hoodpub 기술 발표
Hoodpub 기술 발표Hyun-min Choi
 
[PAG 비즈니스 플랫폼데이] 네이버 앱스토어
[PAG 비즈니스 플랫폼데이] 네이버 앱스토어[PAG 비즈니스 플랫폼데이] 네이버 앱스토어
[PAG 비즈니스 플랫폼데이] 네이버 앱스토어VentureSquare
 
20140820 멀티플랫폼 인증서버_개발
20140820 멀티플랫폼 인증서버_개발20140820 멀티플랫폼 인증서버_개발
20140820 멀티플랫폼 인증서버_개발준상 신
 
일하는여성74호
일하는여성74호일하는여성74호
일하는여성74호kwwa
 
Managing Essbase and Dodeca 2010 ODTUG (June 2010)
Managing Essbase and Dodeca 2010 ODTUG (June 2010)Managing Essbase and Dodeca 2010 ODTUG (June 2010)
Managing Essbase and Dodeca 2010 ODTUG (June 2010)mholt48
 
Perkembangan dan persiapan kehidupan neonatus intra ke ekstra uterus dari sistem
Perkembangan dan persiapan kehidupan neonatus intra ke ekstra uterus dari sistemPerkembangan dan persiapan kehidupan neonatus intra ke ekstra uterus dari sistem
Perkembangan dan persiapan kehidupan neonatus intra ke ekstra uterus dari sistemOperator Warnet Vast Raha
 
OGC 표준 서비스를 이용한 Web KOPSS 구현사례
OGC 표준 서비스를 이용한 Web KOPSS 구현사례OGC 표준 서비스를 이용한 Web KOPSS 구현사례
OGC 표준 서비스를 이용한 Web KOPSS 구현사례MinPa Lee
 
몰스킨 브랜드북 조희원
몰스킨 브랜드북   조희원몰스킨 브랜드북   조희원
몰스킨 브랜드북 조희원heewon Jo
 
Jlook open api server platform
Jlook open api server platformJlook open api server platform
Jlook open api server platformHongSeong Jeon
 
Jlook open api platform-sysdevguide
Jlook open api platform-sysdevguideJlook open api platform-sysdevguide
Jlook open api platform-sysdevguideHongSeong Jeon
 
Kopss Open API 단위테스트 이슈사항
Kopss Open API 단위테스트 이슈사항Kopss Open API 단위테스트 이슈사항
Kopss Open API 단위테스트 이슈사항MinPa Lee
 
GeoTools와 GeoServer를 이용한 KOPSS Open API의 구현
GeoTools와 GeoServer를 이용한 KOPSS Open API의 구현GeoTools와 GeoServer를 이용한 KOPSS Open API의 구현
GeoTools와 GeoServer를 이용한 KOPSS Open API의 구현MinPa Lee
 
오픈소스 공간통계분석 패키지 개발
오픈소스  공간통계분석 패키지 개발오픈소스  공간통계분석 패키지 개발
오픈소스 공간통계분석 패키지 개발MinPa Lee
 
Daum 검색/지도 API (이정주)
Daum 검색/지도 API (이정주)Daum 검색/지도 API (이정주)
Daum 검색/지도 API (이정주)Daum DNA
 
공간정보아카데미 - Day1 오픈소스개발 일반
공간정보아카데미 - Day1 오픈소스개발 일반공간정보아카데미 - Day1 오픈소스개발 일반
공간정보아카데미 - Day1 오픈소스개발 일반BJ Jang
 
전자해도세미나
전자해도세미나전자해도세미나
전자해도세미나Jiyoon Kim
 

Destacado (20)

Hoodpub 기술 발표
Hoodpub 기술 발표Hoodpub 기술 발표
Hoodpub 기술 발표
 
[PAG 비즈니스 플랫폼데이] 네이버 앱스토어
[PAG 비즈니스 플랫폼데이] 네이버 앱스토어[PAG 비즈니스 플랫폼데이] 네이버 앱스토어
[PAG 비즈니스 플랫폼데이] 네이버 앱스토어
 
20140820 멀티플랫폼 인증서버_개발
20140820 멀티플랫폼 인증서버_개발20140820 멀티플랫폼 인증서버_개발
20140820 멀티플랫폼 인증서버_개발
 
일하는여성74호
일하는여성74호일하는여성74호
일하는여성74호
 
Managing Essbase and Dodeca 2010 ODTUG (June 2010)
Managing Essbase and Dodeca 2010 ODTUG (June 2010)Managing Essbase and Dodeca 2010 ODTUG (June 2010)
Managing Essbase and Dodeca 2010 ODTUG (June 2010)
 
Perkembangan dan persiapan kehidupan neonatus intra ke ekstra uterus dari sistem
Perkembangan dan persiapan kehidupan neonatus intra ke ekstra uterus dari sistemPerkembangan dan persiapan kehidupan neonatus intra ke ekstra uterus dari sistem
Perkembangan dan persiapan kehidupan neonatus intra ke ekstra uterus dari sistem
 
OGC 표준 서비스를 이용한 Web KOPSS 구현사례
OGC 표준 서비스를 이용한 Web KOPSS 구현사례OGC 표준 서비스를 이용한 Web KOPSS 구현사례
OGC 표준 서비스를 이용한 Web KOPSS 구현사례
 
몰스킨 브랜드북 조희원
몰스킨 브랜드북   조희원몰스킨 브랜드북   조희원
몰스킨 브랜드북 조희원
 
Jlook open api server platform
Jlook open api server platformJlook open api server platform
Jlook open api server platform
 
Jlook open api platform-sysdevguide
Jlook open api platform-sysdevguideJlook open api platform-sysdevguide
Jlook open api platform-sysdevguide
 
Open platform
Open platformOpen platform
Open platform
 
Open platform/API overview
Open platform/API overviewOpen platform/API overview
Open platform/API overview
 
Kopss Open API 단위테스트 이슈사항
Kopss Open API 단위테스트 이슈사항Kopss Open API 단위테스트 이슈사항
Kopss Open API 단위테스트 이슈사항
 
GeoTools와 GeoServer를 이용한 KOPSS Open API의 구현
GeoTools와 GeoServer를 이용한 KOPSS Open API의 구현GeoTools와 GeoServer를 이용한 KOPSS Open API의 구현
GeoTools와 GeoServer를 이용한 KOPSS Open API의 구현
 
오픈소스 공간통계분석 패키지 개발
오픈소스  공간통계분석 패키지 개발오픈소스  공간통계분석 패키지 개발
오픈소스 공간통계분석 패키지 개발
 
Daum 검색/지도 API (이정주)
Daum 검색/지도 API (이정주)Daum 검색/지도 API (이정주)
Daum 검색/지도 API (이정주)
 
Restful API guide
Restful API guideRestful API guide
Restful API guide
 
공간정보아카데미 - Day1 오픈소스개발 일반
공간정보아카데미 - Day1 오픈소스개발 일반공간정보아카데미 - Day1 오픈소스개발 일반
공간정보아카데미 - Day1 오픈소스개발 일반
 
Huawei SDP
Huawei SDPHuawei SDP
Huawei SDP
 
전자해도세미나
전자해도세미나전자해도세미나
전자해도세미나
 

Naver Open Api Reference Manual

  • 3. NAVER open API 검색 결과 서비스 / 07 Contents 08 지식IN 검색 요청 URL 및 변수 (request url and parameter) / 08 출력 결과 필드 (response field) / 08 09 블로그 검색 요청 URL 및 변수 (request url and parameter) / 09 출력 결과 필드 (response field) / 09 10 전문 자료 검색 요청 URL 및 변수 (request url and parameter) / 10 출력 결과 필드 (response field) / 10 11 한국 웹 문서 검색 요청 URL 및 변수 (request url and parameter) / 11 출력 결과 필드 (response field) / 11 12 책 검색 요청 URL 및 변수 (request url and parameter) / 12 상세 검색 요청 URL 및 변수 (request url and parameter) / 12 책 카테고리 / 13 출력 결과 필드 (response field) / 14 15 쇼핑 검색 요청 URL 및 변수 (request url and parameter) / 15 출력 결과 필드 (response field) / 15 16 국어 사전 검색 요청 URL 및 변수 (request url and parameter) / 16 출력 결과 필드 (response field) / 16 17 일어 사전 검색 요청 URL 및 변수 (request url and parameter) / 17 출력 결과 필드 (response field) / 17 18 영어 사전 검색 요청 URL 및 변수 (request url and parameter) / 18 출력 결과 필드 (response field) / 18
  • 4. 19 내 PC 검색 검색 관련 기능 / 26 내 PC 검색에서 사용되는 공통 요소 / 19 출력 결과 필드 (response field) 19 27 실시간 검색어 공통적으로 사용되는 카테고리 정보 19 요청 URL 및 변수 (request url and parameter) / 27 출력 결과 필드 (response field) / 27 20 openapi_search 요청 URL 및 변수 (request url and parameter) / 20 28 추천 검색어 출력 결과 필드 (response field) / 20 요청 URL 및 변수 (request url and parameter) / 28 출력 결과 필드 (response field) / 28 21 openapi_datacache 요청 URL 및 변수 (request url and parameter) / 21 29 성인 검색어 판별 출력 결과 필드 (response field) / 21 요청 URL 및 변수 (request url and parameter) / 29 출력 결과 필드 (response field) / 29 21 openapi_status 요청 URL 및 변수 (request url and parameter) / 21 30 오타 변환 출력 결과 필드 (response field) / 21 요청 URL 및 변수 (request url and parameter) / 30 출력 결과 필드 (response field) / 30 22 openapi_latestdoc 요청 URL 및 변수 (request url and parameter) / 22 31 바로 가기 출력 결과 필드 (response field) / 22 요청 URL 및 변수 (request url and parameter) / 31 출력 결과 필드 (response field) / 31 22 openapi_landmark 요청 URL 및 변수 (request url and parameter) / 22 출력 결과 필드 (response field) / 23 에러 메시지 / 32 23 openapi_extinfo 33 에러 메시지 요청 URL 및 변수 (request url and parameter) / 23 출력 결과 필드 (response field) / 23 지도 API / 34 24 openapi_property 요청 URL 및 변수 (request url and parameter) / 24 35 NMap Constructor / 35 24 openapi_open NMap(container [,width] [,height]) 35 요청 URL 및 변수 (request url and parameter) / 24 Method / 35 getBound() 35 24 openapi_readmail setBound(left, top, right, bottom) 35 요청 URL 및 변수 (request url and parameter) / 24 setCenterAndZoom(point, zoom_level) 35 setCenter(point) 35 25 openapi_getoption getCenter() 36 요청 URL 및 변수 (request url and parameter) / 25 setZoom(zoom_level) 36 출력 결과 필드 (response field) / 25 getZoom() 36 zoomIn() 36 zoomOut() 36 setMinLevel(zoom_level) 36 setMaxLevel(zoom_level) 36 enableDrag() 37
  • 5. disableDrag() 37 43 NEvent enableWheelZoom() 37 Static method / 43 disableWheelZoom() 37 addListener(event_src, event_name, event_func) 43 addControl(control) 37 removeListener(event_src, event_name, event_func) 43 removeControl(control) 37 addOverlay(overlay,[ key]) 37 43 NMark removeOverlay(overlay) 38 Constructor / 43 clearOverlays([key]) 38 NMark(point, icon) 43 pan(x, y) 38 Method / 44 Event / 38 setZindex(zindex) 44 move 38 setTargeturl(url) 44 drag 38 unsetTargeturl() 44 startDrag 38 setPoint(point) 44 endDrag 38 getPoint() 44 click 39 hide() 44 dblclick 39 show() 44 mousemove 39 Event / 45 zoom 39 click 45 redraw 39 mousedown 45 mouseup 45 39 NSize mouseover 45 Constructor / 39 mouseout 45 NSize(width, height) 39 Method / 40 45 NIcon set(width, height) 40 Constructor / 45 setWidth(width) 40 NIcon(src, size [,offset]) 45 setHeight(height) 40 getWidth() 40 46 NInfoWindow getHeight() 40 Constructor / 46 add(width_dx, height_dx) 41 NInfoWindow() 46 equals(size) 41 Method / 46 copy() 41 setOpacity(opacity) 46 set(point, content) 46 41 NPoint showWindow() 46 Constructor / 41 hideWindow() 46 NPoint(x, y) 41 getPoint() 46 Method / 41 delayHideWindow([delayTime]) 47 set(x, y) 41 Event / 47 setX(x) 41 mouseover 47 setY(y) 42 mouseout 47 getX() 42 getY() 42 47 NPolyline add(x_dx, y_dx) 42 Constructor / 47 distance(x, y) 42 NPolyline() 47 equals(point) 42 Method / 47 copy() 43 setWeight(weight) 47
  • 6. getWeight() 47 52 주소 좌표 변환 addPoints(...) 48 요청 URL 및 변수 (request url and parameter) / 52 getBound() 48 출력 결과 필드 (response field) / 52 show() 48 에러 메시지 / 52 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 setAlign(position) 51 setValign(position) 51 51 NIndexMap Constructor / 51 NIndexMap() 51 Method / 51 setAlign(position) 51 setValign(position) 51
  • 7. 표1 지식iN 검색 요청 변수 목록 08 표 27 내 PC 검색 openapi_status 출력 필드 목록 21 표2 지식iN 검색 출력 필드 목록 08 표 28 내 PC 검색 openapi_status 요청 변수 목록 21 표3 블로그 검색 요청 변수 목록 09 표 29 내 PC 검색 openapi_latestdoc 출력 필드 목록 22 표4 블로그 검색 출력 필드 목록 09 표 30 내 PC 검색 openapi_landmark 요청 변수 목록 22 표5 전문 자료 검색 요청 변수 목록 10 표 31 내 PC 검색 openapi_landmark 출력 필드 목록 23 표6 전문 자료 검색 출력 필드 목록 10 표 32 내 PC 검색 openapi_extinfo 요청 변수 목록 23 표7 한국 웹 문서 검색 요청 변수 목록 11 표 33 내 PC 검색 openapi_extinfo 출력 필드 목록 23 표8 한국 웹 문서 검색 출력 필드 목록 11 표 34 내 PC 검색 openapi_property 요청 변수 목록 24 표9 책 검색 요청 변수 목록 12 표 35 내 PC 검색 openapi_open 요청 변수 목록 24 표 10 책 상세 검색 요청 변수 목록 12 표 36 내 PC 검색 openapi_readmail 요청 변수 목록 24 표 11 책 상세 검색 카테고리 13 표 37 내 PC 검색 openapi_getoption 요청 변수 목록 25 표 12 책 검색 출력 필드 목록 14 표 38 내 PC 검색 openapi_getoption 출력 필드 목록 25 표 13 한국 웹 문서 검색 요청 변수 목록 15 표 39 실시간 검색어 요청 변수 목록 27 표 14 한국 웹 문서 검색 출력 필드 목록 15 표 40 실시간 검색어 출력 필드 목록 27 표 15 국어 사전 검색 요청 변수 목록 16 표 41 추천 검색어 요청 변수 목록 28 표 16 국어 사전 검색 출력 필드 목록 16 표 42 추천 검색어 출력 필드 목록 28 표 17 일어 사전 검색 요청 변수 목록 17 표 43 성인 검색어 판별 요청 변수 목록 29 표 18 일어 사전 검색 출력 필드 목록 17 표 44 성인 검색어 판별 출력 필드 목록 29 표 19 영어 사전 검색 요청 변수 목록 18 표 45 오타 변환 요청 변수 목록 30 표 20 영어 사전 검색 출력 필드 목록 18 표 46 오타 변환 출력 필드 목록 30 표 21 내 PC 검색 출력 필드 목록 19 표 47 바로 가기 요청 변수 목록 31 표 22 내 PC 검색에서 사용되는 카테고리 목록 19 표 48 바로 가기 출력 필드 목록 31 표 23 내 PC 검색 openapi_search 요청 변수 목록 20 표 49 공통 에러 메시지 33 표 24 내 PC 검색 openapi_search 출력 필드 목록 20 표 50 주소 좌표 변환 요청 변수 목록 52 표 25 내 PC 검색 openapi_datacache 요청 변수 목록 21 표 51 주소 좌표 변환 출력 필드 목록 52 표 26 내 PC 검색 openapi_datacache 출력 필드 목록 21 표 52 주소 좌표 변환 에러 메시지 52
  • 9. NAVER open API | 검색 결과 서비스 지식iN 검색 지식iN 검색은 지식인의 데이터를 검색할 수 있는 API 입니다. 요청 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 검색 출력 필드 목록 08
  • 10. NAVER open API | 검색 결과 서비스 블로그 검색 블로그 검색은 블로그의 데이터를 검색할 수 있는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용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) http://openapi.naver.com/search?key=검색용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) http://openapi.naver.com/search?key=검색용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) http://openapi.naver.com/search?key=검색용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) http://openapi.naver.com/search?key=검색용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. 20000101) d_dato 검색을 원하는 책의 출간 범위를 지정합니다. (종료일) (e.g. 20061231) 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 큐레이터학/예술행정 401 13
  • 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) http://openapi.naver.com/search?key=검색용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) http://openapi.naver.com/search?key=검색용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) http://openapi.naver.com/search?key=검색용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) http://openapi.naver.com/search?key=검색용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검색(http://mypc.naver.com)을 설치했을 경우 내 PC의 자료를 검색할 수 있는 API 입니다. 내 PC 검색에서 사용되는 공통 요소 출력 결과 필드 (response field) 출력은 표준 형식인 RSS 2.0 형식(http://blogs.law.harvard.edu/tech/rss)을 따릅니다. 표준 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 email 이메일 8 etc 기타파일 9 timeline 타임라인 표 22 내 PC 검색에서 사용되는 카테고리 목록 19
  • 21. NAVER open API | 검색 결과 서비스 openapi_serch 검색을 요청합니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_search?where=desktop&query=nhn&start=1&display=10 변수 명 설명 where 검색할 카테고리를 지정합니다. 기본값: desktop query 검색할 질의어를 입력합니다. URL encoding이 되어 있어야 합니다. start 검색의 시작위치를 지정합니다. 기본값: 1 display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 환경설정에 지정된 개수 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 요청 변수 목록 출력 결과 필드 (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) http://127.0.0.1:3001/openapi_datacache?h=1&l=1 변수 명 설명 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) http://127.0.0.1:3001/openapi_status 출력 결과 필드 (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) http://127.0.0.1:3001/openapi_latestdoc 변수 명 설명 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) http://127.0.0.1:3001/openapi_landmark 변수 명 설명 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) http://127.0.0.1:3001/openapi_extinfo 변수 명 설명 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) http://127.0.0.1:3001/openapi_property 변수 명 설명 path 속성 창을 열 파일의 절대 경로 표 34 내 PC 검색 openapi_property 요청 변수 목록 openapi_open 파일을 엽니다. 파일 오픈 프로그램은 탐색기의 연결 프로그램 설정을 따릅니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_open 변수 명 설명 path 열 파일의 절대 경로 표 35 내 PC 검색 openapi_open 요청 변수 목록 openapi_readmail 이메일 문서를 Outlook, OutlookExpress 등의 이메일 클라이언트 프로그램으로 엽니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_readmail 변수 명 설명 eid 열 문서의 entry ID. 검색 결과의 <nns:metainfo name=”entry_id”>의 값을 사용합니다. 표 36 내 PC 검색 openapi_readmail 요청 변수 목록 24
  • 26. NAVER open API | 검색 결과 서비스 openapi_getoption 환경설정 정보를 가져옵니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_getoption 변수 명 설명 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
  • 28. NAVER open API | 검색 관련 기능 실시간 검색어 실시간 검색어는 현재 NAVER에서 많이 검색되고 있는 검색어들을 순서대로 10위까지 보여주는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용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) http://openapi.naver.com/search?key=검색용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) http://openapi.naver.com/search?key=검색용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) http://openapi.naver.com/search?key=검색용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) http://openapi.naver.com/search?key=검색용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
  • 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=&’ 식으로 입력하는 경우 정상적인 쿼리 요청으로 보고, 에러 메시지를 발생하지 않으며, quot;에 대한 검색을 수행합니다. 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
  • 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 = ‘http://openapi.naver.com/sample.gif’; 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(‘http://openapi.naver.com’); 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(‘http://openapi.naver.com/sample.gif’, 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(‘http://openapi.naver.com/test’, ‘processXML’); 49
  • 51. NAVER open API | 지도 API NZoomControl Constructor NZoomControl() 새로운 NZoomControl 클래스의 객체를 생성합니다. 이 객체는 NMap 클래스의 객체에 addControl method를 통해 추가되어 사용될 수 있습니다. 예제 var zcObj = new NZoomControl(); Method setAlign(position) 현재 컨트롤의 지도 내에서의 수평 위치를 지정합니다. 파라미터 position은 미리 지정된 문자열입니다. quot;leftquot;, quot;centerquot;, quot;rightquot;의 세 가지 값이 있으며 각각 왼쪽, 중앙, 오른쪽 위치를 지 정합니다. 예제 zcObj.setAlign(‘center’); setValign(position) 현재 컨트롤의 지도 내에서의 수직 위치를 지정합니다. 파라미터 position은 미리 지정된 문자열입니다. quot;topquot;, quot;centerquot;, quot;bottomquot;의 세 가지 값이 있으며 각각 위, 중앙, 아래 위치를 지정 합니다. 예제 zcObj.setValign(‘center’); NSaveBtn Constructor NSaveBtn() 새로운 NSaveBtn 클래스의 객체를 생성합니다. 이 객체는 NMap 클래스의 객체에 addControl method를 통해 추가되어 사용될 수 있습니다. 예제 var sbObj = new SaveBtn() 50
  • 52. NAVER open API | 지도 API Method setAlign(position) 현재 컨트롤의 지도 내에서의 수평 위치를 지정합니다. 파라미터 position은 미리 지정된 문자열입니다. quot;leftquot;, quot;centerquot;, quot;rightquot;의 세 가지 값이 있으며 각각 왼쪽, 중앙, 오른쪽 위치를 지 정합니다. 예제 sbObj.setAlign(‘center’); setValign(position) 현재 컨트롤의 지도 내에서의 수직 위치를 지정합니다. 파라미터 position은 미리 지정된 문자열입니다. quot;topquot;, quot;centerquot;, quot;bottomquot;의 세 가지 값이 있으며 각각 위, 중앙, 아래 위치를 지정 합니다. 예제 sbObj.setValign(‘center’); NIndexMap Constructor NIndexMap() 새로운 NIndexMap 클래스의 객체를 생성합니다. 이 객체는 NMap 클래스의 객체에 addControl method를 통해 추가되어 사용될 수 있습니다. 추가되면 지도에 인덱스 맵을 보여줍니다. 예제 var imObj = new NIndexMap(); Method setAlign(position) 현재 컨트롤의 지도 내에서의 수평 위치를 지정합니다. 파라미터 position은 미리 지정된 문자열입니다. quot;leftquot;, quot;centerquot;, quot;rightquot;의 세 가지 값이 있으며 각각 왼쪽, 중앙, 오른쪽 위치를 지 정합니다. 예제 imObj.setAlign(‘center’); setValign(position) 현재 컨트롤의 지도 내에서의 수직 위치를 지정합니다. 파라미터 position은 미리 지정된 문자열입니다. quot;topquot;, quot;centerquot;, quot;bottomquot;의 세 가지 값이 있으며 각각 위, 중앙, 아래 위치를 지정 합니다. 예제 imObj.setValign(‘center’); 51
  • 53. NAVER open API | 지도 API 주소 좌표 변환 주소 좌표 변환은 주소를 입력할 경우 그에 해당하는 좌표를 반환하는 기능입니다. 이 기능은 지도 API의 다른 class들과는 달리 서버에 서 동작합니다. 따라서 아래에 제공되는 url에 요청 변수를 넣어서 획득한 결과 xml 파일을 활용하여 좌표 정보를 구해야 합니다. 요청 URL 및 변수 (request url and parameter) http://maps.naver.com/api/geocode.php?key=지도용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=&’ 식으로 입력하는 경우 정상적인 쿼리 요청으로 보고, 에러 메시지를 발생하지 않으며, quot;에 대한 검색을 수행합니다. 020 Unregistered key 등록되지 않은 키입니다. 200 Reserved 표 52 주소 좌표 변환 에러 메시지 52