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

ここでは、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 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