概要
方法は次のとおりです。
- 現在のクライアント ID の使用状況を確認する
- API キーを準備する
- 割り当て設定を確認する
- コードを更新する
- クライアント ID のトラフィックをモニタリングする
- クライアント ID を一時停止する
- クライアント ID のセルフサービスによる一時的な再有効化
現在のクライアント ID の使用状況を確認する
移行プロセスを開始する前に、次の項目をリストします。
- クライアント ID で使用している Maps Platform サービス。
- クライアント ID を使用しているアプリケーション、サイト、システム。
Google は、2025 年 5 月のクライアント ID の非推奨化について、影響を受けるお客様に通知メールを送信しました。この情報は、通知メールにも記載されています。
Cloud コンソールで、Google Maps の [指標] ページでクライアント ID の使用状況の最新のステータスを確認できます。
Maps Platform サービスの一覧:
- Cloud Console で [指標] ページを開きます。
- 次の設定で使用状況をフィルタします。
- 認証情報: 「project_number:<数値識別子>」のみを選択します。
- 次のフィルタを設定します。
- グループ条件: API
アプリケーション、サイト、システムのヒントの場合:
Cloud Console にアプリケーション、サイト、システムの詳細は表示されません。ただし、クライアント ID トラフィックのソースのヒントは確認できます。手順は次のとおりです。
- Cloud Console で [指標] ページを開きます。
- プルダウンから Maps Platform サービスを選択します。
- 次の設定で使用状況をフィルタします。
- 認証情報: 「project_number:<数値識別子>」のみを選択します。
- 次のフィルタを設定します。
- グループ化条件: プラットフォーム、またはドメイン
- トラフィックを確認する必要がある Maps Platform サービスごとに、手順 2 から繰り返します。
API キーを準備する
すべてのクライアント ID は Google Cloud プロジェクトに関連付けられています。そのプロジェクトの API キーを使用すると、以前にクライアント ID でアクセスしたのと同じ機能にアクセスできます。割り当ての問題や機能の欠落を避けるため、関連付けられたプロジェクトに移行することをおすすめします。
- クライアント ID がリンクされている Cloud プロジェクトを見つけます。
- Cloud プロジェクトが有効な請求先アカウントにリンクされていることを確認します。
- クライアント 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、ストリートビュー Static API の場合、クライアント ID の信頼できるリファラーを API キーの制限に移行できます。信頼できるリファラーのリストは、Cloud コンソールで確認できます。
割り当て設定を確認する
Cloud プロジェクトに想定どおりの割り当て設定がされていることを確認します。これは、クライアント ID から Maps JavaScript API のクライアントサイド サービスを呼び出す場合にのみ必要です。割り当て設定は、Google Maps の割り当てページで確認して調整できます。
Maps JavaScript API クライアントサイド サービスの割り当ての増加
Maps JavaScript API で次のサービスを使用している場合、API キーの移行後に割り当ての使用量が増加します。
現在の割り当て構成と現在の使用量を確認し、割り当て上限を適宜調整します。
- クライアント ID を使用して Maps JavaScript API クライアントサイド サービスを使用しているかどうかを確認します。
- Cloud Console で [指標] ページを開きます。
- 次の設定で使用状況をフィルタします。
- グループ条件: API メソッド
- 認証情報: 「project_number:<数値識別子>」のみを選択します。
- [API メソッド別のトラフィック] グラフに、メソッド名とそのトラフィックのリストが表示されます。
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.Geocoding.Javascript 以外の google.places.*.Javascript |
プレイス ライブラリ |
Places API |
- これらの API メソッドを使用しない場合は、クライアント ID のトラフィックがすでにプロジェクトの割り当てを消費しているため、割り当て設定について心配する必要はありません。
- クライアント ID の割り当て使用量を見積もる
- 各サービスについて、1 秒あたりの粒度と 1 日あたりの粒度の両方を確認します。
- [Per Second] グラフ: ピーク時のトラフィックに 60 を掛けて、1 分あたりの追加の割り当てを計算します。
- 1 日あたりのグラフ: トラフィックのピークは、1 日あたりの追加の割り当てのニーズである必要があります。
- 対応する Maps Platform サービスの割り当てを調整します。
- 手順 1 で確認したメソッド名に基づいて、対応するサービスの割り当てを調整します。
コードを更新する
クライアント パラメータをキー パラメータに置き換える
送信 GMP API 呼び出しで認証情報を URL&client={value} から URL&key={value} に更新します。アプリが HTTP を使用して GMP サービスにアクセスしている場合は、HTTPS を使用するように更新します。
レポート用のチャネル パラメータを更新する
API リクエストにチャネル パラメータを指定することで、チャネルごとの使用状況を追跡できます。API キーは、チャネル パラメータの数値のみをサポートします。クライアント ID を使用していて、チャネル パラメータに数値以外の値を指定している場合は、サポートされている数値に更新してください。
詳しくは、Google Maps Platform のレポートをご覧ください。
ウェブサービスの署名パラメータを削除
次のウェブサービス API では、API キーを使用してアクセスする場合、署名パラメータは必要ありません。API リクエストから署名パラメータのみを削除します。
- Directions API（以前のバージョン）
- Distance Matrix API（以前のバージョン）
- Geocoding API
- Elevation API
- Time Zone API
詳しくは、プレミアム プランの概要をご覧ください。
画像 API の署名シークレット
Maps Static API とストリートビュー Static API では、引き続き署名パラメータが必要です。テスト目的で署名なしのリクエストを少数受け付けますが、本番環境でしきい値に達すると失敗し始めます。署名シークレットをクライアント ID のものから API キーのものに置き換えます。同じ署名アルゴリズムを使用できますが、別の署名シークレットを使用する必要があります。詳細については、デジタル署名を使用するをご覧ください。
クライアント ID のトラフィックをモニタリングする
デプロイ後、Cloud Console ダッシュボードを使用して、トラフィックが正常に移行されたことを確認します。ダッシュボードで認証情報別にグループ化すると、「project_number:123456」形式でクライアント ID トラフィックの減少が確認できます。
クライアント ID を一時停止する
移行後にクライアント ID を一時停止することを強くおすすめします。これは、認証情報を意図しないトラフィックから保護し、クライアント ID の残りの使用量が重要ではない（テスト、キャッシュ、ボットなど）ことを確認し、ビジネスに影響を与えることなくエラーを返すことができるようにするためです。Cloud コンソールでクライアント ID を一時停止できます。詳しくは、プレミアム プランの認証の概要をご覧ください。
クライアント 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 の使用状況をモニタリングできます。
- Google Cloud コンソールで [請求] > [レポート] ページに移動します。
- （省略可、パートナーのみに関連）フィルタを適用して、目的のサブ請求先アカウントを選択します。
- レポートデータをラベルキー
goog-maps-api-key-suffixでグループ化します。このラベルには、API キーの末尾の文字が表示されます。 - クライアント ID リクエストでは
goog-maps-api-key-suffixラベルが入力されないため、このラベルがないか空のエントリを探して、クライアント ID トラフィックを特定します。 - 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"
}