Bermigrasi ke Autocomplete (Baru)

Places API mendukung API Autocomplete dan Query Autocomplete yang ada. 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 HTTP POST. Sebaliknya, dengan API yang sudah 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 dalam API Autocomplete dan Query Autocomplete yang 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 menghapus locationBias dan locationRestriction, maka API akan 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 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 Autocomplete (Baru), Anda membuat permintaan POST dan meneruskan semua parameter dalam isi permintaan JSON atau di header sebagai bagian dari permintaan POST. Contoh ini juga menggunakan mask kolom sehingga respons 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