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

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

はじめに

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

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

フィールド マスクは 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

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