以下是一些关于排查常见问题的提示。
为什么精确度半径非常大?
如果您的地理定位响应在精确度字段中显示非常高的值,则该服务可能根据请求 IP 进行地理定位,而不是 Wi-Fi 点或手机基站。如果服务无法识别任何手机基站或接入点,则可能会发生这些类型的响应。
如需确认该服务无法对您的接入点进行地理定位,请在请求中将 considerIp
设置为 false。如果响应为 404,则表示您已确认无法对 wifiAccessPoints 和 cellTowers 对象进行地理定位。
如何排查响应错误?
如果您的请求生成错误,系统会返回标准格式的错误响应正文,并将 HTTP 状态代码设置为错误状态。
错误响应包含的对象中有一个错误对象,其中包括下列键:
code
:这与响应的 HTTP 状态相同。message
:错误的简短说明。errors
:发生的错误列表。每个错误都包含错误类型标识符(原因)和简短描述(消息)。
例如,发送无效的 JSON 将返回以下错误:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "parseError",
"message": "Parse Error",
}
],
"code": 400,
"message": "Parse Error"
}
}
从设备中收集测试信息
为了进一步测试,您可以使用以下 SDK 和 API 从您的设备收集信息:
Android 设备:请参阅 Places SDK for Android 和 Android 位置信息 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。如需详细了解每个字段,请参阅请求正文部分。 |