Places API mendukung Penelusuran Teks. Jika Anda sudah familier dengan Text Search, Text Search versi baru membuat perubahan berikut:
- Text Search baru menggunakan permintaan POST HTTP. Lewat di 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 responsnya. Tidak ada daftar default untuk kolom yang ditampilkan. Jika Anda menghilangkan daftar ini, metode akan mengembalikan pesan {i>error<i}. Untuk informasi selengkapnya, lihat FieldMask.
- Text Search baru mendukung kedua kunci API dan token OAuth sebagai mekanisme autentikasi.
- Hanya JSON yang didukung sebagai format respons dalam Penelusuran Teks.
Text Search yang ada memungkinkan Anda menentukan lintang dan bujur koordinat dalam string kueri. Misalnya:
query=37.4239,-122.0925. Opsi itu tidak didukung di Text Search yang baru.Gunakan Geocoding Terbalik untuk mencari koordinat dan mengembalikan alamat, atau Nearby Search (Baru) untuk menemukan tempat di sekitar lokasi tertentu.
- Format respons JSON untuk Text Search (Baru) API telah berubah dari format API yang sudah ada. Untuk detail selengkapnya, lihat Memigrasikan respons Places API.
Tabel berikut mencantumkan parameter yang ada Text Search 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 Penelusuran Teks. Dalam contoh ini, Anda meminta JSON Respons yang berisi informasi tentang "Makanan Vegetarian Pedas di Jakarta, 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 proses POST permintaan. Contoh ini juga menggunakan mask kolom sehingga responsnya 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'