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 |
locationBias と locationRestriction を両方とも省略すると、
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