クライアント ID 移行ガイド

概要

方法は次のとおりです。

  1. 現在のクライアント ID の使用状況を確認する
  2. API キーを準備する
  3. 割り当て設定を確認する
  4. コードを更新する
  5. クライアント ID のトラフィックをモニタリングする
  6. クライアント ID を一時停止する
  7. クライアント ID のセルフサービスによる一時的な再有効化

現在のクライアント ID の使用状況を確認する

移行プロセスを開始する前に、次のものをリストアップします。

  • クライアント ID で使用している Maps Platform サービス。
  • クライアント ID を使用しているアプリケーション、サイト、システム。

Google は、2025 年 5 月にクライアント ID のサポート終了について、影響を受けるお客様に通知メールを送信しました。この情報は通知メールでも確認できます。

Cloud コンソールの Google マップの [指標] ページで、クライアント ID の使用状況の最新ステータスを確認できます。

Maps Platform サービスの一覧:

  1. Cloud コンソールで [指標] ページを開きます。
  2. 次の設定で使用量をフィルタします。
    • 認証情報: 「project_number:<数値識別子>」のみを選択します。
  3. 次のフィルタを設定します。
    • グループ化条件: API

アプリケーション、サイト、システムのヒント:

Cloud コンソールには、アプリケーション、サイト、システムの詳細が表示されません。ただし、クライアント ID トラフィックのソースに関するヒントはいくつかあります。手順は次のとおりです。

  1. Cloud コンソールで [指標] ページを開きます。
  2. プルダウンから Maps Platform サービスを選択します。
  3. 次の設定で使用量をフィルタします。
    • 認証情報: 「project_number:<数値識別子>」のみを選択します。
  4. 次のフィルタを設定します。
    • グループ化: プラットフォーム、ドメイン
  5. トラフィックを確認する必要がある Maps Platform サービスごとに、ステップ 2 から繰り返します。

API キーを準備する

すべてのクライアント ID は Google Cloud プロジェクトに関連付けられています。そのプロジェクトの API キーを使用すると、以前にクライアント ID でアクセスした機能と同じ機能にアクセスできます。割り当ての問題や機能の欠落を回避するために、関連付けられたプロジェクトに移行することをおすすめします。

  1. クライアント ID がリンクされている Cloud プロジェクトを見つけます。
  2. Cloud プロジェクトが有効な請求先アカウントにリンクされていることを確認します。
  3. クライアント ID の移行用に新しい API キーを作成します。
    • Cloud プロジェクトの既存の API キーを再利用できます。
    • 同じ Cloud プロジェクトで複数の API キーを使用できます。たとえば、Maps Platform サービスごとにトラフィックを分離したり、異なるプラットフォーム(ブラウザ、モバイルアプリなど)からのトラフィックを分離したりできます。API キーの管理に関するベスト プラクティスについては、セキュリティ ガイドをご覧ください。

API キーを保護する

不正アクセスからキーを保護するため、API キーを保護してください。

  • API キーのアプリケーション制限(ウェブサイト、IP アドレス、Android アプリ、iOS アプリなど)を設定します。
  • API キーの API 制限を設定します。

詳しくは、Google Maps Platform のセキュリティに関するガイダンスをご覧ください。

Maps JavaScript API、Maps Static API、Street View Static API の場合、クライアント ID の信頼できるリファラーを API キーの制限に移行できます。信頼できるリファラーのリストは、Cloud コンソールで確認できます。

割り当て設定を確認する

Cloud プロジェクトに想定される割り当て設定があることを確認します。この操作が必要になるのは、クライアント ID から Maps JavaScript API のクライアントサイド サービスを呼び出す場合のみです。割り当て設定の確認と調整は、Google マップの割り当てページで行えます。

割り当てレポートの詳細

Maps JavaScript API クライアントサイド サービスの割り当ての増加

Maps JavaScript API で次のサービスを使用している場合、API キーの移行後に割り当ての使用量が増加します。

現在の割り当て構成と現在の使用量を確認し、それに応じて割り当て上限を調整します。

  1. クライアント ID を使用して Maps JavaScript API のクライアントサイド サービスを使用しているかどうかを確認します。
    • Cloud コンソールで [指標] ページを開きます。
    • 次の設定で使用量をフィルタします。
      • グループ条件: API メソッド
      • 認証情報: 「project_number:<数値識別子>」のみを選択します。
    • [Traffic by API Method] グラフに、メソッド名とそのトラフィックのリストが表示されます。

API メソッド

クライアントサイド サービス

割り当てを調整するサービス

google.routes.Directions.Javascript

ルートサービス

Directions API

google.routes.DistanceMatrix.Javascript

距離行列サービス

Distance Matrix API

google.maps.Elevation.Javascript

高度サービス

Elevation API

google.places.Geocoding.Javascript

ジオコーディング サービス

Geocoding API

google.places.*.Javascript(google.places.Geocoding.Javascript を除く)

プレイス ライブラリ

Places API

  • これらの API メソッドを使用しない場合は、クライアント ID のトラフィックがすでにプロジェクトの割り当てを消費しているため、割り当て設定について心配する必要はありません。
  • クライアント ID の割り当て使用量を見積もる
    • 各サービスについて、1 秒ごとと 1 日ごとの粒度の両方を確認します。
    • 1 秒あたりのグラフ: ピーク時のトラフィックに 60 を掛けて、1 分あたりの追加割り当ての必要量を算出します。
    • 1 日あたりのグラフ: ピーク トラフィックは、1 日あたりの追加割り当てのニーズである必要があります。
  • 対応する Maps Platform サービスの割り当てを調整します。
    • ステップ 1 で確認したメソッド名に基づいて、対応するサービスの割り当てを調整します。

コードを更新する

client パラメータを key パラメータに置き換える

送信される GMP API 呼び出しで、認証情報を URL&client={value} から URL&key={value} に更新します。アプリが HTTP を使用して GMP サービスにアクセスしている場合は、HTTPS を使用するように更新してください。

レポートのチャネル パラメータを更新する

API リクエストにチャネル パラメータを指定することで、チャネルごとの使用状況をトラッキングできます。API キーでは、チャネル パラメータに数値のみを使用できます。チャネル パラメータに数値以外の値を含むクライアント ID を使用している場合は、サポートされている数値に更新してください。

詳しくは、Google Maps Platform のレポートをご覧ください。

ウェブサービスの署名パラメータを削除する

次のウェブサービス API では、API キーを使用してアクセスする場合、signature パラメータは必要ありません。API リクエストから signature パラメータのみを削除します。

  • Directions API(従来版)
  • Distance Matrix API(従来版)
  • Geocoding API
  • Elevation API
  • Time Zone API

詳しくは、プレミアム プランの概要をご覧ください。

Imagery API の署名シークレット

Maps Static API とストリートビュー Static API では、引き続き signature パラメータが必要です。テスト目的で署名のないリクエストを少数受け入れますが、本番環境でしきい値に達すると失敗し始めます。署名シークレットを、クライアント ID 用のものから API キー用のものに置き換えます。同じ署名アルゴリズムを使用できますが、別の署名シークレットを使用する必要があります。詳細については、デジタル署名を使用するをご覧ください。

クライアント ID のトラフィックをモニタリングする

デプロイ後、Cloud コンソール ダッシュボードを使用して、トラフィックが正常に移行されたことを確認します。クライアント ID のトラフィックが減少します。これは、認証情報でグループ化すると、ダッシュボードに「project_number:123456」形式で表示されます。

クライアント ID を一時停止する

デベロッパーの皆様には、移行後にクライアント ID を一時停止することを強くおすすめします。これは、意図しないトラフィックから認証情報を保護し、クライアント ID の残りの使用が重要でないこと(テスト、キャッシュ、bot など)を確認し、ビジネスに影響を与えることなくエラーを返すことができるようにするためです。クライアント ID は Cloud コンソールで一時停止できます。詳しくは、プレミアム プランの認証の概要をご覧ください。

クライアント ID のセルフサービスによる一時的な再有効化

Google Maps Platform クライアント ID は 2026 年 5 月に段階的なサポート終了期間に入ったため、サービスの提供は保証されなくなりました。アクセスは、スケジュールされたサービス終了プロセスの一環として定期的に制限されます。通常、サービスは数時間以内に自動的に復元されますが、すぐに復元する必要がある場合は、手動でアクセスを再有効化することもできます。

アクセスを緊急に復元するには、Google Cloud コンソールからセルフサービスで再有効化を行います。

  • Google Maps Platform の [認証情報] ページに移動します。
  • クライアント ID にリンクされている特定の Cloud プロジェクトを見つけます。
  • エントリの右端にある一時停止解除アイコンをクリックして、サービスを復元します。

API キーにすぐに移行できず、一時的に中断を免除したい場合は、次の詳細を Google Maps Platform サポートチームにお問い合わせください。

  • クライアント ID
  • 具体的なユースケース
  • 移行予定日
  • ビジネス インパクト評価

クライアント ID 使用状況レポート - 請求レポートから

プロジェクト指標にアクセスできないユーザー(請求管理者、特に Maps Platform パートナーなど)は、プロジェクト指標の代わりに請求レポートを確認すると便利です。請求レポートには 1 ~ 2 日のレイテンシがありますが、30 日を超える使用量と費用の分析情報を表示できるというメリットがあります。

Google Cloud コンソールでクライアント ID の使用状況をモニタリングする手順は次のとおりです。

  1. Google Cloud コンソールの [お支払い] > [レポート] ページに移動します。
  2. (省略可、パートナーのみに関連)フィルタを適用して、目的のサブ請求先アカウントを選択します。
  3. レポートデータをラベルキー goog-maps-api-key-suffix でグループ化します。このラベルには、API キーの末尾の文字が表示されます。
  4. クライアント ID リクエストでは goog-maps-api-key-suffix ラベルが入力されないため、このラベルがないか空のエントリを探して、クライアント ID トラフィックを特定します。
  5. API リクエストに関連付けられていない SKU(サブスクリプション SKU など)は無視します。

トラブルシューティング

リクエストが失敗しているかどうかを確認するにはどうすればよいですか?

エラーの統計情報は、レスポンス コードのグラフで確認できます。

ApiNotActivatedMapError、または REQUEST_DENIED エラー

Cloud プロジェクトでサービスを有効にしていない場合、ApiNotActivatedMapError または REQUEST_DENIED エラーが表示されます。手順に沿ってサービスを有効にします。

エラー RefererNotAllowedMapError 件

ソースドメインが API キーに追加されていない場合、RefererNotAllowedMapError エラーが表示されます。[API キーを保護する] セクションを確認し、API キーにドメインを追加します。

OverQuotaMapError、または OVER_QUERY_LIMIT エラー

構成した割り当てがトラフィックをカバーするのに十分でない場合は、OverQuotaMapError または OVER_QUERY_LIMIT が表示されます。[割り当て設定を確認する] セクションを確認し、それに応じて割り当てを調整します。

「この API へのリクエストは SSL 経由で行う必要があります」というエラー

次のエラー メッセージが表示された場合は、API リクエストを「http://」から「https://」に更新します。

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}