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.

Application

Prev Next

The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.

Available in VPC

After subscribing to Maps, you can register an application in the Application menu on the NAVER Cloud Platform console.

Note

Because Maps is provided as an API-based service, the NAVER Cloud Platform console allows only service subscription and termination, usage management, and navigation to the Style Editor web console.

The following summarizes what you can learn from this guide:

Register an application

You must register the application after agreeing to the API terms of service. An Application is required to use the Maps APIs. Once you register an application, a unique client ID and a client secret value are created per application. You must apply the authentication key to the Maps API to receive authentication for using NAVER Maps.

Note

For more information on how to call APIs, see NAVER integrated API call in NAVER Cloud Platform's API guide.

Caution

Maps API offers a free usage quota exclusively for the primary account. If you are not the representative account, be careful because you will be charged. To check whether the account currently logged into the console is a representative account, check View Maps representative account.

To register an application:

  1. In the VPC environment of the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Maps.
  2. Click the Application menu.
  3. Click [Register application].
  4. Enter the application name.
    • You can enter up to 20 characters.
    • Depending on the service, the application name may be displayed on the interface, so use a name up to 10 characters.
  5. In Select API, click on the API you wish to use.
  6. From the Service Environment Registration area, enter the service environment of the application.
    • Web service URL
      • You can enter up to 10 web service URLs that begin with http://.
      • Do not distinguish between http and https, and exclude www when entering the value. Example: http://naver.com
      • Enter the main domain only even if there are subdomains.
      • If information of the service URL differs from the web used, the authentication may fail.
      • For hybrid apps, enter location.href object outputs. Example: file://local URL
    • Android app package name.
      • For Android applications only, up to 10 can be entered.
      • If the entered package name differs from the package name of the using app, the authentication may fail.
    • iOS Bundle ID
      • For iOS applications only, you can enter up to 10.
      • If the registered bundle ID differs from the information of the app used, the authentication may fail.
    Note
    • When selecting Dynamic Map, you must enter at least one of the following: The Web service URL, Android app package name, or iOS Bundle ID. If not entered, the application registration will not be completed.
    • When selecting Static Map, a web service URL should be entered. Some restrictions may apply on using the API if it is not provided.
    • The client ID and secret value issued for a single application may be applied to multiple environments including Android, iOS, web, and Windows App. However, the API usage is added up by each client ID.
  7. Click [Register].

Check application information

You can view the list of registered applications in the Application Services > Maps > Application on the NAVER Cloud Platform console.
To check application information from the application list:

  1. In the VPC environment of the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Maps.
  2. Click the Application menu.
  3. Check application information.
    • Application name: The name of the app set when registering the Application.
    • API: The API selected when registering the Application.
    • Daily/Monthly usage: Real-time usage by service (based on UTC+9).
    • Registration date and time:: The date when the Application was registered.
  4. Click [Authentication information].

app_maps_home01_keyinfo_ko

  1. When the authentication information window appears, check the authentication information.
    • Application Key
      • Application name: A name used to identify the Application.
      • Client ID (X-NCP-APIGW-API-KEY-ID): Enter "X-NCP-APIGW-API-KEY-ID" in the header or query string as the ID required for authentication. Can copy value by clicking clovasummary-ico_01
      • Client Secret (X-NCP-APIGW-API-KEY): Enter "X-NCP-APIGW-API-KEY" in the header or query string as the SecretKey required for authentication. Can copy value by clicking clovasummary-ico_01, and change the value by clicking [Reissue].
    • Service environment
      • Web service URL: A value required to use the Web SDK.
      • Android app package name: A value required to use the Android SDK.
      • iOS Bundle ID: A value required to use the iOS SDK.
  2. Click [OK].
Caution

Make sure the client ID and client secret are kept confidential. If you are concerned about security, reissue the authentication information with new values in 6.

Edit an application

To edit the registered application information:

  1. In the VPC environment of the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Maps.
  2. Click the Application menu.
  3. Click app_maps_hambarger_button1 of the application you want to edit.
  4. Click the Edit application menu.
  5. Edit the necessary information, and then click [Save].

Delete an application

To edit the registered application information:

  1. In the VPC environment of the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Maps.
  2. Click the Application menu.
  3. Click app_maps_hambarger_button1 of the application you want to delete.
  4. Click the Delete application menu.
  5. In the Delete application window, verify the application name and click [OK].

Manage Maps usage

You can check the usage status for each registered application and set various options for billing management.

Check daily/monthly usage

To check the usage for the day and for the current month:

  1. In the VPC environment of the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Maps.
  2. Click the Application menu.
  3. From the application list, check the real-time usage for the day and for the current month of the application for which you want to check the usage.
    • Based on UTC+9
    • The daily usage is initialized to 0 at 00:00 AM (KST).
Note

It takes around 1 minute for the actual daily/monthly usage to be reflected.

Usage Limit Settings

To prevent excessive service charges, you can configure daily and monthly usage limits for each API. To configure usage limits:

  1. In the NAVER Cloud Platform console, go to Menu > All Services > Application Services > Maps.
  2. Click the Application menu.
  3. Select the API of the application for which you want to change the usage limit.
  4. After selecting the API, click the [Limit & Notification Settings] button at the top.
    app_maps_home01_limit_en_2
  5. In the [Usage Limit Settings] tab, enter the Daily Usage Limit and Monthly Usage Limit.
    maps-application_screen3_en_2
  6. Click the [Save] button.

Default and Maximum API Call Limits by Service

The available API call limits for each service are as follows.

Service Default Call Limit Maximum Daily Limit Maximum Monthly Limit
Dynamic Map 6,000,000 15,000,000 45,000,000
Static Map 3,000,000 7,500,000 25,000,000
Geocoding 3,000,000 7,500,000 25,000,000
Reverse Geocoding 3,000,000 7,500,000 25,000,000
Directions 5 60,000 150,000 500,000
Directions 15 3,000 10,000 25,000
Note
  1. You can view the history of usage limit changes in the [Usage Limit Change History] tab of the Limit & Notification Settings window.
  2. Usage limits are reset daily at 00:00 and monthly at 00:00 on the first day of each month.
  3. The free usage quota provided to the primary account may be exceeded when API calls are made from two or more instances. Please take this into consideration.

Over-limit Usage

Over-limit Usage allows your application to continue using the API beyond the configured daily or monthly usage limit, up to the maximum limit you specify.

  1. In the NAVER Cloud Platform console, go to Menu > All Services > Application Services > Maps.
  2. Click the Application menu.
  3. Select the API of the application for which you want to change the usage limit.
  4. After selecting the API, click the [Limit & Notification Settings] button at the top.
  5. In the [Usage Limit Settings] tab, enable Allow Over-limit Usage.
  6. Enter the maximum monthly usage limit.
  7. Click the [Save] button.
Note

The Maximum Limit that can be configured when Allow Over-limit Usage is enabled cannot exceed the Maximum Monthly Limit for the selected service.

Set notification recipients

To set up notification recipients and notification methods for when a certain usage rate of the daily/monthly limit value set by the user is exceeded:

  1. In the VPC environment of the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Maps.
  2. Click the Application menu.
  3. From the application list, select the API for the application whose usage limit you want to modify.
  4. After selecting the API, click the enabled [Limits and notifications settings] button at the top.
  5. Click the [Set notification recipients] tab menu.
  6. Select a person to receive notifications and the notification method, and then click [Add].
    • To add a new person, click [Manage notification recipients].
  7. Once you complete setting up the notification recipients, click [Save].
Note

You can select only registered notification recipients in the notification recipient settings. You can register a new person in the Notification Recipient service. For more information, see Add recipient in the Notification Recipient user guide.

View Maps representative account

To check the Maps API primary account:

  1. In the VPC environment of the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Maps.
  2. Click the Application menu.
  3. When the guide popup appears, click [Check primary account].
    maps-application_FirstID1_ko
  4. In the [View representative account] popup, check your representative account.
    maps-application_FirstID2_ko
    • If the account currently logged into the console is not the representative account, a relevant guide will be displayed.
      maps-application_FirstID21_ko
Note

You can also view the popup in step 5 by clicking [Check primary account] on the Application interface.
app_maps_home01_representaccount_ko

Go to Maps Style Editor

After completing the Maps service subscription, the Style Editor allows you to customize NAVER Maps with your own styles. To access the Style Editor:

  1. In the VPC environment of the NAVER Cloud Platform console, navigate to Menu > All Services > Application Services > Maps.
  2. Click the Application menu.
  3. Once your subscription is successfully completed, the [Style Editor] button will be enabled. Click the button to go to the Style Editor.

app_maps_home01_steditor_ko

Check Maps development guide

This provides various development resource information related to the Maps service.

Business Registration Number: 129-86-31394 E-commerce Permit Number:No. 2009-GyeonggiSeongnam-0510
CEO: Kim Yuwon Address: NAVER Green Factory 17th–26th Floors, Buljeong-ro 6, Bundang-gu, Seongnam-si, Gyeonggi-do 13561, Republic of Korea. Customer Support Number: 1544-5876
© NAVER Cloud Corp. All Rights Reserved.