Places API mendukung Text Search yang ada. Jika Anda sudah terbiasa dengan Penelusuran Teks yang ada, Penelusuran Teks versi baru akan melakukan perubahan berikut:
- Penelusuran Teks baru menggunakan permintaan POST HTTP. Teruskan parameter dalam isi permintaan atau dalam header sebagai bagian dari permintaan POST HTTP. Sebaliknya, dengan Penelusuran Teks yang ada, Anda meneruskan parameter URL menggunakan permintaan GET HTTP.
- Masking kolom diperlukan. Anda harus menentukan kolom yang ingin ditampilkan dalam respons. Tidak ada daftar default kolom yang ditampilkan. Jika Anda menghapus daftar ini, metode akan menampilkan error. Untuk mengetahui informasi selengkapnya, lihat FieldMask.
- Penelusuran Teks baru mendukung token kunci API dan OAuth sebagai mekanisme autentikasi.
- Hanya JSON yang didukung sebagai format respons di Text Search baru.
Penelusuran Teks yang ada memungkinkan Anda menentukan koordinat garis lintang dan bujur dalam string kueri. Misalnya:
query=37.4239,-122.0925. Opsi tersebut tidak didukung di Penelusuran Teks versi baru.Gunakan Geocoding Terbalik untuk menelusuri koordinat dan menampilkan alamat, atau Penelusuran Langsung (Baru) untuk menemukan tempat di sekitar lokasi tertentu.
- Format respons JSON untuk Text Search (New) API telah berubah dari format API yang ada. Untuk detail selengkapnya, lihat Memigrasikan respons Places API.
Tabel berikut mencantumkan parameter dalam Penelusuran Teks yang ada yang telah diganti namanya atau diubah untuk Penelusuran Teks 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 dalam 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 Text Search yang ada. Dalam contoh ini, Anda meminta respons JSON yang berisi informasi tentang "Spicy Vegetarian Food in 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 dalam header sebagai bagian dari permintaan POST. Contoh ini juga menggunakan mask kolom sehingga respons hanya menyertakan nama tampilan dan alamat tempat yang diformat:
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'