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

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

はじめに

Places API は、Place Autocomplete（従来版）と 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 リクエストの一部として渡します。

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

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