このページでは、Maps Embed API から返されるエラー メッセージについて説明します。エラーが発生すると、Maps Embed API は地図の代わりにエラー メッセージ テキストを表示します。また、特定のエラー条件が発生し、透かしが入った地図が暗く表示される場合があります。
無効なリクエスト
リクエストが無効な場合、Maps Embed API は HTTP 4xx ステータス コードと、問題を説明するメッセージを返します。このようなエラー状態の例を次に示します。注: このリストはすべてのエラーを網羅しているわけではありません。問題の詳細については、API から返される実際のエラーコードとメッセージを確認してください。
| エラー発生条件の例 | ステータス コード |
|---|---|
リクエストに無効なパラメータが含まれているか、必須パラメータがありません。たとえば、zoom パラメータが想定された数値の範囲外です。または、リクエストに必須パラメータがありません。 |
400 BAD REQUEST |
| リクエストに含まれている API キーが無効です。 | 403 FORBIDDEN |
API キーと QPS エラー
API キーと QPS エラーは、無効なリクエストとして扱われます。考えられる原因は次のとおりです。
- API キーがないか、無効です。このエラーを解決するには、リクエストに有効な API キーが含まれていることを確認します。 API キーを取得します。
- Maps Embed API がプロジェクトで有効になっていません。API の有効化と無効化について学習する。
- API キーに制限違反があります。API キーに関するベスト プラクティスの詳細をご覧ください。
請求と HTTP リファラーのエラー
次のいずれかに該当する場合、「開発専用」という透かしの入った、暗い地図またはネガティブのストリートビュー画像が返されます。
- お客様のアカウントで課金が有効になっていません。課金を有効にする。
- 指定した請求方法が無効です（クレジット カードの期限切れなど）。この問題を解決するには、Google Cloud コンソールにアクセスし、有効なお支払い方法が指定されていることを確認してください。
- ご自身で設定した 1 日の利用時間の上限を超えています。 1 日の課金対象の上限を表示または変更する方法をご確認ください。
- リクエストに HTTP リファラーが含まれておらず、リファラーに制限のある API キーが使用されています。リファラーの追加に関する詳細
ブラウザでエラーを確認する
課金エラーと HTTP リファラー エラーの場合、Maps Embed API はエラー メッセージを window.console に書き込みます。無効なリクエスト（API キーや QPS エラーを含む）の場合、HTTP 4xx ステータス コードのみがコンソールに報告されます。このセクションでは、Google Chrome のコンソール出力を確認する方法について説明します。その他のブラウザを使用している場合は、そのブラウザのデベロッパー向けドキュメントをご覧ください。ご参考までに、他のブラウザでコンソール出力を確認するためのツールのリストを次に示します。
- Internet Explorer 向けの Console
- Firefox 向けの Web Console
- Android 向けの Remote debugging
- iOS 向けの Web Inspector
Chrome では、次のように JavaScript コンソールを使用してコンソールの出力を確認できます。
- デベロッパー ツールを開くには、メニュー アイコン > [その他のツール] > [デベロッパー ツール] を選択します。
- JavaScript コンソールを開くには、デベロッパー ツール ウィンドウの上部にある [Console]（コンソール）タブをクリックします。Esc キーを使用して JavaScript コンソールを切り替えることもできます。