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

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

トラブルシューティング

トラブルシューティング

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

ジオコーダでは、住所のスペルミスや存在しない住所など、あいまい、不完全、または形式が不適切なクエリは、ZERO_RESULTS を生成しやすくなります。住所が見つからない場合は、部分的な結果（住所の代わりに郊外のみを返すなど）よりも ZERO_RESULTS を使用することをおすすめします。

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

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

レスポンスの速さが求められますが、ジオコーダはアプリケーションに適していません。迅速な対応に役立つツールは何ですか？

ユーザー入力に応答し、レイテンシに非常に敏感なアプリケーションでは、住所のジオコーディングではなく、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 ライブラリから取得することをおすすめします。プレイス オートコンプリートの費用を削減するために使用できる placeIdOnly オプションの情報もご覧ください。

Directions API（従来版）または Distance Matrix API（従来版）に、プレイス ID や latlng ではなく住所文字列でクエリを実行すると、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 を使用して、具体的なクエリをいくつかお知らせください。結果の品質に問題を引き起こしているバグやシステムの問題がないか、デベロッパーがより良い結果を得られるようベスト プラクティス ガイドを変更できる点がないか調査いたします。

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

ジオコーダでは、 コンポーネント フィルタリングにより、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 のジオコーディングでは、ドイツのフランクフルト アム マインの 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 を使用してビューポートを指定し、 位置情報の結果にバイアスをかけると、米国内の「マドリッド」という名前の複数の都市を含むレスポンスが生成されます。
      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