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

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

はじめに

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

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