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