オートコンプリート（新）に移行する

はじめに

Places API は、Place Autocomplete（従来版）と Query Autocomplete（従来版）の API をサポートしています。これらの API をよくご存知の場合は、予測入力（新版）で次の変更が行われます。

• Autocomplete（新版）は HTTP POST リクエストを使用します。HTTP POST リクエストの一部として、リクエスト本文またはヘッダーでパラメータを渡します。一方、以前の API では、HTTP GET リクエストを使用して URL パラメータを渡します。
• Autocomplete（新機能）は、認証メカニズムとして API キーと OAuth トークンの両方をサポートしています。
• Autocomplete（新機能）では、レスポンス形式として JSON のみがサポートされています。

次の表に、Autocomplete（新機能）で名前が変更または修正された Place Autocomplete（従来版）と Query Autocomplete（従来版）のパラメータ、またはサポートされなくなったパラメータを示します。

現在のパラメータ	新しいパラメータ	メモ
components	includedRegionCodes
language	languageCode
location	locationBias
ipbias		locationBias と locationRestriction の両方を省略すると、API はデフォルトで IP バイアスを使用します。
offset	inputOffset
radius	locationBias または locationRestriction
region	regionCode
stricbounds	locationRestriction
sessiontoken	sessionToken
types	includedPrimaryTypes

リクエスト例

次の GET リクエストの例では、Place Autocomplete（レガシー）を使用しています。この例では、タイプ establishment の「Amoeba」という場所に関する情報を含む JSON レスポンスをリクエストし、すべてのパラメータを URL パラメータとして渡します。

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

Autocomplete（新機能）では、POST リクエストを作成し、すべてのパラメータを JSON リクエスト本文またはヘッダーで POST リクエストの一部として渡します。

Autocomplete（新版）リクエストではフィールド マスクは必須ではありませんが、レスポンスで特定の結果をフィルタリングするために使用できます。たとえば、次のリクエストではフィールド マスクを使用しているため、レスポンスには候補の suggestions.placePrediction.text のみが含まれます。

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

フィールド マスクの使用について詳しくは、プレイスの詳細（新版）をご覧ください。