Places API を使用すると、施設、著名なスポット、地理的位置など、さまざまなカテゴリを使用して場所情報を検索できます。場所は、近接性またはテキスト文字列で検索できます。Place Search は、場所のリストと各場所の概要情報を返します。Place Details クエリを使用して追加情報を取得できます。
検索タイプの比較
使用できる検索エンドポイントは 3 つあり、それぞれ特性が異なります。次の表に、これらの違いの一部を示します。
| タイプ | フィールドの選択 | テキスト検索 | あいまいなテキスト | ロケーション フィルタ | その他のフィルタ |
|---|---|---|---|---|---|
| Find Place | input |
||||
| Nearby Search | keyword |
||||
| テキスト検索 | query |
フィールドの選択
Nearby Search や Text Search で、特定のフィールドのみを返すように制限することはできません。不要なデータがリクエストされて課金されるのを防ぐには、代わりに Find Place リクエストを使用します。
不明確なテキスト
Find Place と Text Search は、複数のフィールドにわたるあいまいなテキストの照合に最適化されていますが、Nearby Search はフィールドのサブセットでの厳密な一致に制限されています。
他のフィルタ
Nearby Search と Text Search では、追加のパラメータ（minprice、maxprice、opennow、type など）を使用して結果をフィルタできます。