Places API mendukung Place Details yang ada. Jika Anda sudah terbiasa dengan Places API yang ada, Place Details versi baru akan melakukan perubahan berikut:
- 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.
- Place Details baru mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.
- Hanya JSON yang didukung sebagai format respons di Place Details baru.
- Format respons JSON untuk Place Details (New) API telah berubah dari format API yang ada. Untuk detail selengkapnya, lihat Memigrasikan respons Places API.
Tabel berikut mencantumkan parameter di Place Details yang ada yang telah diganti namanya atau diubah untuk Place Details baru, atau parameter yang tidak lagi didukung.
| Parameter saat ini | Parameter baru | Catatan |
|---|---|---|
place_id |
places/PLACE_ID |
String places/PLACE_ID juga disebut sebagai
nama resource tempat. Dalam respons dari permintaan Place Details (Baru),
Nearby Search (Baru), dan Text Search (Baru),
string ini terdapat dalam kolom name respons.
ID tempat mandiri terdapat di kolom id respons. |
language |
languageCode |
|
region |
regionCode |
Contoh permintaan
Contoh permintaan GET berikut menggunakan Place Details yang ada. Dalam contoh ini, Anda meminta respons JSON yang berisi informasi tentang ID tempat dan meneruskan semua parameter sebagai parameter URL. Contoh ini juga menggunakan fields sehingga respons hanya menyertakan nama tampilan dan alamat tempat yang diformat:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
Dengan Place Details (Baru), Anda membuat permintaan GET dan meneruskan semua parameter dalam parameter dan header URL sebagai bagian dari permintaan. Contoh ini juga menggunakan mask kolom sehingga respons hanya menyertakan nama tampilan dan alamat tempat yang diformat:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
String places/PLACE_ID juga disebut sebagai nama resource tempat. Dalam respons dari permintaan Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru), string ini terdapat dalam kolom name respons. ID tempat mandiri terdapat dalam
kolom id respons.