Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

エラー処理

欧州経済領域（EEA）のデベロッパー

リクエストを送信すると、エラーの詳細を含むレスポンスが返されることがあります。

2D タイルとストリートビューの画像

2D タイルとストリートビューの画像を使用する際に発生する可能性のあるエラーについて、以下に詳しく説明します。

エラーリスト

Map Tiles API の使用時に発生する可能性のあるエラーについて、以下に詳しく説明します。

required

リクエストに URL パラメータがありません。エラーメッセージには、どのパラメータがないかが示されます。

notFound、invalid

x、y、z の値が範囲外です。

通常の地図タイルの場合、最大ズームレベルは、特定の地図タイルとリクエストした地図オプションによって異なります。
通常の地図タイルの場合、x 座標は [0, (2^zoom)-1] の範囲内である必要があります。
通常の地図タイルの場合、y 座標は [0, (2^(zoom-1))-1] の範囲内である必要があります。
Street View タイルの場合、ズームは 0 ～ 5 の範囲で指定する必要があります。
Street View タイルの場合、x 座標と y 座標の範囲は、レベル 5 のズームまでは通常の地図タイルと同じです。その時点での最大値は、imageHeight または imagewidth を tileHeight または tileWidth で割った値になります。

forbidden:

考えられる原因:

リクエストに有効な API キーがない。
メッセージ: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

2D 衛星タイルは、欧州経済領域（EEA）の住所の請求先アカウントにリンクされているプロジェクトでは使用できません。詳しくは、EEA のお客様向けの Map Tiles API の調整をご覧ください。

expired

session トークンの有効期限が切れています。セッショントークンは、作成時から 2 週間有効です。なお、これは予告なく変更される場合があります。このエラーが表示された場合は、セッショントークンの使用の説明に従って、新しいセッショントークンを取得する必要があります。

badRequest

リクエストの形式が正しくありません。一般的な原因は次のとおりです。

roadmap レイヤを含めずに terrain 地図タイプを指定した。
ロードマップ以外の地図タイプに styles 配列を含めた。
ストリートビューメタデータリクエストで、緯度/経度の値とパノラマ ID を送信した。

quotaExceeded、rateLimitExceeded

アプリケーションが許容される割り当てを超えたか、許容される秒間クエリ数を超えました。

エラーの例

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

リクエストの再試行

quotaExceeded と rateLimitExceeded でリクエストが失敗した場合は、破損したリクエストや大規模な障害によって Google サーバーが過負荷にならないように、リクエストを再試行する必要があります。これは、多くのクライアントがリクエストを連続して再試行しようとするためです。つまり、リクエストを再試行する際は、指数バックオフを使用します。指数バックオフを使用すると、リクエストを時間的に分散させ、サーバーが復旧する時間を確保できます。

たとえば、リクエストが失敗した場合は、1 秒後に再試行します。それでも失敗した場合は、2 秒後にリクエストを再試行します。そのリクエストも失敗した場合は、4 秒後に再試行します。このように、連続するリクエストの間隔を 2 倍にするだけで、リクエストを効果的に分散させることができます。

3D タイル

フォトリアリスティックタイルにはレンダラを介してアクセスするため、Google サーバーからのエラーはわかりにくい場合があります。レンダラはサーバーエラーの処理を担当します。

タイルレンダラのエラー

たとえば、CesiumJS レンダラでは、サーバーエラーが発生しても通常は何も表示されません。これにより、クラッシュ、空白の画面、特定のタイルの読み込み失敗などが発生する可能性があります。

サーバーエラーをデバッグする手法は、使用する特定のレンダラによって異なります。CesiumJS などのブラウザベースのレンダラの場合は、ほとんどのブラウザに組み込まれているツールを使用してネットワークトラフィックを検査できます。たとえば、Chrome DevTools を使用できます。

一般的なエラー

発生する可能性のある最も一般的なエラーの詳細を以下に示します。

400: 引数が無効です: API キー、クエリパラメータ、タイル/タイルセット ID が無効であるか、セッショントークンの有効期限が切れています。
400: Invalid Value: createSessionToken リクエストで使用された mapType が、後続のタイルエンドポイントで使用される mapType と一致していることを確認してください。たとえば、streetview セッショントークンを使用して roadmap タイルをリクエストすることはできません。

403: アクセスが拒否されました