Places API mendukung Nearby Search. Jika Anda terbiasa dengan Nearby Search yang ada, Nearby Search versi baru membuat perubahan berikut:
- Nearby Search baru menggunakan permintaan POST HTTP. Meneruskan parameter di isi permintaan atau di header sebagai bagian dari HTTP POST permintaan. Sebaliknya, dengan Nearby 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.
- Nearby Search yang baru mendukung Kunci API dan OAuth token sebagai mekanisme otentikasi.
- Hanya JSON yang didukung sebagai format respons dalam Nearby Search.
- Semua permintaan yang menyertakan kueri teks sekarang harus menggunakan Penelusuran Teks (Baru) karena Nearby Search (Baru) tidak mendukung input teks.
- Format respons JSON untuk Nearby 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 Nearby Search yang telah diubah namanya atau diubah untuk Nearby Search baru, atau parameter yang tidak lagi didukung.
| Parameter saat ini | Parameter baru | Catatan |
|---|---|---|
keyword |
Tidak didukung. Gunakan Penelusuran Teks (Baru) sebagai gantinya. | |
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 yang sudah ada hanya menerima satu nilai. |
Contoh permintaan
Contoh permintaan GET berikut menggunakan
Nearby Search. Dalam contoh ini, Anda meminta JSON
respons yang berisi informasi tentang tempat berjenis restaurant dan teruskan 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 proses POST permintaan. Contoh ini juga menggunakan mask kolom sehingga responsnya hanya menyertakan nama tampilan dan alamat berformat tempat:
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