--- title: "Maps 사용 준비" slug: "maps-spec" tags: ["Maps", "spec", "maps sdk"] updated: 2026-09-17T09:07:17Z published: 2026-09-17T09:07:17Z canonical: "guide.ncloud-docs.com/maps-spec" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Maps 사용 준비 Classic/VPC 환경에서 이용 가능합니다. 참고 네이버 클라우드 플랫폼 서비스에서 제공 중이던 Maps API 서비스가 업그레이드되어 새롭게 출시되었습니다. 네이버 지도 콘텐츠의 커스텀 스타일링 기능이 추가된 **새로운 Maps** 서비스 이용을 부탁드립니다. - [콘솔에서 새로운 Maps 찾아가기: Services > Application Services > Maps](https://console.ncloud.com/maps/subscription) - [새로운 Maps 서비스의 Map Style Editor 미리보기](/docs/application-maps-styleeditor-screen-vpc) Maps의 원활한 이용을 위한 서비스 지원 환경과 이용 요금을 확인합니다. ## 클라우드 환경 사양 Maps가 지원하는 클라우드 환경 사양은 다음과 같습니다. | 항목 | 지원 사양 | | --- | --- | | 리전(존) | 한국, 미국, 싱가포르, 일본, 독일 | | 플랫폼 | VPC, Classic | | 언어 | 한국어, 영어, 일본어 | 참고 VPC 환경이 궁금한 경우 네이버 클라우드 플랫폼 포털의 [서비스 소개](https://www.ncloud.com/product/networking/vpc)를, 서비스별 VPC 환경 지원 여부가 궁금한 경우 [Ncloud 사용 환경 가이드](/docs/environment-environment-1-1)를 참조해 주십시오. ## 서비스 지원 사양 Maps API는 다양한 서비스 환경을 지원할 수 있도록 다양한 형태의 리소스로 제공됩니다. 각 리소스의 지원 사양은 다음과 같습니다. ### Web Dynamic Map 지원 웹 브라우저 Web Dynamic Map은 데스크톱과 모바일 환경에 최적화된 코드를 제공하며, 주요 웹 브라우저를 완벽하게 지원합니다. 지원하는 웹 브라우저는 다음과 같습니다. | 항목 | PC 웹 브라우저 호환 | 모바일 웹 브라우저 호환 | | --- | --- | --- | | 코어 API | - Explorer 11 이상 - Chrome - Safari 5 이상 - Firefox | - Android 3 이상 - iOS 7 이상 - Chrome - Safari 5 이상 - Firefox | | 서브 모듈 (Visualization) API | - Explorer 11 이상 - Chrome - Safari 5 이상 - Firefox | - Android 5 이상 - iOS 9 이상 | 참고 Web Dynamic Map은 어떠한 프레임워크 또는 라이브러리를 함께 사용해도 문제 없이 동작합니다. ### Mobile Dynamic Map Android SDK 지원 사양 Mobile Dynamic Map Android SDK의 지원 사양을 설명합니다. #### 운영체제 및 라이브러리 Mobile Dynamic Map Android SDK가 지원하는 운영체제 버전 및 라이브러리는 다음과 같습니다. | SDK 버전 | 운영체제 버전 | 의존 라이브러리 | 개발 언어 | | --- | --- | --- | --- | | Mobile Dynamic Map Android 3.x | Android 5.0(API 레벨 21) 이상 | Android Jetpack | Java, Kotlin | #### SDK 배포 Mobile Dynamic Map Android SDK version 3.x는 `https://repository.map.naver.com/archive/maven` Maven 저장소에서 배포됩니다. 루트 프로젝트의 `build.gradle`에 저장소 설정을 추가하고, 앱 모듈의 `build.gradle`에 SDK 의존성을 선언합니다. Mobile Dynamic Map Android SDK version 3.x 데모 프로젝트는 [github 저장소](https://github.com/navermaps/android-map-sdk)에서 다운로드 받을 수 있습니다. #### SDK 업그레이드 후 변경 사항 Mobile Dynamic Map Android SDK의 버전이 2.x에서 3.x으로 업그레이드되면서 제공되지 않는 기능은 다음과 같습니다. | 기능 | SDK 2.x | SDK 3.x | | --- | --- | --- | | Reverse Geocoding | NMapActivity.findPlacemarkAtLocation()를 호출해서 좌표-주소 변환 기능 사용 | Reverse Geocoding 미지원 -> Reverse Geocoding REST API 사용 | | 네이버 지도앱 실행 버튼 | NMapView.setBuiltInAppControls()를 호출해서 네이버 지도 앱 활성화 | 네이버 지도 앱 호출 미지원 -> 네이버 지도 앱 연동 URL Scheme을 사용 | | 마커 드래그 | NMapPOIitem.setFloatingMode()를 호출해서 마커 드래그 기능 사용 | 마커 드래그 미지원 -> 화면의 중심에 마커 역할을 하는 뷰를 고정하고 지도를 움직여 위치를 지정하는 방식으로 구현 권장. 자세한 사항은[CameraEventActivity 데모](https://github.com/navermaps/android-map-sdk/blob/master/app/src/main/java/com/naver/maps/map/demo/java/camera/CameraEventActivity.java) 참조 | 참고 SDK 업그레이드에 대한 자세한 설명은 [2.x → 3.x 마이그레이션 가이드](https://navermaps.github.io/android-map-sdk/guide-ko/migration.html)를 참조해 주십시오. ### Mobile Dynamic Map iOS SDK 지원 사양 Mobile Dynamic Map iOS SDK의 지원 사양을 설명합니다. #### 운영체제 Mobile Dynamic Map iOS SDK가 지원하는 운영체제 버전은 다음과 같습니다. | SDK 버전 | OS 버전 | 개발 언어 | | --- | --- | --- | | Mobile Dynamic Map iOS 3.x | iOS 버전 9 이상 | Swift, Objective-C | #### SDK 배포 Mobile Dynamic Map iOS SDK version 3.x는 [cocoapods](https://cocoapods.org/)에서 배포됩니다. CocoaPods 인스톨을 한 다음, 대용량 라이브러리를 받기 위해 [git-lfs](https://git-lfs.com/)를 추가로 설치합니다. git-lfs 설치 후 반드시 초기화를 진행해야 합니다. 초기화를 완료한 다음 SDK를 최신 버전으로 업데이트해야 합니다. Mobile Dynamic Map iOS SDK version 3.x 데모 프로젝트는 [github 저장소](https://github.com/navermaps/ios-map-sdk)에서 다운로드 받을 수 있습니다. #### SDK 업그레이드 후 변경 사항 Mobile Dynamic Map iOS SDK의 버전이 2.x에서 3.x으로 업그레이드되면서 제공되지 않는 기능은 다음과 같습니다. | Deprecated feature | SDK 2.x | SDK 3.x | | --- | --- | --- | | Reverse Geocoding | NMapReverseGeocoder.findPlacemarkAtLocation:를 호출해서 좌표-주소 변환 기능 사용 | Reverse Geocoding 미지원 -> Reverse Geocoding REST API 사용 | | 네이버 지도앱 실행 버튼 | NMapView.setBuiltInAppControl:를 호출해서 네이버 지도앱 활성화 | 네이버 지도 앱 호출 미지원 -> 네이버 지도앱 연동 URL Scheme을 사용 | | 마커 드래그 | NMapPOIitem.setPOIflagMode:를 호출해서 마커 드래그 기능 사용 | 마커 드래그 미지원 -> 화면의 중심에 마커 역할을 하는 뷰를 고정하고 지도를 움직여 위치를 지정하는 방식으로 구현 권장. 자세한 사항은 [CameraEventActivity 데모](https://github.com/navermaps/ios-map-sdk/blob/master/NaverMapDemo/CameraEventViewController.swift) 참조 | 참고 SDK 업그레이드에 대한 자세한 설명은 [2.x → 3.x 마이그레이션 가이드](https://navermaps.github.io/ios-map-sdk/guide-ko/migration.html)를 참조해 주십시오. ### 네이버 지도 앱 연동 URL Scheme 지원 사양 네이버 지도 앱 연동 URL Scheme 이용을 위한 지원 사양을 설명합니다. #### 네이버 지도 앱 버전 네이버 지도 앱 연동 URL Scheme 기능은 네이버 지도 앱 버전 5부터 적용됐습니다. Play 스토어 또는 앱 스토어에서 최신 버전을 다운로드 받아 사용하는 것을 권장합니다. 최소 사양은 다음과 같습니다. | 운영체제 | 네이버 지도 앱 버전 | | --- | --- | | 안드로이드 | 5 이상 | | iOS | 5 이상 | ## API 사용 시 주의 사항 Maps API를 사용하여 서비스를 구현할 경우, 주의해야 할 사항은 다음과 같습니다. - Maps에서 제공하고 있는 기능 및 서비스 명칭을 임의로 변경하지 않도록 주의해 주십시오. 반드시 이 가이드에서 안내된 명칭(거리뷰, 길찾기, 내비게이션, 위성지도, 지적편집도, 지도검색, 대중교통, 실시간교통 등)과 동일하게 표기해야 합니다. <예시> 고객이 Web Dynamic Map을 이용하여 '거리뷰'를 보여줄 경우, '거리뷰'가 아닌 '입구뷰' 또는 '로드뷰' 등의 명칭으로 변경하여 표기할 수 없습니다. - 정식 호출 경로를 통하지 않고 API를 호출하는 행위는 어뷰징에 해당되며 서비스 이용이 제한됩니다. ## 이용 요금 Maps는 종량 요금제(구간 요금제)로 서비스하고 있습니다. Maps 이용 요금에 대한 자세한 기준은 다음의 페이지를 참조해 주십시오. - [**포털 > 서비스 > Application Services > Maps**](https://www.ncloud.com/product/applicationService/maps)