Bermigrasi ke Autocomplete (Baru)

Developer Wilayah Ekonomi Eropa (EEA)

Pengantar

Places API mendukung API Place Autocomplete (Legacy) dan Query Autocomplete (Legacy). Jika Anda sudah terbiasa dengan API ini, Autocomplete (Baru) melakukan perubahan berikut:

  • Autocomplete (Baru) menggunakan permintaan HTTP POST. Teruskan parameter dalam isi permintaan atau di header sebagai bagian dari permintaan POST HTTP. Sebaliknya, dengan API lama, Anda meneruskan parameter URL menggunakan permintaan HTTP GET.
  • Pelengkapan Otomatis (Baru) mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.
  • Hanya JSON yang didukung sebagai format respons di Pelengkapan Otomatis (Baru).

Tabel berikut mencantumkan parameter di Place Autocomplete (Lama) dan Query Autocomplete (Lama) 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 tidak menyertakan 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 (Lama). 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 di isi permintaan JSON atau di header sebagai bagian dari permintaan POST.

Mask kolom tidak diperlukan untuk permintaan Pelengkapan Otomatis (Baru), 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 Detail Tempat (Baru).