Bermigrasi ke Nearby Search (Baru)

Developer Wilayah Ekonomi Eropa (EEA)

Pengantar

Places API mendukung Nearby Search (Legacy). Jika Anda sudah familiar dengan Nearby Search (Legacy), Nearby Search (Baru) akan melakukan perubahan berikut ini:

  • Nearby Search (Baru) menggunakan permintaan HTTP POST. Teruskan parameter dalam isi permintaan atau di header sebagai bagian dari permintaan HTTP POST permintaan. Sebaliknya, dengan Nearby Search (Legacy), Anda meneruskan parameter URL menggunakan permintaan HTTP GET.
  • Masking kolom wajib diisi. Anda harus menentukan kolom yang ingin ditampilkan dalam respons. Tidak ada daftar kolom yang ditampilkan secara default. 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 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 (Legacy) 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. Gunakan Text Search (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 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 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 yang diformat dari tempat tersebut:

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