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

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

無効なリクエスト

無効なリクエストの場合、ストリートビュー 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 に署名します。