Maps 시나리오

1. 사용 권한 설정

Maps를 여러 사용자가 관리하고 공유할 필요가 있는 경우 사용자별 권한을 설정하여 운영할 수 있습니다. 사용자별 권한은 네이버 클라우드 플랫폼의 Sub Account를 통해 관리자 권한과 사용자 권한으로 구성할 수 있으며, 각 권한별로 역할을 정의할 수 있습니다.
사용 권한 설정은 필수 설정 사항은 아니기 때문에 Maps 이용 중 권한이 필요한 상황에 언제든지 설정하거나 설정을 해제할 수 있습니다.

참고

Sub Account는 이용 신청 시 별도의 요금이 부과되지 않는 무료 서비스입니다. Sub Account 소개와 요금제에 대한 자세한 설명은 네이버 클라우드 플랫폼 포털의 서비스 > Management & Governance > Sub Account 메뉴를 참조해 주십시오.

참조할 수 있는 사용 가이드는 다음과 같습니다.

2. 인증키 발급

Maps를 이용하려면 먼저 네이버 클라우드 플랫폼 콘솔에서 Application을 등록하여 인증키를 발급받아야 합니다. Maps는 AI·NAVER API > Application Service에 속해 있습니다. 등록할 수 있는 Maps API에는 Web Dynamic Map, Mobile Dynamic Map, Static Map, Directions 5, Directions 15, Geocoding, Reverse Geocoding이 있습니다. 모든 API를 Application 한 개에 등록할 수도 있고, API 개별 Application으로 등록할 수도 있습니다. Application 등록과 관련하여 참조할 수 있는 가이드는 다음과 같습니다.

3. 프로젝트 설정

Maps API를 사용하려면 네이버 클라우드 플랫폼에서 제공하는 Maps API 리소스를 개발 프로젝트 파일에 로드하거나 리소스 및 라이브러리에 대한 의존성을 추가해야 합니다. 개발 리소스별 프로젝트 설정하는 방법이 다르기 때문에 각 리소스의 시작 가이드를 참조합니다. Maps REST API는 별도의 설정없이 사용할 수 있습니다. 프로젝트 설정과 관련하여 참조할 수 있는 가이드는 다음과 같습니다.

참고

Web Dynamic Map의 서브 모듈은 Web Dynamic Map 코어 API와 별개의 라이브러리이기 때문에 서브 모듈을 사용하려면 submodules URL 파라미터를 사용하여 서브 모듈을 로드해야 합니다. 서브 모듈을 로드하려면 Web Dynamic Map API가 먼저 로드되어 있어야 합니다. Web Dynamic Map이 제공하는 서브 모듈에 대한 설명은 다음과 같습니다.

panorama: 거리뷰/항공뷰를 제공합니다.
geocoder: 좌표 체계간 변환 메소드와 특정 좌표계를 지원하는 확장된 투영 객체를 제공합니다.
drawing: 지도 위에 폴리곤, 사각형, 폴리라인, 원, 마커를 그릴 수 있는 그리기 도구를 제공합니다.
visualization: 지리 정보를 가지고 있는 데이터를 쉽게 이해할 수 있도록 열지도, 점지도를 제공합니다.

4. 인증키 적용

2. Maps 이용 신청 절차에 따라 Application 등록을 통해 발급된 인증키(Client ID, Client Secret)를 개발 프로젝트에 적용해야 합니다. 즉, 개발 프로젝트 설정 파일에 발급된 인증키를 적용함으로써 Maps API를 사용할 수 있습니다. Maps REST API는 헤더에 인증키를 입력합니다. 개발 리소스별 인증키 적용 방법이 다르기 때문에 각 리소스의 시작 가이드를 참조합니다. 참조할 수 있는 가이드는 다음과 같습니다.

주의

Client ID와 Client Secret이 외부에 노출되지 않도록 주의해 주십시오. 보안이 우려되는 경우 새로운 값으로 재발급해 주십시오. 인증키 재발급 절차는 Application 정보 확인을 확인해 주십시오.

5. API 사용

네이버 클라우드 플랫폼 Maps API가 제공하는 클래스와 라이브러리를 사용하여 네이버 지도 서비스를 구현합니다. 지도 객체를 생성하여 지도를 표시할 자리를 예약하는 것부터 시작합니다. 자세한 구현 방법은 개발 리소스별 개발 가이드를 참조해야 합니다. 참조할 수 있는 개발 가이드는 다음과 같습니다.

주의

Maps API를 사용하여 서비스를 구현할 경우, 네이버 Maps에서 제공하고 있는 기능 및 서비스 명칭을 임의로 변경할 수 없으며, 이 가이드에서 안내된 명칭(거리뷰, 길찾기, 내비게이션, 위성지도, 지적편집도, 지도검색, 대중교통, 실시간교통 등)과 동일하게 표기해야 합니다.
<예시> 고객이 Web Dynamic Map을 이용하여 '거리뷰'를 보여줄 경우, '거리뷰'가 아닌 '입구뷰' 또는 '로드뷰' 등의 명칭으로 변경하여 표기할 수 없습니다.

6. 이용량 조회

네이버 클라우드 플랫폼 콘솔에서 Maps API 사용량을 조회합니다. 일정 사용량 초과 시 과금되므로 이용 한도를 설정하거나 한도 초과시 통보 기능을 통하여 Maps 사용량을 관리하도록 합니다. 참조할 수 있는 사용 가이드는 다음과 같습니다.