疑難排解

以下提供一些提示,協助排解常見問題。

為什麼精確度半徑很大?

如果「Geolocation」回應的準確度欄位顯示非常高的值,服務可能正在根據要求 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。如要瞭解各個欄位的詳細資訊,請參閱「要求主體」一節。