Bermigrasi ke Text Search (Baru)

Places API mendukung Text Search yang ada. Jika Anda sudah terbiasa dengan Text Search yang sudah ada, Text Search versi baru akan membuat perubahan berikut:

  • Text Search baru menggunakan permintaan POST HTTP. Teruskan parameter dalam isi permintaan atau di header sebagai bagian dari permintaan POST HTTP. Sebaliknya, dengan Text Search yang ada, Anda meneruskan parameter URL menggunakan permintaan GET HTTP.
  • Penyamaran kolom wajib diisi. Anda harus menentukan kolom yang ingin ditampilkan dalam respons. Tidak ada daftar default untuk kolom yang ditampilkan. Jika Anda menghilangkan daftar ini, metode akan menampilkan error. Untuk informasi selengkapnya, lihat FieldMask.
  • Text Search yang baru mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.
  • Hanya JSON yang didukung sebagai format respons di Text Search baru.
  • Text Search yang sudah ada memungkinkan Anda menentukan koordinat lintang dan bujur dalam string kueri. Misalnya: query=37.4239,-122.0925. Opsi itu tidak didukung di Text Search yang baru.

    Gunakan Geocoding Terbalik untuk menelusuri koordinat dan menampilkan alamat, atau Nearby Search (Baru) untuk menemukan tempat di sekitar lokasi tertentu.

  • Format respons JSON untuk Text Search API (Baru) telah berubah dari format API yang sudah ada. Untuk detail selengkapnya, lihat Memigrasikan respons Places API.

Tabel berikut mencantumkan parameter dalam Text Search yang ada yang telah diganti namanya atau diubah untuk Text Search baru, atau parameter yang tidak lagi didukung.

Parameter saat ini Parameter baru Catatan
evOptions Parameter baru.
language languageCode
location locationBias
maxprice/minprice priceLevels
opennow openNow
pagetoken Tidak didukung.
query textQuery Wajib di semua permintaan.
radius locationBias Tentukan radius saat menentukan locationBias.
region regionCode
type includedType Hanya menggunakan satu nilai.
strictTypeFiltering Parameter baru.

Contoh permintaan

Contoh permintaan GET berikut menggunakan Text Search yang sudah ada. Dalam contoh ini, Anda meminta respons JSON yang berisi informasi tentang "Makanan Vegetarian Pedas di Sydney, Australia" dan meneruskan semua parameter sebagai parameter URL:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY

Dengan Text Search (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 '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'