以下提供一些常見問題的疑難排解提示。
為什麼精確度半徑會非常大?
如果地理位置回應的精確度欄位顯示非常高的值,服務可能會根據請求 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 從裝置收集資訊:
Android 裝置:請參閱 Places SDK for Android 和 Android Location API。
iOS 裝置:請參閱「Places SDK for iOS」一文。
錯誤說明
以下是您可能會遇到的錯誤和說明。
原因 | 網域 | 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。如要進一步瞭解各欄位的詳細資訊,請參閱「要求主體」一節。 |