Places API mendukung Nearby Search (Lama). Jika Anda sudah terbiasa dengan Nearby Search (Lama), Nearby Search (Baru) akan melakukan perubahan berikut:
- Penelusuran Langsung baru menggunakan permintaan POST HTTP. Teruskan parameter dalam isi permintaan atau dalam header sebagai bagian dari permintaan HTTP POST. Sebaliknya, dengan Penelusuran Langsung (Lama), 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 kolom yang ditampilkan. Jika Anda menghapus daftar ini, metode akan menampilkan error. Untuk mengetahui informasi selengkapnya, lihat FieldMask.
- Nearby Search (Baru) mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.
- Hanya JSON yang didukung sebagai format respons di Penelusuran Langsung (Baru).
- Semua permintaan yang menyertakan kueri teks kini harus menggunakan Text Search (New) karena Nearby Search (New) tidak mendukung input teks.
- Format respons JSON untuk Penelusuran Langsung (Baru) telah berubah dari format API lama. Untuk detail selengkapnya, lihat Memigrasikan respons Places API.
Tabel berikut mencantumkan parameter di Nearby Search (Lama) yang telah diganti namanya atau diubah untuk Nearby Search (Baru), atau parameter yang tidak lagi didukung.
| Parameter saat ini | Parameter baru | Catatan |
|---|---|---|
keyword |
Tidak didukung. Sebagai gantinya, gunakan Text Search (Baru). | |
language |
languageCode |
|
location |
locationRestriction |
Wajib. |
maxprice/minprice |
|
Tidak didukung. |
maxResultCount |
Parameter baru. | |
opennow |
|
Tidak didukung. |
pagetoken |
Tidak didukung. | |
radius |
|
Gunakan locationRestriction sekarang. |
rankby |
rankPreference |
|
regionCode |
Parameter baru. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
Parameter baru juga menerima beberapa nilai jenis. API lama hanya menerima satu nilai. |
Contoh permintaan
Contoh permintaan GET berikut menggunakan Penelusuran Langsung
(Lama). Dalam contoh ini, Anda meminta respons JSON yang berisi informasi tentang tempat jenis restaurant dan meneruskan semua parameter sebagai parameter URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
Dengan Nearby 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 tempat yang diformat:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-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:searchNearby