Application

Available in Classic and VPC

Once you have noted the supported specifications and usage scenarios for Maps, you are ready to start using Maps. Now, process and manage your subscription to Maps. You can request and manage your subscription to Maps in the Application menu of NAVER Cloud Platform console.

The following summarizes what you can learn from this guide.

• From the NAVER Cloud Platform console
  • Subscribing to Maps
    • Registering application
    • Viewing application information
    • Editing application
  • Managing Maps usage
    • Checking daily/monthly usage
    • Setting usage limits
    • Setting threshold notifications
    • Setting notification recipients
  • Unsubscribing Maps
  • Searching the Maps representative account

Subscribing to Maps

There is no separate procedure for subscribing to Maps. You can create and manage an application directly from Services > AI·NAVER API > AI·NAVER API > Application in the NAVER Cloud Platform console. To create an application, you must agree to the AI·NAVER API Terms of service in the NAVER Cloud Platform console. The AI·NAVER API Terms of service contain the rights and obligations of the user, usage restrictions and usage fees, and special terms and conditions, so you must check them before using Maps.

To use Maps, you can agree to the AI·NAVER API Terms of service as follows:

1. Access the NAVER Cloud Platform console.
2. From the Region menu, click and select the region you're using.
3. From the Platform menu, click to select between VPC and Classic.
4. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
5. Click the Application menu.
6. Click the [Register application] button.
7. When the AI·NAVER API Terms of service screen appears, click Agree to the AI·NAVER API Terms of service.
8. Click the [OK] button.
9. Check the list of applications that can be registered and proceed to the next step.
   • Registering application
   • Viewing application information
   • Editing application

Registering application

You must register the application after agreeing to the API Terms of service. The application is required for the use of Maps API. 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.

The following describes how to register an application.

1. From the NAVER Cloud Platform console's Region menu, click and select the region you're using.

2. From the Platform menu, click to select between VPC and Classic.

3. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.

4. Click the Application menu.

5. Click the [Register application] button.

6. Enter the application name.

   • Up to 20 characters can be entered
   • Depending on the service, the application name may be displayed on the screen, so use a name up to 10 characters

7. In the Service selection area, click and select Maps.

   • If the Maps checkbox is clicked, all Maps will be selected.
   • After unchecking the Maps checkbox, individual Maps can be selected.
   • [Service description/fee information] button: click and go to the service introduction screen of the NAVER Cloud Platform portal
   • [Development guide] button: click and go to Maps

8. Enter the service environment of the application in the service environment registration area.

   • Web service URL
     • Up to 10 web service URLs with http:// can be entered
     • No difference between http and https. Enter excluding www. <example> http://naver.com
     • Enter the main domain only even if there are sub-domains
     • 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 inputs are allowed
     • 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, up to 10 inputs are allowed
     • If the registered bundle ID differs to the information of the app used, the authentication may fail
   Note

   • When selecting Web Dynamic Map, a web service URL should be entered. If not entered, the application registration will not be completed.
   • When selecting Mobile Dynamic Map, an Android app package name or iOS Bundle ID must be entered. Some restrictions may apply on using the SDK if it is not provided.
   • 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 one application may be applied to multiple environments including Android, iOS, web, Windows App, etc. However, the API usage is added up by each client ID.

9. Click the [Register] button.

Viewing application information

You can check the list of registered applications in the AI·NAVER API > AI·NAVER API > Application menu in the NAVER Cloud Platform Console. The following describes how to check application information in the application list.

1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
2. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
3. Click the Application menu.
4. Check application information.
   • App name: app's name when registering the application
   • Service category: selected service when registering the application
   • Daily/monthly usage: real-time usage by service (based on UTC+9)
   • Limit and notification setting: API call usage limit and notification setting when a specific value (%) is exceeded
   • Registration date: the date the application was registered
5. Click the [Authentication information] button.
   
6. When the authentication information window appears, check the authentication information.
   • Application Key
     • Application name: the name 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. Copy value on click
     • Client Secret (X-NCP-APIGW-API-KEY-ID): enter 'X-NCP-APIGW-API-KEY' in the header or query string as the SecretKey required for authentication. Available to copy value on click, and change value with clicking the [Reissue] button
   • Service environment
     • Web service URL: value required to use Web SDK
     • Android app package name: value required to use Android SDK Value
     • iOS Bundle ID: value required to use iOS SDK
7. Click the [OK] button.

Editing application

The following describes how to edit the registered application information.

1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
2. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
3. Click the Application menu.
4. Click the [Settings] button of the application you want to edit.
5. Edit the necessary information, and then click the [Save] button.

Managing Maps usage

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

Checking daily/monthly usage

You can see the usage for the day and for the current month as follows:

1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
2. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
3. Click the Application menu.
4. In the application list, check the real-time usage status of the daily usage and current month usage of the application for which you want to check the usage.
   • Based on UTC+9
   • The daily usage is reset to 0 at 00:00 AM (KST)

Setting usage limits

To prevent excessive usage fees being charged, you can set up daily and monthly usage limits yourself. The following describes how to set up a usage limit.

1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
2. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
3. Click the Application menu.
4. Click the [Set limits and notifications] button from the application list of the application you want to edit the usage limit.
   
5. Enter the monthly and daily limit values under the [Set limits] tab menu.
   
6. Click the [Save] button.

Setting threshold notifications

You can choose to receive notifications through email or SMS when a certain usage rate of the daily/monthly limit value set by the user is exceeded.
You can set up a threshold notification as follows:

1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
2. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
3. Click the Application menu.
4. Click the [Set limits and notifications] button from the application list of the application you want to edit the usage limit.
5. Click the checkbox for the daily or monthly limit settings field under the [Set limits] tab menu.
6. Select the threshold value (%) at which you want to be notified.
   
   • If 70% is selected, notifications are sent at 70%, 80%, 90%, and 100%
   • If 90% is selected, notifications are sent at 90% and 100%
7. Click the [Save] button.
8. See Setting notification recipients to enter the address at which you want to receive the threshold notifications.

Setting notification recipients

The following describes how 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. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
2. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
3. Click the Application menu.
4. Click the [Set limits and notifications] button from the application list of the application you want to edit the usage limit.
5. Click the [Set notification recipients] tab menu.
6. Select a person to receive notifications and the notification method, and then click the [Add] button.
   • To go to Cloud Insight (Monitoring) to add a new person, click the [Manage notification recipients] button
7. Once you complete setting up the notification recipients, click the [Save] button.

Unsubscribing Maps

There is no separate procedure for unsubscribing Maps. If you delete the application of Maps you created, your application is successfully unsubscribed. The following describes how to delete an application.

1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
2. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
3. Click the Application menu.
4. Click the application of Maps to be deleted, then click the [Delete] button.
5. When the Delete app pop-up window is displayed, click the [OK] button.

Searching the Maps representative account

Due to the change in the Maps API pricing plan, the free usage for the Web Dynamic Map, Static Map API, Geocoding API, and Reverse Geocoding API is provided only to the representative account. The method to check the Maps API representative account is as follows:

1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
2. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
3. Click the Application menu.
4. When the Guide pop-up window appears, click the [View representative account] button.
   
5. In the [View representative account] pop-up window, check your representative account.
   
   • If the account currently logged into the console is not the representative account, a relevant guide will be displayed.