Application
    • PDF

    Application

    • PDF

    Article Summary

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

    Maps 지원 사양과 사용 시나리오를 확인했다면 Maps 이용을 시작하기 위한 준비를 완료한 것입니다. 이제 다음으로 할 일은 Maps에 대한 이용 신청을 진행하고 관리하는 것입니다. Maps 이용 신청 및 관리는 네이버 클라우드 플랫폼 콘솔의 Application 메뉴에서 진행합니다.

    참고

    Maps는 API로 제공하는 서비스이기 때문에 네이버 클라우드 플랫폼 콘솔에서는 이용 신청과 해지, 이용 관리만 가능합니다. 콘솔 UI 화면에 대한 상세한 설명은 AI·NAVER API 공통 문서인 Application 사용 가이드를 확인합니다.

    이 가이드를 통해 학습하게 되는 내용을 정리하면 다음과 같습니다.

    Maps 이용 신청

    Maps는 이용 신청 과정이 별도로 존재하지 않습니다. 네이버 클라우드 플랫폼 콘솔의 Services > AI·NAVER API > AI·NAVER API > Application에서 Applicaiton을 바로 생성하고 관리할 수 있습니다. Applicaiton을 생성하려면 네이버 클라우드 플랫폼 콘솔에서 AI·NAVER API 서비스 이용 약관에 동의해야 합니다. AI·NAVER API 서비스 이용 약관은 사용자의 권리 및 의무, 이용 제한 및 이용 요금, 특약 조건 등에 대한 내용을 담고 있으므로 Maps 이용 전 반드시 확인이 필요합니다.

    참고

    AI·NAVER API 서비스 이용 약관 동의는 네이버 클라우드 플랫폼의 AI·NAVER API 서비스 최초 이용 시 진행합니다. 이미 AI·NAVER API의 다른 서비스를 이용 중인 경우 이 과정은 생략되므로 Application 등록으로 이동해 주십시오.

    Maps 이용을 위해 AI·NAVER API 서비스 이용 약관에 동의하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
    2. Region 메뉴에서 이용 중인 리전을 클릭하여 선택해 주십시오.
    3. Platform 메뉴에서 VPCClassic 가운데 클릭하여 선택해 주십시오.
    4. Services > AI·NAVER API > AI·NAVER API 메뉴를 차례대로 클릭해 주십시오.
    5. Application 메뉴를 클릭해 주십시오.
    6. [Applicaiton 등록] 버튼을 클릭해 주십시오.
    7. AI·Naver API 이용약관 화면이 나타나면 AI·Naver API 이용약관에 동의합니다. 를 클릭해 주십시오.
    8. [확인] 버튼을 클릭해 주십시오.
    9. 등록할 수 있는 Application 목록을 확인하고 다음 과정을 진행해 주십시오.
    참고

    네이버 클라우드 플랫폼 포털의 서비스 > Application Services > Maps 에 있는 [이용 신청하기] 버튼을 클릭하면 6.의 화면으로 바로 이동할 수 있습니다.

    Application 등록

    API 서비스 이용 약관에 동의한 후 Application을 등록해야 합니다. Application은 Maps의 API를 이용하기 위해 반드시 필요합니다. Application을 등록하면 Application 한 개당 고유한 Client ID와 Client Secret 값이 생성됩니다. Maps API에 인증키를 적용해야만 네이버 지도 사용에 대한 인증을 받을 수 있습니다.

    참고

    API 호출 방법에 대한 자세한 설명은 네이버 클라우드 플랫폼 API 가이드의 NAVER 연동 API 호출을 참조해 주십시오.

    주의

    Maps API 중 Web Dynamic Map API, Static Map API, Geocoding API, Reverse Geocoding API는 대표 계정에 한하여 무료 이용량을 제공합니다. 대표 계정이 아닐 경우에는 과금이 되므로 주의해야 합니다. 본 정책은 2023년 1월부터 서비스에 적용되고 있습니다. 현재 콘솔에 로그인한 계정이 대표 계정인지 아닌지 확인하는 방법은 Maps 대표 계정 조회를 확인해 주십시오.

    Application을 등록하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴에서 이용 중인 리전을 클릭하여 선택해 주십시오.
    2. Platform 메뉴에서 VPCClassic 가운데 클릭하여 선택해 주십시오.
    3. Services > AI·NAVER API > AI·NAVER API 메뉴를 차례대로 클릭해 주십시오.
    4. Application 메뉴를 클릭해 주십시오.
    5. [Applicaiton 등록] 버튼을 클릭해 주십시오.
    6. Application 이름을 입력해 주십시오.
      • 최대 20 자까지 입력 가능
      • 서비스 성격에 따라 Application 이름이 화면에 출력될 수 있으므로 10자 이내로 입력 권장
    7. Service 선택 영역에서 Maps를 클릭하여 선택해 주십시오.
      • Maps 체크박스를 클릭한 경우 전체 Maps 선택됨
      • Maps 체크박스 클릭 해제 후, 개별 Maps 선택 가능
      • [서비스 설명/요금 안내] 버튼: 클릭 시 네이버 클라우드 플랫폼 포털의 서비스 소개 화면으로 이동
      • [개발 가이드] 버튼: 클릭 시 Maps 사용 가이드로 이동
    8. 서비스 환경 등록 영역에서 Application의 서비스 환경을 입력해 주십시오.
      • Web 서비스 URL
        • http://로 시작하는 웹 서비스 URL을 최대 10개까지 입력 가능
        • http와 https는 구분하지 않으며, www는 제외하고 입력 <예시> http://naver.com
        • 서브 도메인이 있는 경우 대표 도메인만 입력
        • 서비스 URL과 이용하는 웹의 정보가 다른 경우 인증 실패할 수 있음
        • 하이브리드 앱은 location.href 객체 출력값 입력 <예시> file://로컬 URL
      • Android 앱 패키지 이름
        • Android 애플리케이션만 해당하며, 최대 10개까지 입력 가능
        • 입력한 패키지 이름과 이용하는 앱의 패키지 이름이 다른 경우 인증 실패할 수 있음
      • iOS Bundle ID
        • iOS 애플리케이션만 해당하며, 최대 10개까지 입력 가능
        • 등록된 Bundle ID와 이용하는 앱의 정보가 다른 경우 인증 실패할 수 있음
      참고
      • Web Dynamic Map 선택 시 Web 서비스 URL을 입력해야 합니다. 입력하지 않을 경우, Application 등록이 완료되지 않습니다.
      • Mobile Dynamic Map 선택 시 Android 앱 패키지 이름 또는 iOS Bundle ID를 입력해야 합니다. 입력하지 않는 경우, SDK 이용에 일부 제약이 있을 수 있습니다.
      • Static Map 선택 시 Web 서비스 URL을 입력해야 합니다. 입력하지 않을 경우, API 이용에 일부 제약이 있을 수 있습니다.
      • 하나의 Application에 발급된 Client ID와 Secret 값을 안드로이드, iOS, 웹, Windows App 등 여러 환경에 적용할 수 있습니다. 단, API 사용량은 클라이언트 아이디별로 합산됩니다.
    9. [등록] 버튼을 클릭해 주십시오.

    Application 정보 확인

    등록된 Application 목록은 네이버 클라우드 플랫폼 콘솔의 AI·NAVER API > AI·NAVER API > Application 메뉴에서 확인할 수 있습니다. Application 목록에서 Application 정보를 확인하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
    2. Services > AI·NAVER API > AI·NAVER API 메뉴를 차례대로 클릭해 주십시오.
    3. Application 메뉴를 클릭해 주십시오.
    4. Application 정보를 확인해 주십시오.
      • App 이름: Application 등록 시 설정한 앱의 이름
      • 서비스 구분: Application 등록 시 선택한 서비스
      • 당일/당월 사용량: 서비스별 실시간 사용량 (UTC+9 기준)
      • 한도 및 알림 설정: API 호출 이용 한도와 특정 값(%) 초과 시 알림 설정
      • 등록일: Application을 등록한 날짜
    5. [인증 정보] 버튼을 클릭해 주십시오.
      maps-application_screen1_ko
    6. 인증 정보 창이 나타나면 인증 정보를 확인해 주십시오.
      • Application Key
        • Application 이름: Application을 구분하는 이름
        • Client ID (X-NCP-APIGW-API-KEY-ID): 인증에 필요한 ID로 헤더 또는 쿼리 스트링에 'X-NCP-APIGW-API-KEY-ID'로 입력. clovasummary-ico_01 클릭 시 값 복사 가능
        • Client Secret (X-NCP-APIGW-API-KEY): 인증에 필요한 SecretKey 비밀번호로 헤더 또는 쿼리 스트링에 'X-NCP-APIGW-API-KEY'로 입력. clovasummary-ico_01 클릭 시 값 복사 가능하며 [재발급] 버튼 클릭 시 값 변경 가능
      • 서비스 환경
        • Web 서비스 URL: Web SDK를 사용하기 위해 필요한 값
        • Android 앱 패키지 이름: Android SDK를 사용하기 위해 필요한 값
        • iOS Bundle ID: iOS SDK를 사용하기 위해 필요한 값
    7. [확인] 버튼을 클릭해 주십시오.
    주의

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

    Application 수정

    등록한 Application 정보를 수정하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
    2. Services > AI·NAVER API > AI·NAVER API 메뉴를 차례대로 클릭해 주십시오.
    3. Application 메뉴를 클릭해 주십시오.
    4. 수정할 Application의 [수정] 버튼을 클릭해 주십시오.
    5. 필요한 정보를 수정한 다음 [저장] 버튼을 클릭해 주십시오.

    Maps 이용 관리

    등록한 Application별 이용 현황을 확인하고 과금 관리를 위한 다양한 옵션을 설정할 수 있습니다.

    당일/당월 이용량 확인

    당일 이용량과 당월 이용량을 확인하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
    2. Services > AI·NAVER API > AI·NAVER API 메뉴를 차례대로 클릭해 주십시오.
    3. Application 메뉴를 클릭해 주십시오.
    4. Application 목록에서 이용량을 확인할 애플리케이션의 당일 이용량과 당월 이용량의 실시간 이용 현황을 확인해 주십시오.
      • UTC+9 기준
      • 한국 시간 기준으로 00:00 AM에 일별 이용량이 0으로 초기화
    참고

    실제 당일/당월 사용량은 반영되기까지 약 1분 정도 시간이 소요됩니다.

    이용 한도 설정

    서비스 이용 요금이 과도하게 청구되는 것을 방지하기 위해 일별, 월별 이용 한도를 직접 설정할 수 있습니다. 이용 한도를 설정하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
    2. Services > AI·NAVER API > AI·NAVER API 메뉴를 차례대로 클릭해 주십시오.
    3. Application 메뉴를 클릭해 주십시오.
    4. Application 목록에서 이용 한도를 변경할 애플리케이션의 [한도 및 알림 설정] 버튼을 클릭해 주십시오.
      maps-application_screen2_ko
    5. [한도 설정] 탭 메뉴에서 월별 한도 값과 일별 한도 값을 입력해 주십시오.
      maps-application_screen3_ko
    6. [저장] 버튼을 클릭해 주십시오.
    참고

    이용 한도를 변경한 이력은 한도 및 알림 설정 팝업 창의 [한도 변경 이력] 탭 메뉴에서 확인할 수 있습니다.

    임계치 알림 설정

    사용자가 설정한 일별/월별 한도 값의 특정 사용률을 초과한 경우, 이메일 또는 SMS로 알림을 받을 수 있습니다.
    임계치 알림을 설정하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
    2. Services > AI·NAVER API > AI·NAVER API 메뉴를 차례대로 클릭해 주십시오.
    3. Application 메뉴를 클릭해 주십시오.
    4. Application 목록에서 이용 한도를 변경할 애플리케이션의 [한도 및 알림 설정] 버튼을 클릭해 주십시오.
    5. [한도 설정] 탭 메뉴에서 월별 한도 설정 또는 일별 한도 설정 항목의 체크 박스를 클릭하여 선택해 주십시오.
    6. 알림 기준이 될 임계치 값(%)을 선택해 주십시오.
      maps-application_screen4_ko
      • 70%을 선택한 경우, 70%, 80%, 90%, 100%에 알림
      • 90%을 선택한 경우, 90%, 100%에 알림
    7. [저장] 버튼을 클릭해 주십시오.
    8. 통보 대상 설정을 참조하여 임계치 알림 설정을 받을 주소를 입력해 주십시오.
    참고

    임계치 알림을 설정했더라도 통보 대상자를 설정하지 않으면 알림이 수신되지 않습니다. 반드시 통보 대상자를 설정해 주십시오.

    통보 대상 설정

    사용자가 설정한 일별/월별 한도 값의 특정 사용률을 초과한 경우 알림을 받을 수신자와 수신 방법을 설정하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
    2. Services > AI·NAVER API > AI·NAVER API 메뉴를 차례대로 클릭해 주십시오.
    3. Application 메뉴를 클릭해 주십시오.
    4. Application 목록에서 이용 한도를 변경할 애플리케이션의 [한도 및 알림 설정] 버튼을 클릭해 주십시오.
    5. [통보대상 설정] 탭 메뉴를 클릭해 주십시오.
    6. 통보 대상 담당자를 선택하고 통보 방법을 선택한 후 [추가] 버튼을 클릭해 주십시오.
      • 신규 담당자를 추가하기 위해 Cloud Insight(Monitoring)로 이동하려면 [통보 대상 관리] 버튼 클릭
    7. 통보 대상자 설정이 완료되면 [저장] 버튼을 클릭해 주십시오.
    참고

    통보 대상 설정에서는 등록된 통보 대상 담당자만 선택할 수 있습니다. 새로운 담당자를 등록하는 작업은 Cloud Insight의 Notification Recipient 메뉴에서 수행할 수 있습니다. 자세한 설명은 Notification Recipient 사용 가이드 대상자 추가를 참조해 주십시오.

    Maps 이용 해지

    Maps는 이용 해지 과정이 별도로 존재하지 않습니다. 생성한 Maps의 Application을 삭제하면 이용 해지가 된 것입니다. Application을 삭제하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
    2. Services > AI·NAVER API > AI·NAVER API 메뉴를 차례대로 클릭해 주십시오.
    3. Application 메뉴를 클릭해 주십시오.
    4. 삭제할 Maps의 Application을 클릭한 다음 [삭제] 버튼을 클릭해 주십시오.
    5. 앱 삭제 팝업 창이 나타나면 [확인] 버튼을 클릭해 주십시오.

    Maps 대표 계정 조회

    Maps API 요금제 변경으로 인해 Web Dynamic Map, Static Map API, Geocoding API, Reverse Geocoding API에 대한 무료이용량이 대표 계정에 한해 제공됩니다. Maps API 대표 계정을 확인하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
    2. Services > AI·NAVER API > AI·NAVER API 메뉴를 차례대로 클릭해 주십시오.
    3. Application 메뉴를 클릭해 주십시오.
    4. 안내 팝업 창이 나타나면 [대표 계정 확인하기] 버튼을 클릭해 주십시오.
      maps-application_FirstID1_ko
    5. 대표 계정 확인 팝업 창에서 대표 계정을 확인해 주십시오.
      maps-application_FirstID2_ko
      • 현재 콘솔에 로그인 한 계정이 대표 계정이 아닐 경우, 관련 안내 사항이 나타납니다.
        maps-application_FirstID21_ko
    참고

    Application 화면에서 [대표 계정 확인] 버튼을 클릭해도 5.의 팝업 창을 확인할 수 있습니다.
    maps-application_FirstID11_ko


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

    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.