Maps 개요
    • PDF

    Maps 개요

    • PDF

    Article Summary

    Classic/VPC 환경에서 이용 가능합니다.

    Maps는 네이버 지도 콘텐츠와 데이터를 활용하여 위치 기반 서비스를 만들 수 있도록 지원하는 네이버 클라우드 플랫폼의 소프트웨어 인터페이스입니다. Maps API는 여러 형태의 개발 리소스로 제공됩니다. 사용자 서비스 환경에 맞는 개발 리소스를 사용함으로써 네이버 지도를 쉽고 빠르게 사용할 수 있습니다. Maps API 종류는 다음과 같습니다.

    • Web Dynamic Map API
    • Mobile Dynamic Map SDK
    • REST API
      • Static Map API
      • Directions 5 API
      • Directions 15 API
      • Geocoding API
      • Reverse Geocoding API
    • 네이버 지도 앱 연동 URL Scheme

    Maps가 제공하는 다양한 기능

    Maps가 제공하는 다양한 기능에 대한 설명은 다음과 같습니다.

    • 동적 지도 제공: Web Dynamic Map은 지도 이동과 지도 확대/축소 등 다양한 사용자 인터랙션을 제공하는 동적 지도를 제공합니다.

      제공 기능설명
      지도 옵션지도 인터랙션, 관성 드래깅, 타일 fadeIn 효과, 지도 컨트롤, 최소/최대 줌 레벨 설정 및 해제
      지도 유형일반 지도, 지형도, 위성 지도, 사용자 정의 지도 유형 등
      지도 레이어자전거 레이어, 지적편집도 레이어, 실시간 교통상황 레이어, 네이버 거리뷰 레이어, 겹쳐보기 레이어, 데이터 레이어(GeoJSON, KML, GPX ), 사용자 정의 레이어 등
      지도 이동중심 좌표로 이동, 줌 레벨 설정 및 이동, 좌표 경계 이동, 지정한 픽셀만큼 이동, 현위치 좌표로 이동 등
      지도 이벤트KVO(Key-Value Observing) 방식의 이벤트 처리, 오버레이 객체의 이벤트 처리
      지도 컨트롤줌 컨트롤, 축척 컨트롤, 지도 유형 컨트롤, 지도 데이터 저작권, NAVER 로고 컨트롤, 사용자 정의 컨트롤
      지도 오버레이마커, 마커 아이콘 변경, 마커 아이콘 레티나 대응, 마커 애니메이션, 마커 겹침 처리, 마커 클러스터화, 정보 창, 도형 그리기, 지상 오버레이, 사용자 정의 오버레이
      지도 데이터 시각화열지도, 점지도 (visualization 서브 모듈 제공)
      파노라마거리뷰/항공뷰 제공 (panorama 서브 모듈 제공)
      주소와 좌표 변환주소->좌표값 변환, 좌표값->주소 변환 API 제공 (geocoder 서브 모듈 제공)
      그리기 도구폴리곤, 사각형, 폴리라인, 원, 마커를 그릴 수 있는 GUI 제공 (drawing 서브 모듈 제공)
    • 벡터 지도 제공: Mobile Dynamic Map은 풀 벡터 렌더링이 구현된 벡터 지도를 제공합니다. 다양한 지도 유형과 레이어, 다양한 오버레이, 자연스러운 제스처, 강력한 이벤트 시스템을 제공합니다.

      제공 기능설명
      지도 옵션야간 모드, 라이트 모드, 디스플레이 옵션(지도 밝기, 건물 높이, 심볼 크기, 원근 효과) 등
      지도 유형일반 지도, 위성 지도, 위성 겹쳐보기 지도, 지형도, 내비게이션 지도, 실내지도 등
      지도 레이어건물 레이어, 실시간 교통정보 레이어, 대중교통 레이어, 자전거 레이어, 등산로 레이어, 지적편집도 레이어
      카메라 이동 (지도 이동)카메라 이동/줌/기울임/회전에 따라 자유자재로 반응하는 지도 움직임, 카메라 이동 애니메이션 제공
      사용자 인터페이스지도 컨트롤, 사용자 제스처, 클릭 이벤트 등 다양한 사용자 인터랙션 제공
      지도 오버레이마커, 정보 창, 셰이프, 지상 오버레이, 위치 오버레이, 경로선과 화살표, 오버레이 제어(겹침 우선순위, 노출 제어, 이벤트 처리)
    • 정적 지도 제공: Static Map REST API를 호출하여 요청한 지도 이미지를 받을 수 있습니다. 지도 크기, 지도 유형, 지도 형식, 줌 레벨, 해상도, 마커, 언어, 대중교통 정보 등을 요청 파라미터로 전달함으로써 다양한 지도 이미지를 생성할 수 있습니다. CDN 캐시 무효화를 위한 Data version API를 추가 제공하며, HTTP Referer 기반 인증도 지원합니다.

    • 경로 데이터 제공: Directions 5 REST API, Directions 15 REST API를 호출하여 경로 데이터를 조회할 수 있습니다. 탐색 옵션에 따라 최적 경로, 최단 경로, 편한 경로, 경제적인 경로, 자동차 우선도로 회피 경로를 조회할 수 있습니다. Directions 5 API는 경유지를 최대 5개 추가 가능하고, Directions 15 API는 경유지를 최대 15개까지 추가 가능합니다.

    • 주소-좌표값 변환 기능 제공: Geocoding REST API나 Web Dynamic Map의 Geocoder 서브 모듈을 사용하여 지번주소, 도로명 주소를 지도 좌표로 변환할 수 있습니다.

    • 좌표값-주소 변환 기능 제공: Reverse Geocoding REST API나 Web Dynamic Map의 Geocoder 서브 모듈을 사용하여 지도 좌표를 지번주소, 도로명주소, 법정동, 행정동 정보로 변환할 수 있습니다.

    Maps 사용 가이드 안내

    Maps는 한국 리전, 미국 리전, 싱가포르 리전, 홍콩 리전, 일본 리전, 독일 리전에서 서비스를 제공하고 있습니다. 해당 리전에서 제공하는 서비스 내용은 동일하며, Maps의 원활한 이용을 위해 다음 목차와 목차별 내용을 확인해 주십시오.

    • Maps 개요: Maps 소개 및 이용에 도움이 되는 가이드, 연관 리소스, 자주 하는 질문과 답변 안내
    • Maps 사용 준비: Maps에서 지원되는 환경 사양, 서비스 지원 사양, 이용 요금 안내
    • Maps 시나리오: Maps를 이용하는 전체 프로세스 안내
    • Maps 시작: 네이버 클라우드 플랫폼 콘솔에서 Maps 사용 방법 안내
      • Application: 네이버 클라우드 플랫폼 콘솔 화면에서 Maps Application을 등록하고 관리하는 방법을 설명
      • Usage Statistics: 네이버 클라우드 플랫폼 콘솔 화면에서 Maps 사용 통계를 확인하는 방법을 설명
    • Maps 사용: Maps API 리소스 안내
    • Maps 권한 관리: Sub Account를 활용한 Maps 권한 관리 방법 안내
    • Maps 용어: Maps 사용 시 반드시 알아두어야 할 주요 용어와 해설 안내
    • Maps 릴리스 노트: Maps 사용 가이드 업데이트 이력

    Maps 연관 리소스

    네이버 클라우드 플랫폼에서는 Maps에 대한 고객의 이해를 돕기 위해 사용 가이드 외에도 다양한 연관 리소스를 제공하고 있습니다. Maps를 도입하기 위해 고민 중이거나 데이터 관련 정책을 수립하면서 자세한 정보가 필요한 개발자, 마케터 등은 다음 리소스를 적극 활용해 보십시오.

    자주 하는 질문을 먼저 확인해 보십시오.

    사용 가이드를 읽기 전 자주 하는 질문에 대한 답변으로 궁금증을 빠르게 해소할 수 있습니다. 만약 다음의 자주 하는 질문에서 원하는 답을 얻지 못한 경우 사용 가이드에서 원하는 내용을 찾아서 확인해 보십시오.

    Q. Maps API의 대표 계정은 무엇입니까?
    A. 네이버 클라우드 플랫폼 포털에서 확인

    Q. Maps API의 무료이용량 정책이 무엇입니까?
    A. 네이버 클라우드 플랫폼 포털에서 확인

    Q. Maps API 대표 계정은 어떻게 변경할 수 있습니까?
    A. 네이버 클라우드 플랫폼 포털에서 확인

    Q. Maps API 대표 계정을 확인하는 방법은 무엇입니까?
    A. Maps API 중 Web Dynamic Map API, Static Map API, Geocoding API, Reverse Geocoding API는 대표 계정에 한하여 무료이용량을 제공합니다. Maps API 서비스를 제일 먼저 이용한 계정이 대표 계정으로 설정됩니다. 개인 회원의 경우 전화번호를 기준으로 1개 계정만 대표 계정으로 설정되고 사업자 회원의 경우 사업자 번호를 기준으로 1개 계정만 대표 계정으로 설정됩니다. 대표 계정이 아닐 경우에는 API 호출 시 과금이 되므로 주의해야 합니다. 본 정책은 2023.1월부터 Maps API에 적용되고 있습니다. 현재 콘솔에 로그인한 계정이 대표 계정인지 아닌지 확인하는 방법은 Maps 대표 계정 조회를 확인해 주십시오.

    Q. Maps API 호출 시 CORS 오류가 발생했습니다. 해결 방법은 무엇입니까?
    A. 네이버 클라우드 플랫폼 포털에서 확인

    Q. 정상 호출됐던 Maps API가 어느 시점부터 정상적으로 호출되지 않습니다. 이유가 무엇입니까?
    A. 호스트 도메인 기반으로 허용된 서비스 환경(폐쇄망)에서는 Maps 호스트를 방화벽에 등록하여 접근을 허용해야 합니다. 이미 등록한 경우라면 Maps 호스트 최신 정보를 확인 후 업데이트해야 합니다. 호스트 변경 관련 내용은 네이버 클라우드 플랫폼 포털 을 확인해 주십시오.

    Q. Maps 서비스에 개발자 포럼을 접속하려면 어떻게 해야하나요?
    A. Maps 서비스에서 포럼을 제공하고 있으며, AI,NAVER API 콘솔에서 접속할 수 있습니다. Application 메뉴 내 "Maps 포럼 바로가기"를 클릭하면 접속할 수 있습니다.

    참고

    네이버 클라우드 플랫폼에서 개발자 포럼은 일부 서비스에 한하여 제공하고 있습니다. 포럼에서 서비스에 대한 소식 및 궁금한 사항들을 확인해 주십시오.


    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.