Google Maps Platform スタートガイド

このページでは、Google Maps Platform の API と SDK を使用する際の基本的な手順について説明します。

クイックスタート

Google Cloud コンソールを使用して請求先アカウントまたはプロジェクトを作成したことがない場合は、[使ってみる] ボタンをクリックし、Cloud コンソールで新規ユーザー向けのインタラクティブな設定方法をご確認ください。

使ってみる

または、以下の手順に沿って設定してください。

ステップ 1: プロジェクトを設定する

Console

  1. Google Cloud コンソールの [プロジェクトの選択] ページで [新しいプロジェクト] をクリックし、新しい Cloud プロジェクトの作成を開始します。

    [プロジェクトの選択] ページに移動

  2. Cloud プロジェクトで お支払いが有効になっていることを確認します。

    Google Cloud では、無料トライアルを提供しています。トライアルは、90 日が経過するか、アカウントの費用が 300 ドルに達した時点のいずれか早い方の時点で終了します。解約はいつでも可能です。詳しくは、請求先アカウントのクレジットおよび Google Maps Platform の料金をご覧ください。

Cloud SDK

gcloud projects create "PROJECT"

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

ステップ 2: API または SDK を有効にする

Google Maps Platform を使用するには、プロジェクトで使用する API または SDK を有効にする必要があります。

一部の統合では、複数の API または SDK を有効にする必要があります。有効にする API や SDK がわからない場合は、Capabilities Explorer を使用するか、該当する API/SDK のドキュメントをご覧ください。

1 つ以上の API または SDK を有効にするには:

Console

  1. Cloud コンソールの Maps API ライブラリ ページにアクセスし、有効にできる Google Maps Platform の API と SDK をご確認ください。

    Maps API ライブラリ ページに移動

  2. 有効にする API または SDK をクリックします。
    • [有効にする] ボタンが表示された場合は、このボタンをクリックして、選択した API または SDK を有効にします。
    • [管理] ボタンが表示された場合、その API または SDK はすでに有効になっています。何もする必要がありません。
    • いずれかのボタンをクリックすると、選択した API または SDK のダッシュボードが表示されます(このプロジェクトから API または SDK を削除するには、[無効にする] ボタンをクリックします)。

Cloud SDK

次のコマンドを実行すると、Maps、Routes、Places のすべての API が有効になります。

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

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

次のコマンドを使用して、Environment API を有効にします。

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

ステップ 3: API キーを取得する

このステップでは API キーを作成します。本番環境で API キーを使用する場合は、キーの使用を制限することを強くおすすめします。詳しくは、各サービスの API キーの使用ページをご覧ください。

API キーは、使用量と課金のためにプロジェクトに関連付けられたリクエストを認証する固有識別子です。少なくとも 1 つの API キーをプロジェクトに関連付ける必要があります。 新しいキーを作成する場合、または既存のキーに API や SDK を追加する場合は、次の手順に沿って操作します。

Console

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

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

  2. プロンプトが表示されたら、プロジェクトを選択します。
  3. 次のいずれかを行います。

    • 新しい鍵を作成する:

      1. [認証情報を作成] > [API キー] をクリックします。
      2. [API キーの作成] パネルで、[API の制限の選択] リストを開きます。
      3. このキーに不要な API をすべてクリアし、使用する予定の API が選択されたままであることを確認します。
      4. [作成] をクリックします。パネルに新しい API キーが表示されます。
    • 既存の鍵を使用する:

      1. 鍵の名前をクリックします。
      2. [API の制限を選択] リストで、使用する API を選択します。
      3. [保存] をクリックします。

    ここで API を選択しても、API は有効になりません。選択した各 API が API ライブラリで有効になっていることを確認します。

  4. 後で鍵文字列を表示するには、[鍵と認証情報] ページに移動し、鍵の [鍵を表示] をクリックします。

コンソールの表示がこれらの手順と異なる場合は、Google Cloud ドキュメントの API キーを作成すると API 制限を追加するをご覧ください。

Cloud SDK

次のコマンドで、PROJECT_ID をプロジェクト ID に置き換えます。

  • 新しい鍵を作成する: 次のコマンドを実行します。DISPLAY_NAME は鍵の名前に置き換えます。SERVICE_NAME は、使用する予定の API のサービス名(places.googleapis.com など)に置き換えます。さらに API を許可するには、--api-target フラグを繰り返します。

    gcloud services api-keys create \
        --project="PROJECT_ID" \
        --display-name="DISPLAY_NAME" \
        --api-target=service=SERVICE_NAME

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

  • 既存の鍵を使用する: 次のコマンドを実行します。KEY_ID は鍵の ID に置き換えます。SERVICE_NAME は、追加する API のサービス名に置き換えます。--append フラグは、キーですでに許可されている API を保持します。このフラグを指定しない場合、コマンドはそれらを置き換えます。

    gcloud services api-keys update KEY_ID \
        --project="PROJECT_ID" \
        --append \
        --api-target=service=SERVICE_NAME

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

    鍵 ID は、鍵文字列や表示名ではありません。これを確認するには、gcloud services api-keys list --project="PROJECT_ID" を実行します。ID は name フィールドの最後の部分(projects/PROJECT_NUMBER/locations/global/keys/KEY_ID)です。

鍵文字列を表示するには、gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" を実行します。

請求先アカウントのクレジット

  • Google Cloud、Google Maps Platform、Firebase の有料ユーザーになったことがなく、Google Cloud 無料トライアルに申し込んだことがない場合は、無料トライアルと $300 分のウェルカム クレジットを取得できます。このクレジットは Google Maps Platform サービスで使用できます。
  • Google Maps Platform の各 SKU には、毎月一定量の無料枠が用意されています。無料枠の詳細は、料金表と Google Maps Platform の課金をご覧ください。
  • Google は、非営利団体、スタートアップ、クライシス レスポンス、ニュース メディア、教育機関、交通機関などの公共プログラムにもクレジットを提供しています。

次のステップ

設定が完了すると、Google Maps Platform の API と SDK を使用できるようになります。詳しくは、該当する API または SDK の概要、デベロッパー ガイド、スタートガイドをご覧ください。API と SDK の一覧は、Google Maps Platform ドキュメント(サービス別)および Google Maps Platform API(プラットフォーム別)をご覧ください。