オートコンプリート(新)に移行する

Places API は既存の 予測入力 Query Autocomplete API を使用します。 これらの API をよくご存じの場合、予測入力(新版)では次のような変更が行われています。

  • 予測入力(新版)では HTTP POST リクエストを使用します。パラメータを渡す HTTP POST リクエストの一部として、リクエスト本文、またはヘッダーで記述する必要があります。一方 使用する場合は、 HTTP GET リクエスト。
  • 予測入力(新版)は両方の API キーをサポート と OAuth トークンを認証メカニズムとして使用します。
  • Autocomplete(新版)では、レスポンス形式として JSON のみがサポートされています。

次の表に、既存の Autocomplete(新)用に名前が変更されたか変更された Autocomplete API と Query Autocomplete API、またはサポートが終了したパラメータ。

現在のパラメータ 新しいパラメータ メモ
components includedRegionCodes
language languageCode
location locationBias
ipbias locationBiaslocationRestriction を両方とも省略すると、 API ではデフォルトで IP バイアスが使用されます。
offset inputOffset
radius locationBias または locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

リクエスト例

次の GET リクエストの例では、既存の Place Autocompleteこの例では、Cloud Storage バケットの 「Amoeba」という場所に関する情報を含むレスポンス次の種類である establishment を指定し、すべてのパラメータを 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 リクエストを行い POST の一部として JSON リクエスト本文またはヘッダーですべてのパラメータを渡す リクエストできます。この例ではフィールド マスクも使用しているため、レスポンスには 場所の表示名と書式付きの住所:

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" \
https://places.googleapis.com/v1/places:autocomplete