Places API mendukung Pelengkapan Otomatis dan Query Autocomplete API. Jika Anda sudah terbiasa dengan API ini, Autocomplete (Baru) akan melakukan perubahan berikut:
- Pelengkapan Otomatis (Baru) menggunakan permintaan POST HTTP. Teruskan parameter dalam isi permintaan atau di header sebagai bagian dari permintaan POST HTTP. Sebaliknya, dengan API yang ada, Anda meneruskan parameter URL menggunakan Permintaan GET HTTP.
- Autocomplete (Baru) mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.
- Hanya JSON yang didukung sebagai format respons di Autocomplete (Baru).
Tabel berikut mencantumkan parameter yang ada API Autocomplete dan Query Autocomplete 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 , maka
API menggunakan pembiasan IP secara default. |
|
offset |
inputOffset |
|
radius |
locationBias atau locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Contoh permintaan
Contoh permintaan GET berikut menggunakan
Pelengkapan Otomatis Tempat. Dalam contoh ini, Anda meminta JSON
respons yang berisi informasi tentang tempat yang bernama "Amoeba" yang berjenis
establishment
dan teruskan 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 Autocomplete (Baru), Anda membuat permintaan POST dan meneruskan semua parameter dalam isi permintaan JSON atau di header sebagai bagian dari proses POST permintaan. Contoh ini juga menggunakan mask kolom sehingga responsnya hanya menyertakan nama tampilan dan alamat berformat tempat:
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