トラブルシューティング

一般的な問題のトラブルシューティングに関するヒントをいくつかご紹介します。

精度半径が非常に大きいのはなぜですか？

Geolocation のレスポンスの accuracy フィールドに非常に高い値が表示されている場合、サービスは Wi-Fi ポイントや基地局ではなく、リクエスト 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"
 }
}

デバイスからテスト情報を収集する

追加のテストとして、各プラットフォームが提供する組み込みの位置情報サービスを使用して、デバイスから情報を収集できます。

エラーの説明

発生する可能性のあるエラーとその説明を以下に示します。

理由 ドメイン HTTP ステータス コード 説明
dailyLimitExceeded usageLimits 403 1 日の利用時間の上限を超えました。
keyInvalid usageLimits 400 API キーが Geolocation API で有効ではありません。キー全体を含める必要があります。また、API を購入しているか、課金を有効にして API を有効化して、割り当てを無料で取得している必要があります。
userRateLimitExceeded usageLimits 403 Google Cloud コンソールで構成したリクエストの上限を超えています。この上限は通常、1 日あたりのリクエスト数、100 秒あたりのリクエスト数、ユーザーごとの 100 秒あたりのリクエスト数として設定されます。1 人または少数のユーザーが 1 日の割り当てを使い切らないように、かつすべてのユーザーが適切なアクセスを行えるように、上限を構成する必要があります。これらの上限を構成するには、API 使用量の上限設定をご覧ください。
notFound geolocation 404 リクエストは有効ですが、結果が返されませんでした。
parseError global 400 リクエスト本文が有効な JSON ではありません。各フィールドの詳細については、リクエスト本文のセクションをご覧ください。