提出要求後，您可能會收到含有錯誤的回應 詳細資料。
2D 圖塊和街景服務圖像
下方清單詳細列出使用 2D 時可能會遇到的錯誤 圖塊和街景服務圖像。
產品資訊時發生錯誤
下表詳細說明瞭使用 Map Tiles API。
required- 你的要求缺少網址參數。請注意，錯誤訊息指出 缺少哪個參數。
notFound、invalid你的
x、y或z的值超出範圍。在一般地圖圖塊中，最高縮放等級取決於特定設定的 地圖方塊及您要求的地圖選項中。
如果是一般地圖圖塊，x 座標必須在範圍之內 [0, (2^zoom)-1]。
如果是一般地圖圖塊，y 座標必須在範圍內 [0, (2^(zoom-1))-1]。
對於「街景服務」圖塊，縮放等級必須介於 0 到 5 之間。
如果是「街景服務」圖塊，x 和 y 座標範圍會與 ，直到縮放等級為 5 為止。在這個階段，最大值 值為
imageHeight或imagewidth除以tileHeighttileWidth。
forbidden:
要求缺少有效的 API 金鑰。
expired- 您的「
session」權杖已過期。工作階段符記的有效期間 自建立時間起兩週請注意，這可能會改變 恕不另行通知。如果收到這個錯誤，表示必須取得新工作階段 符記 使用工作階段符記。 badRequest您的要求格式錯誤，常見原因包括：
您指定
terrain地圖類型，但不含roadmap圖層。您已加入非道路地圖地圖類型的
styles陣列。您已在街景服務中繼資料內傳送一個 lat/lng 值和全景 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 失敗，您應
再次嘗試執行要求時，例如要求無效或大規模失敗
確保 Goodle 伺服器安全無虞，許多用戶端會嘗試快速地
。也就是說
指數輪詢
當您再次提出要求時指數輪詢會迫使您散佈
讓伺服器有時間復原。
舉例來說，如果要求失敗，一秒後重試。但如果這樣 也可能在 2 秒後重試要求。如果這樣 也失敗了，並在四秒後重試。因此有效地 將每次要求之間的時間長度加倍。
3D 圖塊
您不容易察覺 Google 伺服器產生的錯誤，因為您 透過轉譯器處理逼真的圖塊 伺服器錯誤。
圖塊轉譯器錯誤
例如，當伺服器發生錯誤時，CesiumJS 轉譯器通常會自動失敗 包括當機、畫面空白或 無法載入圖塊。
用來偵錯伺服器錯誤的技術必須根據具體情況 提供的轉譯器如果是以瀏覽器為基礎的轉譯器 (例如 CesiumJS)，您可以檢查 大部分瀏覽器內建的工具都含有網路流量。舉例來說： 使用 Chrome 開發人員工具。
常見錯誤
下方清單詳細列出常見錯誤，方便您瞭解 可能會碰到問題
- 400：引數無效
- API 金鑰無效、查詢參數、資訊方塊/圖塊 ID，或工作階段已過期 符記
- 403：權限遭拒
- 缺少 API 金鑰、SSL 連線遺失，或是您的 API 金鑰未新增至 3D 圖塊的許可清單與 Google 聯絡 使用您的專案 ID新增支援 加入 Map Tiles API 3D 圖塊功能的許可清單。
- 429：要求數量過多
- 配額已用盡，聯絡 Google 支援團隊，要求提高配額。