疑難排解

以下提供一些常見問題的疑難排解訣竅。

為什麼精確度半徑會非常大？

如果地理位置回應的精確度欄位顯示非常高的值，服務可能會根據請求 IP 進行地理定位，而不是 Wi-Fi 熱點或行動通信基地台。如果服務無法辨識任何基地台或存取點，就會產生這類回應。

如要確認服務無法為存取點進行地理定位，請在要求中將 considerIp 設為 false。如果回應是 404，表示您已確認 wifiAccessPoints 和 cellTowers 物件無法進行地理定位。

如何排解回應錯誤？

如果要求產生錯誤，系統會傳回標準格式的錯誤回應主體，並將 HTTP 狀態碼設為錯誤狀態。

錯誤回應包含一個物件，其中包含單一錯誤物件，其中包含下列鍵：

  • code：與回應的 HTTP 狀態相同。
  • message：錯誤的簡短說明。
  • errors：發生的錯誤清單。每個錯誤都包含錯誤類型 (原因) 的 ID 和簡短說明 (訊息)。

舉例來說，傳送無效的 JSON 會傳回以下錯誤：

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "parseError",
    "message": "Parse Error",
   }
  ],
  "code": 400,
  "message": "Parse Error"
 }
}

從裝置收集測試資訊

如要進行額外測試，您可以使用下列 SDK 和 API 從裝置收集資訊：

錯誤說明

以下是您可能會遇到的錯誤，並附上說明。

原因 網域 HTTP 狀態碼 說明
dailyLimitExceeded usageLimits 403 你已超過每日上限。
keyInvalid usageLimits 400 您的 API 金鑰不適用於 Geolocation API。請確認您已加入完整金鑰，且已購買 API，或是已啟用帳單並啟用 API，以便免費取得配額。
userRateLimitExceeded usageLimits 403 您已超出在 Google Cloud 控制台中設定的要求限制。這項限制通常會設為每日要求次數、每 100 秒要求次數，以及每位使用者每 100 秒要求次數。您應設定限制，避免單一或少數使用者耗盡每日配額，同時讓所有使用者都能合理存取。如要設定這些限制，請參閱「限制 API 用量」一文。
notFound geolocation 404 要求有效，但未傳回任何結果。
parseError global 400 要求主體不是有效的 JSON。如要進一步瞭解各欄位的詳細資訊，請參閱「要求主體」一節。