- 인쇄
- PDF
Maps 시나리오
- 인쇄
- PDF
VPC 환경에서 이용 가능합니다.
네이버 클라우드 플랫폼의 Maps API를 사용하여 네이버 지도를 쉽고 간편하게 구현할 수 있습니다. 사용 방법은 Maps 시작, Maps 사용에서 자세하게 확인할 수 있지만 우선 Maps 서비스를 사용하는 전체 시나리오를 살펴보는 것을 권장합니다. 사용 시나리오를 학습한 후 사용 방법을 확인하면 좀 더 원활하게 Maps 서비스를 활용할 수 있습니다.
Maps 서비스를 사용하는 전체 순서와 각 순서별 설명은 다음과 같습니다.
1. 사용 권한 설정
2. 상품 이용 신청
3. 인증키 발급
4. 프로젝트 설정
5. 인증키 적용
6. API 사용
7. Map Style Editor 컴포넌트 스타일링
8. 이용량 조회
1. 사용 권한 설정
Maps 서비스를 여러 사용자가 관리하고 공유할 필요가 있는 경우 사용자별 권한을 설정하여 운영할 수 있습니다. 사용자별 권한은 네이버 클라우드 플랫폼의 Sub Account를 통해 관리자 권한과 사용자 권한으로 구성할 수 있으며, 각 권한별로 역할을 정의할 수 있습니다.
사용 권한 설정은 필수 설정 사항은 아니기 때문에 Maps 이용 중 권한이 필요한 상황에 언제든지 설정하거나 설정을 해제할 수 있습니다.
Sub Account는 이용 신청 시 별도의 요금이 부과되지 않는 무료 서비스입니다. Sub Account 소개와 요금제에 대한 자세한 설명은 네이버 클라우드 플랫폼 포털의 서비스 > Management & Governance > Sub Account 메뉴를 참조해 주십시오.
참조할 수 있는 사용 가이드는 다음과 같습니다.
2. 상품 이용 신청
Maps 서비스를 이용하려면 네이버 클라우드 플랫폼의 콘솔에서 서비스 이용 신청을 완료해야 합니다. 본 서비스 이용 약관은 Maps 서비스에서 발생하는 데이터의 보관 및 사용에 대한 내용과 개인 정보 위수탁, 회사의 의무 및 고객의 의무에 대한 내용을 담고 있습니다. 서비스 기획 전에 약관 내용을 반드시 확인해 주십시오.
참조할 수 있는 사용 가이드는 다음과 같습니다.
3. 인증키 발급
Maps 서비스를 이용하려면 먼저 네이버 클라우드 플랫폼 콘솔에서 Application을 등록하여 인증키를 발급받아야 합니다. 등록할 수 있는 Maps API에는 Dynamic Map(Web, Mobile 서비스 환경 대응), Static Map, Directions 5, Directions 15, Geocoding, Reverse Geocoding이 있습니다. 모든 API를 Application 한 개에 등록할 수도 있고, API 개별 Application으로 등록할 수도 있습니다.
Application 등록과 관련하여 참조할 수 있는 가이드는 다음과 같습니다.
4. 프로젝트 설정
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: 지리 정보를 가지고 있는 데이터를 쉽게 이해할 수 있도록 열지도, 점지도를 제공합니다.
5. 인증키 적용
2. 상품 이용 신청 절차에 따라 Application 등록을 통해 발급된 인증키(Client ID, Client Secret)를 개발 프로젝트에 적용해야 합니다. 즉, 개발 프로젝트 설정 파일에 발급된 인증키를 적용함으로써 Maps API를 사용할 수 있습니다. Maps REST API는 헤더에 인증키를 입력합니다. 개발 리소스별 인증키 적용 방법이 다르기 때문에 각 리소스의 시작 가이드를 참조합니다.
참조할 수 있는 가이드는 다음과 같습니다.
Client ID와 Client Secret이 외부에 노출되지 않도록 주의해 주십시오. 보안이 우려되는 경우 새로운 값으로 재발급해 주십시오. 인증키 재발급 절차는 Application 정보 확인을 확인해 주십시오.
6. API 사용
네이버 클라우드 플랫폼 Maps API가 제공하는 클래스와 라이브러리를 사용하여 네이버 지도 서비스를 구현합니다. 지도 객체를 생성하여 지도를 표시할 자리를 예약하는 것부터 시작합니다. 자세한 구현 방법은 개발 리소스별 개발 가이드를 참조해야 합니다.
참조할 수 있는 개발 가이드는 다음과 같습니다.
- Web Dynamic Map 개발
- Mobile Dynamic Map Android 개발
- Mobile Dynamic Map iOS 개발
- Dynamic Map API 명세
- Static Map API 명세
- Directions 5 API 명세
- Directions 15 API 명세
- Geocoding API 명세
- Reverse Geocoding API 명세
Maps API를 사용하여 서비스를 구현할 경우, 네이버 Maps에서 제공하고 있는 기능 및 서비스 명칭을 임의로 변경할 수 없으며, 이 가이드에서 안내된 명칭(거리뷰, 길찾기, 내비게이션, 위성지도, 지적편집도, 지도검색, 대중교통, 실시간교통 등)과 동일하게 표기해야 합니다.
<예시> 고객이 Web Dynamic Map을 이용하여 '거리뷰'를 보여줄 경우, '거리뷰'가 아닌 '입구뷰' 또는 '로드뷰' 등의 명칭으로 변경하여 표기할 수 없습니다.
7. Map Style Editor 컴포넌트 스타일링
서비스에서 호출하는 지도 콘텐츠를 서비스에 적합한 형태로 스타일링 합니다. 각 지도 편집 요소인 컴포넌트의 색상과 글자를 스타일링하거나 직접 아이콘을 편집하여 자신만의 지도를 만들 수 있습니다.
참조할 수 있는 사용 가이드는 다음과 같습니다.
8. 이용량 조회
네이버 클라우드 플랫폼 콘솔에서 Maps API 사용량을 조회합니다. 일정 사용량 초과 시 과금되므로 이용 한도를 설정하거나 한도 초과시 통보 기능을 통하여 Maps 사용량을 관리하도록 합니다.
참조할 수 있는 사용 가이드는 다음과 같습니다.