Places API mendukung Place Details yang ada. Jika Anda sudah terbiasa dengan Places API yang sudah ada, Place Details versi baru akan membuat perubahan berikut:
- 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.
- 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 (New) API telah berubah dari format API yang sudah ada. Untuk detail selengkapnya, lihat Memigrasikan respons Places API.
Tabel berikut mencantumkan parameter dalam 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
nama resource tempat. Sebagai respons dari permintaan Place Details (Baru),
Nearby Search (Baru), dan Text Search (Baru),
string ini dimuat dalam kolom name respons.
ID tempat mandiri terdapat di kolom id pada 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 dalam parameter URL dan header sebagai bagian dari permintaan tersebut. Contoh ini juga menggunakan mask kolom sehingga responsnya hanya menyertakan nama tampilan dan alamat berformat tempat:
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 dimuat dalam
kolom name respons. ID tempat mandiri terdapat di kolom id pada respons.