Places API は、既存の Autocomplete API と Query Autocomplete API をサポートしています。これらの API をよくご存じの場合、予測入力(新版)では次のような変更が行われています。
- 予測入力(新版)では HTTP POST リクエストを使用します。パラメータは、HTTP POST リクエストの一部として、リクエスト本文またはヘッダーで渡します。一方、既存の API では、HTTP GET リクエストを使用して URL パラメータを渡します。
- 予測入力(新版)は、認証メカニズムとして 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 を使用します。この例では、タイプ 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 New では、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