トラブルシューティング

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

エラー

エラーが発生した場合は、標準形式のエラー レスポンス本文が返され、HTTP ステータス コードがエラー ステータスに設定されます。

レスポンスには、次のキーを持つ単一の error オブジェクトを含むオブジェクトが含まれています。

  • code: レスポンスの HTTP ステータスと同じです。
  • message: エラーの簡単な説明。
  • status: エラーの性質を示すステータス コード。

たとえば、無効な placeId パラメータを送信すると、次のエラーが返されます。

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

考えられるエラーは次のとおりです。

コード ステータス メッセージ トラブルシューティング
400 INVALID_ARGUMENT 指定したキーは無効です。 API キーが無効であるか、リクエストに含まれていません。キー全体が含まれ、このキーで API が有効になっていることを確認してください。
400 INVALID_ARGUMENT 「\"path\" パラメータに無効な値が含まれています: б」 リクエストに無効な引数が含まれています。このエラーの原因として最も可能性が高いのは次のうちどれですか。
  • path パラメータに問題があります。
    ポイントは 1 つ以上 100 ポイント未満にしてください。各ポイントは、カンマで区切ったペアの数字にする必要があります(例: 48.409114,-123.369158)。ポイントはパイプ「|」で区切ります。
  • リクエストに無効な placeId が含まれています。
  • リクエストに placeIdpath の両方が含まれている。各リクエストで指定できるパラメータは 1 つだけです。

このエラーは、存在しない道路や道路ではない場所に対して placeId が渡されても返されません。

403 PERMISSION_DENIED 未登録のリクエストがブロックされました。Google Developers Console を使用して登録してください。 次のいずれかの理由でリクエストが拒否されました。
  • API キーがないか、無効です。
  • ご利用のアカウントで課金が有効になっていません。
  • ご自身で設定した使用量上限を超えている。
  • 指定したお支払い方法が無効になっている(クレジット カードの期限切れなど)

Google Maps Platform サービスを使用するには、アカウントで課金を有効にし、すべてのリクエストに有効な API キーを含める必要があります。この問題を解決するには、次の手順を行います。

404 NOT_FOUND このサービスには HTTPS が必要です。 リクエストの送信元が http://roads.googleapis.com/ ではなく、https://roads.googleapis.com/ であることを確認します。
429 RESOURCE_EXHAUSTED プロジェクトのリクエスト上限に達したため、リクエストが抑制されました。 Google Cloud Platform Console で構成したリクエスト数の上限を超えています。この上限は通常、1 日あたりのリクエスト数、100 秒あたりのリクエスト数、ユーザーごとの 100 秒あたりのリクエスト数として設定されます。この上限は、1 人または少人数のグループで 1 日の割り当てが不足するのを防ぐと同時に、すべてのユーザーに対する妥当なアクセスを許可するように構成する必要があります。これらの上限を構成するには、API 使用量の上限設定をご覧ください。

指数バックオフ

リクエストが失敗した場合、指数バックオフでリクエストを再試行する必要があります。たとえば、リクエストが 1 回失敗した場合は 1 秒後に再試行し、再度失敗した場合は 2 秒後に再試行し、4 秒後に再試行を繰り返します。多くのクライアントはリクエストを非常に迅速に再試行しようとするため、これによりリクエストが壊れた場合や大規模な障害が発生しても Google のサーバーにフラッドが発生しません。

トラブルシューティングに関するよくある質問

実装に関する問題

車両の位置情報はどの頻度でサンプリングすればよいですか?
道路へのスナップを高くするには、1 ~ 10 秒にすることをおすすめします。
クエリごとに送信できるポイントの数に制限はありますか?
はい、1 つのクエリに追加できるポイントは 100 個までです。
スナップした緯度/経度のペアを保存するには、どの程度の精度を使用する必要がありますか?
スナップした経路をすべてのズームレベルの道路に沿った状態にするには、最大ズームレベルでも、スナップした緯度 / 経度のペアを小数点以下 7 桁の精度で保存する必要があります。
エンコードされたポリラインを使用して、スナップされたパスを表示できますか?
エンコードされたポリラインは、小数点以下 5 桁までの精度で指定されるため、誤差は約 2 メートルになります。そのため、スナップした経路を高ズームレベルの道路に沿って移動させるには、エンコードされたポリラインは適していません。

よくある問題

一部のポイントがスナップされないか、スナップされたパスにギャップがあります。どうすれば解決できますか?
  • 時間間隔でポイントをサンプリングする場合は、より短い間隔(1 ~ 10 秒ごと)でポイントをサンプリングします。間隔を長くする(たとえば 60 秒)と、道路に接するスナップ アルゴリズムでは、十分な精度で走行する道路を判別できないことがあります。
  • 手動で地図をクリックしてポイントを作成する場合、スナップ アルゴリズムではうまく対処できないポイントがほとんどないスパース ポイントを作成することは非常に簡単です。スナップのアルゴリズムは、近接しているポイントに適しています。Snap to Road のデモを試すか、Roads Inspector を使用して経路をテストしてください。
拡大すると、スナップされたパスがギャザーになったり、道路からわずかにずれたりするのはなぜですか?
  • スナップされた緯度/経度のペアの精度は、それらを表示する前に切り捨てられていますか?スナップされた緯度と経度のペアを小数点以下 7 桁未満で保存すると、スナップされたパスが地図上に表示されるときに精度エラーが発生します。
  • エンコードされたポリラインを使用していますか?エンコードされたポリラインは、緯度/経度のペアを小数点以下 5 桁まで切り捨てます。これにより、数メートル単位の誤差が発生し、高いズームレベルでラインがジャグになったり、道路からわずかにずれたりします。

上記のいずれにも該当しない場合は、マップタイルが最近更新され、スナップに使用された道路指数と同期しなくなっている可能性があります。影響を受けるクエリ数が少ない場合は、これが原因である可能性があります。Google マップは定期的に更新されるため、古いパス(たとえば、数週間前にスナップしたパスなど)を定期的に見ると、この問題が発生することがあります。最適な可視化を実現するには、地図タイルを表示する前の古い経路を再スナップして、地図タイルとスナップに使用する道路インデックスとの間の不整合を最小限に抑える必要があります。

道路 X の制限速度が誤って表示される原因は何でしょうか。
制限速度は、精度とカバレッジの複数の要因によって変動します。特定の道路タイプや特定のエリアでの制限速度が常に不正確であるなど、パターンが見られる場合は、次の手順でお知らせください。
  1. デスクトップ パソコンまたは Android 版 Google マップ アプリで Google マップを開きます。
  2. 左側のメニューを開きます。
  3. [フィードバックを送信] を選択します。注: ログインを求められる場合があります。
  4. [地図を編集] を選択します。
  5. 編集する道路区分を選択します。
  6. [次へ] を選択します。
  7. [その他] 欄に、その道路の制限速度が間違っていることを示します。
  8. [送信] を選択します。
その他の問題(道路の名称が間違っている、道路が間違って描画されている、通行止め、私道など)もここで報告できます。
スナップされたパスが道路を通るのではなく、交差点になっているのはなぜですか?
この問題を解決するには、次の点を確認します。
  • interpolate パラメータが true に設定されていることを確認します。
  • 元のデータポイントが十分な間隔でサンプリングされていることを確認します(1 ~ 10 秒ごと)。
速度制限がない道路のスナップされた経路で、多数の道路セグメントが返されるのはなぜですか?
interpolate パラメータを true に設定すると、道路へのスナップのクエリは、角、曲線、ラウンドアバウトを中心とした道路に沿ったポリラインを返します。道路曲線の場合、制限速度が変わらなくても、複数の道路セグメントが返されます。これにより、道路のジオメトリにほぼ従ったポリラインが作成されます。