Elevation API で API キーを使用する

Google Maps Platform サービスでは、適切な認証情報を提供している API 呼び出し以外を制限することで、不正使用を防止しています。これらの認証情報は API キーの形式になります。API キーとは、Google の請求先アカウントをプロジェクトや特定の API、SDK に関連付ける一意の英数字文字列です。

このガイドでは、Google Maps Platform 用の API キーを作成、制限、使用する方法を説明します。

始める前に

Elevation API の使用を開始するには、請求先アカウントと Elevation API が有効になっています。詳しくは、Cloud コンソールでのセットアップをご覧ください。

API キーの作成

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

API キーを作成するには:

コンソール

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

    [認証情報] ページに移動

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

Cloud SDK

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

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

API キーの制限

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

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

コンソール

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

    [認証情報] ページに移動

  2. 制限を設定する API キーを選択します。選択した API キーのプロパティ ページが表示されます。
  3. [キーの制限] で、次の制限を設定します。
    • アプリケーションの制限:
      1. 指定したウェブサーバー IP アドレスのリストからのリクエストを受け入れるには、 IP アドレス(ウェブサーバー、cron ジョブなど)のリスト アプリケーションの制限。IPv4 または IPv6 アドレスを 1 つ以上指定します。 CIDR 表記を使ってサブネットを指定します。その際、IP アドレスは、送信元 IP アドレス Google Maps Platform サーバーが監視します。以下をご使用の場合: ネットワーク アドレス変換(NAT)、 これは通常、マシンのパブリック IP アドレスに対応します。
    • API の制限:
      1. [キーを制限] をクリックします。
      2. [API を選択] プルダウンから [Elevation API] を選択します。 Elevation API がリストにない場合は、次の手順を実施する必要があります。 有効にします。
  4. 変更が完了したら、[保存] をクリックします。

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="elevation-backend.googleapis.com"
    --allowed-ips="IP_ADDRESS"

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

リクエストに API キーを追加する

すべての Elevation API リクエストに API キーを含める必要があります。以下の例では、 YOUR_API_KEY は実際の API キーに置き換えます。

https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536,-104.9847034&key=YOUR_API_KEY

API キーを使用するリクエストには HTTPS が必要です。