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

Available in VPC

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

Note

Since Maps is provided as an API service, the NAVER Cloud Platform console only allows you to subscribe, unsubscribe, manage usage, and navigate to the Style Editor web console.

Here are the topics covered in this guide:

Register an application

You must register the application after agreeing to the API terms of service. An 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.

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 to the primary account. Note that charges apply if you are using a non-primary account. To view whether the account currently logged into the console is a primary account, see View Maps primary 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 an 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 enter a name of up to 10 characters.
  5. In API selection, click on the API you wish to use.
  6. In the Service environment registration component, enter the service environment of the application.
    • Web service URL
      • Up to 10 web service URLs that begin 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 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 app in use, the authentication may fail.
    • iOS Bundle ID
      • For iOS applications only, up to 10 can be entered.
      • If the registered bundle ID differs from the information of the app in use, 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 is not completed.
    • When selecting Static Map, you must enter a web service URL. If no URL is entered, certain restrictions may apply to API use.
    • The client ID and secret value issued for 1 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].

View application information

You can view the list of registered applications in the Application Services > Maps > Application on the NAVER Cloud Platform console.
To view 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. View 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: The date the application was registered.
  4. Click [Credentials].

app_maps_home01_keyinfo_ko

  1. When the credentials window appears, view the credentials.
    • Application Key
      • Application name: The name that identifies 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. You can copy the 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. You can copy the value by clicking clovasummary-ico_01 and change the value by clicking [Reissue].
    • Service environment
      • Web service URL: The value required to use web SDKs.
      • Android app package name: The value required to use Android SDKs.
      • iOS Bundle ID: The value required to use iOS SDKs.
  2. Click [OK].
Caution

Make sure the Client ID and Client Secret are kept confidential. If you are concerned about security, reissue the credentials with a new value in step 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 the app_maps_hambarger_button1 button of the application you want to edit.
  4. Click the Edit application menu.
  5. Edit the necessary information and 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 the app_maps_hambarger_button1 button 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 view the usage status for each registered application and set various options for billing management.

View daily/monthly usage

To view daily and monthly usage:

  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. In the application list, view the real-time usage for the day and for the current month of the application for which you want to view the usage.
    • Based on UTC+9.
    • The daily usage is initialized to 0 at 12:00 AM (KST).
Note

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

Set usage limits

You can set daily and monthly usage limits yourself to prevent excessive service usage fees from being charged. To set usage limits:

  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 change.
  4. After selecting the API, click the enabled [Set limits and notifications] at the top.
    app_maps_home01_limit_ko_2
  5. Enter the daily and monthly limit values under the [Set limits] tab menu.
    maps-application_screen3_ko_2
  6. Click [Save].

Default and maximum API call limits by service

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

Service name Default call limit Maximum daily call limit Maximum monthly call 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 change history of usage limit under the [Limit change history] tab menu in the Set limits and notifications popup.
  2. Daily usage limits reset at 12:00 AM each day, and monthly usage limits reset at 12:00 AM on the first day of each month.
  3. The free usage quota provided only to the primary account may be exceeded if 2 or more instances are created and used to make API calls.

Use beyond the configured limit

This feature allows you to continue using the service up to an additionally configured maximum limit, even after exceeding your configured daily or monthly usage limit.

  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 change.
  4. After selecting the API, click the enabled [Set limits and notifications] at the top.
  5. In the [Set limits] tab, select Allow for usage beyond the configured limit.
  6. Enter the maximum monthly usage limit you want to allow.
  7. Click [Save].
Note

The maximum limit you can set when usage beyond the configured limit is allowed is the same as the maximum monthly limit.

Set notification recipients

To set up notification recipients and notification methods for when usage exceeds a specified percentage of the daily/monthly limit you set:

  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 change.
  4. After selecting the API, click the enabled [Set limits and notifications] at the top.
  5. Click the [Set notification recipients] tab menu.
  6. Select a notification recipient and the notification method, and 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 primary account

To view 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 [View primary account].
    maps-application_FirstID1_ko
  4. In the View primary account popup, view the primary account information.
    maps-application_FirstID2_ko
    • If the account currently logged into the console is not the primary account, a relevant guide is displayed.
      maps-application_FirstID21_ko
Note

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

Go to Maps Style Editor

The Style Editor, which becomes available after you subscribe to Maps, allows you to customize NAVER Map to suit your preferred style. To navigate to 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 is enabled. Click the button to navigate to the Style Editor.

app_maps_home01_steditor_ko

View 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.