このページでは、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 Console にアクセスし、有効なお支払い方法が入力されていることを確認してください。
- ご自身で設定した 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 コンソールを使用して、次のようにコンソール出力を確認できます。
- メニュー アイコンを開くには、メニュー アイコン > [More tools] > [Developer Tools] を選択します。
- JavaScript コンソールを開くには、デベロッパー ツール ウィンドウの上部にある [コンソール] タブをクリックします。ESC キーを使用して JavaScript コンソールを切り替えることもできます。