Text Search（新規）への移行

欧州経済領域（EEA）のデベロッパー

はじめに

Places API（以前のバージョン）は、Text Search（以前のバージョン）をサポートしています。テキスト検索（以前のバージョン）をご利用の場合、テキスト検索（新版）では次の変更が行われます。

  • テキスト検索（新版）では HTTP POST リクエストを使用します。HTTP POST リクエストの一部として、リクエスト本文またはヘッダーでパラメータを渡します。一方、テキスト検索（以前のバージョン）では、HTTP GET リクエストを使用して URL パラメータを渡します。
  • フィールドのマスキングが必要です。レスポンスで返すフィールドを指定する必要があります。返されるフィールドのデフォルトのリストはありません。このリストを省略すると、メソッドはエラーを返します。詳細については、FieldMask をご覧ください。
  • テキスト検索（新版）では、認証メカニズムとして API キーと OAuth トークンの両方がサポートされています。
  • テキスト検索（新版）では、レスポンス形式として JSON のみがサポートされています。

  • テキスト検索（以前のバージョン）では、クエリ文字列で緯度と経度の座標を指定できます。例: query=37.4239,-122.0925。 このオプションはテキスト検索（新版）ではサポートされていません。

    リバース ジオコーディングを使用して座標で検索して住所を返すか、Nearby Search（新版）を使用して特定の場所の周辺にある場所を検索します。

  • テキスト検索（新版）の JSON レスポンス形式が、以前の API の形式から変更されました。詳しくは、Places API レスポンスを移行するをご覧ください。

次の表に、テキスト検索（新しい）で名前が変更または修正されたテキスト検索（以前の）のパラメータ、またはサポートされなくなったパラメータを示します。

現在のパラメータ 新しいパラメータ メモ
evOptions 新しいパラメータ。
language languageCode
location locationBias
maxprice/minprice priceLevels
opennow openNow
pagetoken pageToken
query textQuery すべてのリクエストで必須です。
radius locationBias locationBias を定義するときに半径を指定します。
region regionCode
type includedType 単一の値のみを受け取ります。
strictTypeFiltering 新しいパラメータ。

リクエスト例

次の GET リクエストの例では、テキスト検索（以前のバージョン）を使用しています。この例では、「オーストラリアのシドニーにあるスパイシーなベジタリアン料理」に関する情報を含む JSON レスポンスをリクエストし、すべてのパラメータを 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 リクエストを作成し、すべてのパラメータを JSON リクエスト本文またはヘッダーで POST リクエストの一部として渡します。この例では、フィールド マスクも使用しているため、レスポンスには場所の表示名と書式設定された住所のみが含まれます。

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'