Places API mendukung Place Details. Jika Anda sudah terbiasa dengan Places API, Place Details versi baru membuat perubahan berikut:
- Penyamaran kolom wajib diisi. Anda harus menentukan kolom yang ingin ditampilkan dalam responsnya. Tidak ada daftar default untuk kolom yang ditampilkan. Jika Anda menghilangkan daftar ini, metode akan mengembalikan pesan {i>error<i}. Untuk informasi selengkapnya, lihat FieldMask.
- Place Details yang baru mendukung Kunci API dan OAuth token sebagai mekanisme otentikasi.
- Hanya JSON yang didukung sebagai format respons dalam Detail Tempat.
- 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 yang ada Detail Tempat yang telah diubah 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 pada respons. |
language |
languageCode |
|
region |
regionCode |
Contoh permintaan
Contoh permintaan GET berikut menggunakan
Detail Tempat. 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 responsnya 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. Ini juga menggunakan mask kolom sehingga respons hanya menyertakan nama tampilan dan memiliki format alamat 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 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.