Places API mendukung Place Details yang ada. Jika Anda sudah memahami Places API yang ada, Place Details versi baru akan membuat perubahan berikut:
- Penyamaran kolom wajib diisi. Anda harus menentukan kolom mana yang ingin ditampilkan dalam respons. Tidak ada daftar default kolom yang ditampilkan. Jika Anda menghapus daftar ini, metode tersebut akan menampilkan error. Untuk informasi selengkapnya, lihat FieldMask.
- Place Details yang baru mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.
- Hanya JSON yang didukung sebagai format respons di Place Details yang baru.
- Format respons JSON untuk Place Details (Baru) API telah berubah dari format API yang sudah 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. Sebagai respons dari permintaan Place Details (Baru),
Nearby Search (Baru), dan Text Search (Baru), string ini terdapat dalam kolom name pada respons.
ID tempat mandiri terdapat di kolom id dalam 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 berformat tempat:
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 di parameter dan header URL sebagai bagian dari permintaan. Contoh ini juga menggunakan mask kolom sehingga respons hanya menyertakan nama tampilan dan alamat berformat tempat tersebut:
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 nama resource tempat. Sebagai respons dari permintaan Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru), string ini terdapat dalam kolom name pada respons. ID tempat mandiri terdapat di kolom id respons.