ジオコーディングに関するよくある質問

この FAQ では、Geocoding API 固有の質問について説明します。Google Maps Platform 全般に関する質問については、Google Maps Platform のよくある質問をご覧ください。住所のジオコーディングに関するベスト プラクティスもご覧ください。

トラブルシューティング

トラブルシューティング

ジオコーダで ZERO_RESULTS を返すクエリが増えています。何が起きているのでしょうか？

ジオコーダでは、スペルミスのある住所や存在しない住所など、曖昧で不完全な形式の悪いクエリは ZERO_RESULTS を生成する傾向があります。住所が見つからない場合は、部分的な結果（住所の代わりに郊外のみを返すなど）よりも ZERO_RESULTS の方が望ましいです。

アプリケーションで住所のユーザー入力を扱う場合は、Places API の Place Autocomplete 機能を使用すると、より質の高い結果が得られる可能性があります。Place Autocomplete を使用すると、ユーザーは入力した内容に基づいて結果のセットから選択できます。これにより、ユーザーは同様の名前の結果から選択したり、住所のスペルを間違えた場合にクエリを調整したりできます。

あいまいなクエリ、不完全なクエリ、エラーが含まれている可能性のあるクエリを処理するアプリケーションがある場合は、Geocoding API で使用できるフォワード ジオコーダーではなく、Places API の Place Autocomplete 機能を使用することをおすすめします。詳しくは、 住所のジオコーディングに関するベスト プラクティスと、 Google Maps API での住所のジオコーディングに関するブログ投稿をご覧ください。

迅速なレスポンスが必要ですが、ジオコーダはアプリケーションにとって遅すぎます。回答を迅速に行うには、どのような方法がありますか？

ユーザー入力に応答するアプリケーションは、レイテンシの影響を受けやすいため、住所のジオコーディングではなく、Places API の Place Autocomplete 機能（JavaScript、Android、iOS でも利用可能）を使用することをおすすめします。 プレイス オートコンプリートはインタラクティブな使用を想定して最適化されているため、レイテンシを大幅に短縮できます。

Geocoding API の住所ジオコーディングは、オンライン フォームに入力された配送先住所など、完全で曖昧さのない、適切な形式の住所での使用に最適化されているため、Place Autocomplete よりもレイテンシが高くなります。フォワード ジオコーダは、カバレッジが広く、結果の品質も高くなりますが、レイテンシがやや高くなります。

Directions API（レガシー）と Distance Matrix API（レガシー）のレイテンシを軽減するにはどうすればよいですか？

住所の代わりにプレイス ID を使用して、経由地、出発地、目的地を指定します。プレイス ID は、Places API の Place Autocomplete 機能または Maps JavaScript API のプレイス ライブラリから取得するのが最適です。Place Autocomplete のコストを削減するために使用できる placeIdOnly オプションに関する情報もご覧ください。

Directions API（以前のバージョン）または Distance Matrix API（以前のバージョン）が、プレイス ID や緯度 / 経度ではなく住所文字列でクエリされると、Geocoding API と同じバックエンドを使用して、その住所をプレイス ID に変換してからルートを計算します。Place Autocomplete は住所のジオコーディングよりも高速です。ユーザー入力への応答など、レイテンシが非常に重要な状況で Directions API（レガシー）または Distance Matrix API（レガシー）を使用するアプリケーションの場合は、Place Autocomplete を使用してこれらのアドレスに対応するプレイス ID を取得し、そのプレイス ID を Directions API（レガシー）または Distance Matrix API（レガシー）に渡すことをおすすめします。このアプローチにより、レイテンシが大幅に短縮されます。 Place Autocomplete とルートの使用例については、ドキュメントをご覧ください。

ジオコーダのバグを報告するにはどうすればよいですか？

フォワード ジオコーダ サービスに関する バグレポートや 機能リクエストがある場合は、公開されている Issue Tracker を使用してお知らせください。

ジオコーダーがユースケースに適した結果を生成しません。どのようなサポートを受けられますか？

公開されている Issue Tracker を使用して、具体的なクエリをいくつか共有してください。Google は、結果の品質に問題を引き起こすバグやシステム上の問題がないかどうかを調査します。また、デベロッパーがより良い結果を得られるように、ベスト プラクティス ガイドに変更を加えることができるかどうかを調査します。

コンポーネント フィルタリングを使用してジオコーダで最良の結果を得るにはどうすればよいですか？

ジオコーダでは、 コンポーネント フィルタリングにより、postal_code と country の制限のみが適用されます。次の例は、必要な結果に応じてコンポーネント フィルタリングを最適に使用する方法を示しています。リクエスト URL の例では、`YOUR_API_KEY` を実際の API キーに置き換えてください。

  • 郵便番号を特定の国に制限するには、ISO 3166-2 国コードを使用して国別のポリシーを指定してください。たとえば、components=country:CH|postal_code:8000 は「8000 Zürich, Switzerland」を返します。
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • クエリを特定の国に制限するには、ISO 3166-2 国コードを使用して国別のポリシーを指定してください。国名などの略称は、国コードと同じ結果を生成しない場合があります。

    例:

    • components=country:FRA|locality:gallus をジオコーディングすると、ドイツのフランクフルト アム マインのガルス地区が返されます。これは、フランスの 3 文字の国コード（FRA）がサポートされていないため、どの国でも結果が許可され、フランクフルトの結果がフランスの結果よりも適しているためです。
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • Geocoding API は、曖昧なクエリに対して複数の結果を返すとは限りません。このようなクエリには、Place Autocomplete の方が適しています。

    例:

    • components=country:US|locality:madrid のジオコーディングでは、「Madrid, NM 87010, USA」が返されますが、米国にある他の「Madrid」という名前の都市は返されません。
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • input=madrid&components=country:us&types=(regions) に Place Autocomplete を使用し、location と radius を使用してビューポートを指定して 位置情報の結果をバイアスすると、米国にある「Madrid」という名前の複数の都市を含むレスポンスが生成されます。
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY