Places API mendukung API Autocomplete dan Query Autocomplete yang ada. Jika Anda sudah memahami API ini, Autocomplete (Baru) akan melakukan perubahan berikut:
- Pelengkapan Otomatis (Baru) menggunakan permintaan POST HTTP. Teruskan parameter dalam isi permintaan atau dalam header sebagai bagian dari permintaan POST HTTP. Sebaliknya, dengan API yang ada, Anda meneruskan parameter URL menggunakan permintaan GET HTTP.
- Autocomplete (Baru) mendukung token kunci API dan OAuth sebagai mekanisme autentikasi.
- Hanya JSON yang didukung sebagai format respons di Autocomplete (Baru).
Tabel berikut mencantumkan parameter di Autocomplete dan Query Autocomplete API yang sudah ada yang telah diganti namanya atau diubah untuk Autocomplete (Baru), atau parameter yang tidak lagi didukung.
| Parameter saat ini | Parameter baru | Catatan |
|---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Jika Anda menghilangkan locationBias dan locationRestriction, API akan menggunakan bias IP secara default. |
|
offset |
inputOffset |
|
radius |
locationBias atau locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Contoh permintaan
Contoh permintaan GET berikut menggunakan Place Autocomplete yang ada. Dalam contoh ini, Anda meminta respons JSON yang berisi informasi tentang tempat bernama "Amoeba" yang berjenis establishment dan meneruskan semua parameter sebagai parameter 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'
Dengan Pelengkapan Otomatis (Baru), Anda membuat permintaan POST dan meneruskan semua parameter dalam isi permintaan JSON atau di header sebagai bagian dari permintaan POST.
Mask kolom tidak diperlukan untuk permintaan Autocomplete (New), tetapi dapat
digunakan untuk memfilter hasil tertentu dalam respons. Misalnya, permintaan
berikut menggunakan mask kolom sehingga respons hanya menyertakan
suggestions.placePrediction.text saran:
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
Untuk mempelajari lebih lanjut cara menggunakan mask kolom, lihat Places Details (New).