ストリートビュー Static API のエラー メッセージ

リクエストが失敗すると、ストリートビュー Static API はエラーまたは警告を返します。このガイドでは、エラー メッセージとその解決方法について説明します。

無効なリクエスト

リクエストが無効な場合、Street View Static API は HTTP 4xx ステータス コードと、問題の内容を説明するメッセージを返します。次の表に、このようなエラー条件の例を示します。ただし、これは発生する可能性のあるエラーの完全なリストではありません。特定の問題の詳細については、API から返された実際のエラーコードとメッセージを確認してください。

エラー発生条件の例 ステータス コード
リクエストに無効なパラメータが含まれているか、必須パラメータが指定されていません。たとえば、size パラメータが想定される数値の範囲内にないか、リクエストに存在しません。 400 BAD REQUEST
リクエストに含まれている API キーが無効です。 403 FORBIDDEN

ストリートビュー画像が表示されないエラー

リクエストが有効であっても、別のエラーが発生してストリートビュー画像が表示されない場合、Street View Static API は、エラーに応じて、ストリートビュー画像の代わりにテキストまたはエラー画像を返します。このようなエラー条件の例としては、アプリケーションが使用量上限を超えた場合が挙げられます。

ストリートビューの画像の代わりにエラー画像が表示される
図: ストリートビュー画像の代わりに表示されるエラー画像

API キーなしで Street View Static API を使用する場合、またはアカウントで課金が有効になっていない場合、ページにはストリートビュー画像の代わりにエラー画像が表示され、エラーの種類を示すリンクが表示されます。例: 「g.co/streetviewerror/key」

キーレス エラーと解決策
使用量上限のエラー: 1 日あたりの地図読み込み回数の上限を超えました API キーなしでストリートビュー Static API を使用しています。このエラーを解決するには、次の操作を行います。
  1. API キーを取得する
  2. 課金を有効にする
  3. URL に署名する
使用量上限のエラー: リクエスト URL にデジタル署名がありません リクエストに必要なデジタル署名がありません。このエラーを解決するには、 URL に署名します。