Places API は既存の テキスト検索。既存の Security Command Center を Text Search では、 新しいバージョンのテキスト検索 次の変更が行われます。
- 新しいテキスト検索では HTTP POST リクエストを使用します。合格 パラメータは、リクエスト本文または HTTP POST リクエストのヘッダー部分に含めます。 一方、既存の Text Search では、 HTTP GET リクエストを使用する URL パラメータ。
- フィールド マスキングは必須です。返されるフィールドを指定する必要があります。 返されます。返されるフィールドのデフォルト リストはありません。省略した場合 メソッドはエラーを返します。詳細については、次をご覧ください: FieldMask。
- 新しい Text Search は両方の API キーに対応 と OAuth トークンを認証メカニズムとして使用します。
- 新しい API では、レスポンス形式として JSON のみがサポートされています。 Text Search
既存のテキスト検索では緯度と経度を指定できます 指定します。例:
query=37.4239,-122.0925。 このオプションは新しいテキスト検索ではサポートされていません。使用 リバース ジオコーディング 座標を検索して住所を返す Nearby Search（新版） 特定の場所の周囲の場所を検索できます。
- テキスト検索（新版）の JSON レスポンス形式 API が既存の API の形式から変更されました。詳しくは、 Places API のレスポンスを移行します。
次の表に、既存の の 新しいテキスト検索、またはサポートされなくなったパラメータを サポートされません。
| 現在のパラメータ | 新しいパラメータ | メモ |
|---|---|---|
evOptions |
新しいパラメータ。 | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
サポートされていません。 | |
query |
textQuery |
すべてのリクエストで必須です。 |
radius |
locationBias |
locationBias を定義するときに半径を指定する。 |
region |
regionCode |
|
type |
includedType |
1 つの値のみを受け取ります。 |
strictTypeFiltering |
新しいパラメータ。 |
リクエスト例
次の GET リクエストの例では、既存の Text Searchこの例では、Cloud Storage バケットの 「Spicy Vegetarian Food in Sydney」という オーストラリア」すべてのパラメータを URL パラメータとして渡します。
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
テキスト検索（新版）では、POST リクエストを行い、 POST の一部として JSON リクエスト本文またはヘッダーですべてのパラメータを渡す リクエストできます。この例ではフィールド マスクも使用しているため、レスポンスには 場所の表示名と書式付きの住所:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'