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