Navigation SDK は現在、一部のお客様のみご利用いただけます。詳しくは、営業担当者にお問い合わせください。

まもなく Google Maps Platform に新しい地図のスタイル機能が加わります。この地図スタイルの更新では、新しいデフォルトのカラーパレットが追加され、地図のエクスペリエンスとユーザビリティが改善されています。2025 年 3 月に、すべての地図のスタイルが自動的に更新されます。利用可能な地域と、早期にオプトインする方法について詳しくは、Google Maps Platform の新しい地図のスタイルをご覧ください。

このページは Cloud Translation API によって翻訳されました。

API キーを使用する

API キーの作成

API キーは、使用量を正確に集計して課金するため、プロジェクトに関連付けられたリクエストであることを認証する一意の識別子です。少なくとも 1 つの API キーをプロジェクトに関連付ける必要があります。

API キーを作成するには:

コンソール

[Google Maps Platform] > [認証情報] ページに移動します。

[認証情報] ページに移動
[認証情報] ページで、[認証情報を作成] > [API キー] をクリックします。
[API キーを作成しました] ダイアログで、新しく作成された API キーが表示されます。
[閉じる] をクリックします。
新しい API キーは、[認証情報] ページの [API キー] に一覧で表示されます。
（本番環境で使用する前に必ず API キーを制限するようにしてください）

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

詳しくは、Google Cloud SDK、Cloud SDK のインストール、および以下のコマンドをご覧ください。

gcloud alpha services api-keys create

API キーの制限

API キーの使用は、アプリケーションに必要な API だけに制限して、使用することを強くおすすめします。API キーを制限すると、不正なリクエストからアプリケーションを保護して、アプリケーションのセキュリティを強化できます。詳しくは、API セキュリティに関するベストプラクティスをご覧ください。

API キーを制限する場合は、アプリケーションの署名に使用された署名鍵の SHA-1 証明書フィンガープリントを指定する必要があります。証明書には次の 2 種類があります。

デバッグ用証明書: この証明書タイプは、テスト中のアプリやその他の非本番環境コードでのみ使用します。デバッグ用証明書で署名されたアプリは公開しないでください。この証明書は、デバッグビルドの実行時に Android SDK Tools によって自動的に生成されます。
リリース用証明書: アプリをアプリストアにリリースする準備ができたら、この証明書を使用します。この証明書は、リリースビルドの実行時に Android SDK Tools によって生成されます。

Android アプリの署名と証明書について詳しくは、アプリへの署名に関するガイドをご覧ください。

署名証明書フィンガープリントを確認する方法は、以下の参考資料からご確認ください。

Play アプリ署名を使用している場合は、API プロバイダと連携するをご覧ください。
独自の署名鍵を管理している場合は、アプリで自己署名を行うを確認するか、ビルド環境の説明書をご参照ください。

API キーを制限する手順は次のとおりです。

コンソール

[Google Maps Platform] > [認証情報] ページに移動します。

[認証情報] ページに移動
制限を設定する API キーを選択します。API キーのプロパティページが表示されます。
[キーの制限] で、次の制限を設定します。

アプリケーションの制限:

[Android アプリ] を選択します。
[+ パッケージ名とフィンガープリントを追加] をクリックします。
パッケージ名と SHA-1 証明書フィンガープリントを入力します。次に例を示します。
```
com.example.android.mapexample
```
```
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
```

API の制限:

[キーを制限] をクリックします。
[Select APIs] プルダウンから [Navigation SDK] を選択します。Navigation SDK がリストに表示されない場合は、この SDK をenable必要があります。

変更が完了したら、[保存] をクリックします。

Cloud SDK

既存のキーを一覧表示します。

gcloud services api-keys list --project="PROJECT"

既存のキーに対する既存の制限を削除します。

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

既存のキーに新しい制限を設定します。

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="maps-android-backend.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

詳しくは、Google Cloud SDK、Cloud SDK のインストール、および以下のコマンドをご覧ください。

次のステップ

API キーを取得したら、Android Studio プロジェクトをセットアップするの説明に沿って、Android Studio プロジェクトを作成および設定できます。

Android Studio プロジェクトをセットアップする