Bermigrasi ke Nearby Search (Baru)

Places API mendukung Nearby Search yang sudah ada. Jika Anda sudah terbiasa dengan Nearby Search yang sudah ada, Nearby Search versi baru akan melakukan perubahan berikut:

  • Nearby Search baru menggunakan permintaan POST HTTP. Teruskan parameter dalam isi permintaan atau di header sebagai bagian dari permintaan POST HTTP. Sebaliknya, dengan Nearby Search yang sudah ada, 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 untuk kolom yang ditampilkan. Jika Anda menghilangkan daftar ini, metode akan menampilkan error. Untuk informasi selengkapnya, lihat FieldMask.
  • Nearby Search yang baru mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.
  • Hanya JSON yang didukung sebagai format respons di Nearby Search yang baru.
  • Semua permintaan yang menyertakan kueri teks sekarang harus menggunakan Text Search (Baru) karena Nearby Search (Baru) tidak mendukung input teks.
  • Format respons JSON untuk Nearby Search API (Baru) telah berubah dari format API yang sudah ada. Untuk detail selengkapnya, lihat Memigrasikan respons Places API.

Tabel berikut mencantumkan parameter di Nearby Search yang ada 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 includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
Parameter baru juga menerima beberapa nilai jenis. API yang ada hanya menerima satu nilai.

Contoh permintaan

Contoh permintaan GET berikut menggunakan Nearby Search yang sudah ada. Dalam contoh ini, Anda meminta respons JSON yang berisi informasi tentang tempat berjenis 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 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