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

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

はじめに

Places API は、Place Autocomplete（従来版） API と Query Autocomplete（従来版） API をサポートしています。これらの API に精通している場合、Autocomplete（新版）では次の変更が行われます。

  • 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 リクエストの一部として渡します。

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

フィールド マスクの使用方法について詳しくは、Place Details（新版）をご覧ください。