Bermigrasi ke Nearby Search (Baru)

Developer Wilayah Ekonomi Eropa (EEA)

Pengantar

Places API mendukung Nearby Search (Lama). Jika Anda sudah memahami Nearby Search (Lama), Nearby Search (Baru) melakukan perubahan berikut:

  • Nearby Search (Baru) menggunakan permintaan HTTP POST. Teruskan parameter dalam isi permintaan atau di header sebagai bagian dari permintaan HTTP POST. Sebaliknya, dengan Nearby Search (Legacy), Anda meneruskan parameter URL menggunakan permintaan HTTP GET.
  • Penyamaran kolom wajib diisi. Anda harus menentukan kolom mana yang ingin ditampilkan dalam respons. Tidak ada daftar default kolom yang ditampilkan. Jika Anda tidak menyertakan 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 Nearby Search (Baru).
  • Semua permintaan yang menyertakan kueri teks kini harus menggunakan Text Search (Baru) karena Nearby Search (Baru) tidak mendukung input teks.
  • Format respons JSON untuk Nearby Search (Baru) telah berubah dari format API lama. Untuk mengetahui detail selengkapnya, lihat bagian 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 includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes 		Parameter baru juga menerima beberapa nilai jenis. API lama hanya menerima satu nilai.

Contoh permintaan

Contoh permintaan GET berikut menggunakan Nearby Search (Legacy). Dalam contoh ini, Anda meminta respons JSON yang berisi informasi tentang tempat dengan 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 di 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 yang diformat dari 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