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

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

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

次の表に、Autocomplete（新版）用に名前が変更されたか変更された既存の Autocomplete API と Query Autocomplete API のパラメータ、またはサポートが終了したパラメータを示します。

現在のパラメータ	新しいパラメータ	メモ
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 New では、POST リクエストを行い、POST リクエストの一部として JSON リクエスト本文またはヘッダーですべてのパラメータを渡します。また、この例ではフィールド マスクを使用して、レスポンスに場所の表示名とフォーマット済み住所のみが含まれるようにしています。

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" \
https://places.googleapis.com/v1/places:autocomplete