Bermigrasi ke Text Search (Baru)

Developer Wilayah Ekonomi Eropa (EEA)

Pengantar

Places API (Lama) mendukung Text Search (Lama). Jika Anda sudah familiar dengan Text Search (Legacy), Text Search (Baru) melakukan perubahan berikut:

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

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

  • Format respons JSON untuk Penelusuran Teks (Baru) telah berubah dari format API lama. Untuk mengetahui detail selengkapnya, lihat bagian Memigrasikan respons Places API.

Tabel berikut mencantumkan parameter di Text Search (Lama) 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 pageToken
query textQuery Wajib ada di semua permintaan.
radius locationBias Tentukan radius saat menentukan locationBias.
region regionCode
type includedType Hanya memerlukan satu nilai.
strictTypeFiltering Parameter baru.

Contoh permintaan

Contoh permintaan GET berikut menggunakan Penelusuran Teks (Lama). 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 yang diformat dari 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'