Places API mendukung Place Details yang ada. Jika Anda sudah terbiasa dengan Places API yang ada, Place Details versi baru akan membuat perubahan berikut:
- Penyamaran kolom wajib diisi. Anda harus menentukan kolom yang ingin ditampilkan dalam responsnya. Tidak ada daftar default kolom yang ditampilkan. Jika Anda menghilangkan daftar ini, metode akan mengembalikan pesan {i>error<i}. 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 (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 Place Details (Baru),
Nearby Search (Baru), dan Text Search (Baru)
permintaan, string ini dimuat di 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 JSON
respons yang berisi informasi tentang ID tempat dan teruskan semua parameter sebagai URL
parameter. 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 tempat
nama resource. Sebagai respons dari Place Details
(Baru), Nearby Search (Baru), dan
Permintaan Text Search (Baru), string ini terdapat dalam
kolom name respons. ID tempat mandiri terdapat dalam
Kolom id respons.