Street View Static API のエラー メッセージ

問題が発生すると、Street View 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 キーなしで Street View Static API を使用しています。この問題を解決するには、次の操作を行います。
  1. API キーを取得
  2. 課金を有効にする
  3. URL に署名する
使用制限のエラー: リクエスト URL にデジタル署名がありません リクエストにデジタル署名がありません(必須)。この問題を解決するには、 URL に署名するをご覧ください。