はじめに
Places API は、 Place Autocomplete（従来版） API と Query Autocomplete（従来版） API をサポートしています。 これらの API を使用したことがある場合は、Autocomplete（新機能）で次の変更が行われます。
- Autocomplete（新機能）では HTTP POST リクエストを使用します。パラメータは、 リクエスト本文またはヘッダーで、HTTP POST リクエストの一部として渡します。一方、 従来版の API では、HTTP GET リクエストを使用して URL パラメータを渡します。
- Autocomplete（新機能）では、認証メカニズムとして API キー と OAuth トークンの両方がサポートされています。
- Autocomplete（新機能）では、レスポンス形式として 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（新機能）をご覧ください。