Text Search(新規)への移行

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'