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