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

ここでは、Geocoding API に関する質問を取り上げます。 すべての Google Maps Platform に関するよくある質問については、Google Maps Platform のよくある質問をご覧ください。住所のジオコーディングに関するベスト プラクティスもご覧ください。

トラブルシューティング

トラブルシューティング

ジオコーダによって 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 の Places Library から取得するのが最適です。Place Autocomplete のコストを抑えるために、placeIdOnly オプションの情報もご覧ください。

Directions API や Distance Matrix API を場所 ID や緯度 / 経度ではなく住所文字列で照会すると、Geocoding API と同じバックエンドを使って住所が変換され、ルートが計算されます。Place Autocomplete は、住所のジオコーディングよりも速くなります。ユーザー入力への応答など、レイテンシの影響を受けやすい状況で Directions API や Distance Matrix API を使用するアプリケーションの場合は、Place Autocomplete を使用して、これらの住所に対応する場所 ID を取得し、場所 ID を Directions API または Distance Matrix API に渡すことをおすすめします。このアプローチにより、レイテンシが大幅に短縮されます。詳しくは、経路案内で Place Autocomplete を使用する方法に関するドキュメントをご覧ください。

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

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

私のユースケースでは、ジオコーダが適切な結果を生成していません。どのようなヘルプを利用できますか？

Google が公開している 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) でプレイス オートコンプリートを使用し、location と radius を使ってビューポートを指定して位置情報の結果にバイアスをかけると、米国の「マドリッド」という都市を含むレスポンスが生成されます。
      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