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

最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。

VPC環境で利用できます。

Mapsご利用の申し込み後、NAVERクラウドプラットフォームコンソールの Applicationメニューで Application登録を行います。

参考

Mapsは APIで提供するサービスであるため、NAVERクラウドプラットフォームコンソールではご利用の申し込みや解約、利用管理、Style Editorウェブコンソールへの移動のみ可能です。

このガイドで学習する内容をまとめると、次の通りです。

Application登録

APIサービス利用規約に同意した後に、Applicationを登録します。Applicationは Mapsの APIを利用するために必ず必要です。Applicationを登録すると、Application 1つにつき固有の認証番号である Client IDと Client Secret値が作成されます。Maps APIに認証キーを適用することで、NAVERマップを使用するための認証を取得できます。

参考

API呼び出し方法についての詳細は、NAVERクラウドプラットフォーム APIガイドの NAVER連携 API呼び出しをご参照ください。

注意

Maps APIは代表アカウントに限り、無料利用量を提供します。代表アカウントでない場合、課金されるのでご注意ください。現在コンソールにログインしているアカウントの代表アカウント有無を確認する方法は、Maps代表アカウント照会をご確認ください。

Applicationを登録する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Application Services > Mapsメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. [Application登録] ボタンをクリックします。
  4. Application名を入力します。
    • 最大20文字まで入力可能
    • サービスの性質により、Application名が画面に表示される可能性があるため、10文字以内での入力を推奨
  5. API選択で使用する APIをクリックして選択します。
  6. サービス環境登録領域で Applicationのサービス環境を入力します。
    • Webサービス URL
      • http://で始まるウェブサービス URLを最大10個まで入力可能
      • httpと httpsは区分せず、wwwは除外して入力 例) http://naver.com
      • サブドメインがある場合、代表ドメイン名のみ入力
      • サービス URLと利用する Webの情報が異なる場合、認証に失敗することがあります
      • ハイブリッドアプリは、location.hrefオブジェクト出力値を入力 例) file://ローカル URL
    • Androidアプリのパッケージ名
      • Androidアプリケーションのみ該当し、最大10個まで入力可能
      • 入力したパッケージ名と利用するアプリのパッケージ名が異なる場合、認証に失敗することがあります
    • iOS Bundle ID
      • iOSアプリケーションのみ該当し、最大10個まで入力可能
      • 登録された Bundle IDと利用するアプリの情報が異なる場合、認証に失敗することがあります
    参考
    • Dynamic Mapを選択する際、Webサービス URL、Androidアプリパッケージ名、または iOS Bundle IDのいずれか1つ以上を必ず入力する必要があります。入力しない場合、Application登録が完了しません。
    • Static Map選択時、Webサービス URLを入力する必要があります。入力しない場合、APIの利用に一部制限があることがあります。
    • 1つの Applicationに発行された Client IDと Secret値を Android、iOS、Web、Windows Appなど様々な環境に適用できます。ただし、APIの使用量はクライアント ID別に合算されます。
  7. [登録] ボタンをクリックします。

Application情報確認

登録された Applicationリストは NAVERクラウドプラットフォームコンソールの Application Services > Maps > Applicationメニューで確認できます。
Applicationリストで Application情報を確認する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Application Services > Mapsメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. Application情報を確認します。
    • Application名: Application登録時に設定したアプリの名前
    • API: Application登録時に選択した API
    • 当日/当月使用量: サービス別のリアルタイム使用量(UTC+9基準)
    • 登録日時: Applicationを登録した日付
  4. [認証情報] ボタンをクリックします。

app_maps_home01_keyinfo_ko

  1. 認証情報画面が表示されたら、認証情報を確認します。
    • 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を利用するために必要な値
  2. [確認] ボタンをクリックします。
注意

Client IDと Client Secretが外部に表示されないようにご注意ください。セキュリティ上の懸念がある場合、6.で認証情報を新しい値に再発行します。

Application変更

登録した Application情報を変更する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Application Services > Mapsメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. 変更する Applicationの app_maps_hambarger_button1 ボタンをクリックします。
  4. Application変更メニューをクリックします。
  5. 必要な情報を変更した後、 [保存] ボタンをクリックします。

Application削除

登録した Application情報を変更する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Application Services > Mapsメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. 削除する Applicationの app_maps_hambarger_button1 ボタンをクリックします。
  4. Application削除メニューをクリックします。
  5. Application削除のポップアップで Application名を確認し、 [確認] ボタンをクリックします。

Mapsの利用管理

登録した Application別利用状況を確認し、課金管理のための様々なオプションを設定できます。

当日/当月の使用量確認

当日の使用量と当月の使用量を確認する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Application Services > Mapsメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. Applicationリストで使用量を確認するアプリケーションの当日の使用量と当月の使用量のリアルタイム使用状況を確認します。
    • UTC+9基準
    • 韓国時間を基準に00:00 AMに日別利用量が0に初期化されます
参考

実際当日/当月使用量は反映されるまで約1分かかります。

利用上限の設定

過剰なサービス料金の発生を防ぐため、APIごとに日次および月次の利用上限を設定できます。利用上限の設定方法は以下のとおりです。

  1. NAVER Cloud Platformコンソールで Menu > All Services > Application Services > Maps の順にクリックします。

  2. Application メニューをクリックします。

  3. 利用上限を変更するアプリケーションのAPIを選択します。

  4. APIを選択した後、上部の [Limit & Notification Settings] ボタンをクリックします。
    app_maps_home01_limit_ja_2

  5. [Usage Limit Settings] タブで、1日の利用上限と月間利用上限を入力します。
    maps-application_screen3_ja_3

  6. [Save] ボタンをクリックします。

サービスごとの基本呼び出し上限および最大上限

各サービスで利用可能な呼び出し上限は以下のとおりです。

サービス 基本呼び出し上限 1日の最大上限 月間最大上限
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
参考
  1. 利用上限の変更履歴は、Limit & Notification Settings ポップアップの [Usage Limit Change History] タブで確認できます。
  2. 利用上限は毎日0時および毎月1日0時にリセットされます。
  3. 代表アカウントに提供される無料利用枠は、2つ以上のインスタンスからAPIを利用した場合、超過する可能性がありますのでご注意ください。

上限超過利用

上限超過利用を有効にすると、設定した日次または月次の利用上限を超えた場合でも、指定した最大上限まで引き続きAPIを利用できます。

  1. NAVER Cloud Platformコンソールで Menu > All Services > Application Services > Maps の順にクリックします。
  2. Application メニューをクリックします。
  3. 利用上限を変更するアプリケーションのAPIを選択します。
  4. APIを選択した後、上部の [Limit & Notification Settings] ボタンをクリックします。
  5. [Usage Limit Settings] タブで Allow Over-limit Usage を有効にします。
  6. 月間の最大利用上限を入力します。
  7. [Save] ボタンをクリックします。
参考

Allow Over-limit Usage を有効にした場合に設定できる最大上限は、各サービスの月間最大上限を超えることはできません。

通知対象設定

ユーザーが設定した日別/月別限度値の特定使用率を超過した場合、通知を受ける受取人と受信方法を設定する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Application Services > Mapsメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. Applicationリストから利用限度を変更するアプリケーションの APIを選択します。
  4. APIを選択し、有効になった上部の [限度と通知の設定] ボタンをクリックします。
  5. [通知対象設定] タブメニューをクリックします。
  6. 通知対象の担当者を選択して通知方法を選択し、 [追加] ボタンをクリックします。
    • 新しい担当者を追加するために Notification Recipientに移動するには、 [通知対象管理] ボタンをクリック
  7. 通知対象者の設定が完了したら、 [保存] ボタンをクリックします。
参考

通知対象の設定では、登録された通知対象担当者のみ選択できます。新しい担当者を登録するタスクは、Notification Recipientサービスで実行できます。詳細は、Notification Recipientご利用ガイドの対象者追加をご参照ください。

Mapsの代表アカウント照会

Maps APIの代表アカウントを確認する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Application Services > Mapsメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. 案内のポップアップが表示されたら、[代表アカウントを確認する] ボタンをクリックします。
    maps-application_FirstID1_ko
  4. 代表アカウント確認のポップアップで代表アカウントを確認します。
    maps-application_FirstID2_ko
    • 現在コンソールにログインしているアカウントが代表アカウントでない場合、関連する案内が表示されます。
      maps-application_FirstID21_ko
参考

Application画面で [代表アカウント確認] ボタンをクリックしても、5.のポップアップを確認できます。
app_maps_home01_representaccount_ko

Maps Style Editorに移動

Mapsご利用の申し込み後に利用できる Style Editorでは、NAVERマップを自分だけのスタイルでカスタムできる機能を提供します。Style Editorに移動する方法は以下の通りです。

  1. NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Application Services > Mapsメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. ご利用の申し込みが正常に完了すると、 [Style Editor] ボタンが有効になります。ボタンをクリックすると、Style Editorに移動します。

app_maps_home01_steditor_ko

Maps開発ガイドの確認

Mapsサービスで提供する様々な形の開発リソースに関する情報を提供します。

事業者登録番号: 129-86-31394 通信販売業申告番号:第2009-京畿城南-0510号
代表取締役: キム・ユウォン アドレス: 13561 京畿道 城南市 盆唐区 仏亭路6 グリーンファクトリー, 17~26F お客様センターの代表電話: 1544-5876
© NAVER Cloud Corp. All Rights Reserved.