문제 해결

다음은 일반적인 문제를 해결하기 위한 몇 가지 도움말입니다.

정확도 반경이 매우 큰 이유는 무엇인가요?

Geolocation 응답의 정확성 필드에 매우 높은 값이 표시되면 서비스에서 WiFi 포인트 또는 휴대폰 기지국 대신 요청 IP를 기반으로 위치정보를 찾는 것일 수 있습니다. 서비스가 휴대폰 기지국이나 액세스 포인트를 인식하지 못하는 경우 이러한 종류의 응답이 발생할 수 있습니다.

서비스에서 액세스 포인트의 위치정보를 파악할 수 없는지 확인하려면 요청에서 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를 사용하여 기기에서 정보를 수집할 수 있습니다.

오류 설명

다음은 설명에서 발생할 수 있는 오류입니다.

이유 도메인 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이 아닙니다. 각 필드에 대한 자세한 내용은 요청 본문 섹션을 참조하세요.