네이버 지도
Naver커머스·지도
장소·주소 검색, 최대 15개 경유지 경로 비교, 정적 지도 파일 전달
제공 도구 7
발신·파괴적 작업 등 되돌리기 어려운 도구는 실행 전 사용자 승인을 거칩니다.
- naver_map__directions읽기
운전 경로 조회 — 경유지 최대 5개·목적지 후보·경로 옵션 비교, 거리·시간·요금과 경로 좌표·구간 안내를 반환한다
- naver_map__directions15읽기
다중 경유지 운전 경로 조회 — 경유지 최대 15개, 거리·시간·요금과 경로 좌표·구간 안내를 반환한다. NCP Application에서 Directions 15 활성 필요
- naver_map__geocode읽기
주소 → 좌표 변환 — 도로명·지번·영문 주소와 좌표("경도,위도"), 전체 주소 요소, 다음 페이지 cursor를 반환한다
- naver_map__reverse_geocode읽기
좌표 → 주소 변환 — 도로명·지번 주소와 법정동·행정동 코드 및 원본 결과를 반환한다
- naver_map__search_local읽기
장소·상호 검색 — 업체명·업종·주소·원본 좌표를 반환한다. 공식 API는 최대 5건·start=1만 지원하며 NAVER API HUB 검색 API 활성 필요
- naver_map__static_map읽기
정적 지도 이미지를 PNG/JPEG 파일로 전달한다 — 중심·줌 또는 마커로 지도 범위를 지정. 커스텀 아이콘 URL은 지원하지 않는다
- naver_map__static_map_version읽기
정적 지도 데이터 버전과 권장 확인 주기(interval 초)를 조회한다
연동 준비
- NCP Application의 Client ID / Secret을 입력하고 필요한 Geocoding·Reverse Geocoding·Directions 5·Directions 15·Static Map 상품을 선택하세요. 바로가기
- 장소·상호 검색은 사용 중인 키에 NAVER API HUB 검색 API도 활성해야 합니다. 상품별 권한·쿼터는 별개이며 Geocoding 연결 확인 성공만으로 다른 상품의 활성 여부를 알 수 없습니다.
- 이 migration은 기존 키 권한을 늘리지 않습니다. 콘솔에서 상품을 활성하고, 다른 Application 키가 필요하면 연결을 다시 만드세요. OAuth scope·재동의는 없습니다.