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

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

はじめに

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

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

オートコンプリート（新機能）リクエストにフィールド マスクは必要ありませんが、レスポンスで特定の結果をフィルタするために使用できます。たとえば、次のリクエストではフィールド マスクを使用しているため、レスポンスには候補の 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

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