Places API mendukung Foto Tempat. Jika Anda familier dengan Place Photo yang ada, Place Photo versi baru membuat perubahan berikut:
- Layanan Place Photo baru mengharuskan Anda teruskan nama resource foto, yang menyertakan ID tempat di URL permintaan, alih-alih hanya referensi foto. Untuk informasi selengkapnya, lihat Ubah ke referensi foto.
- Layanan Place Photo yang baru mendukung Kunci API dan OAuth token sebagai mekanisme otentikasi.
Tabel berikut mencantumkan parameter yang ada Foto Tempat yang telah diganti namanya atau diubah untuk Foto Tempat baru, atau parameter yang tidak lagi didukung.
| Parameter saat ini | Parameter baru | Catatan |
|---|---|---|
maxheight |
maxHeightPx |
Anda harus menentukan maxHeightPx,
maxWidthPx, atau keduanya. |
maxwidth |
maxWidthPx |
Anda harus menentukan maxHeightPx,
maxWidthPx, atau keduanya. |
Ukuran foto ditingkatkan
Place Photo yang ada mendukung foto maksimum berukuran 1600 x 1600 piksel. Foto Tempat (Baru) mendukung ukuran hingga 4800 x 4800 piksel.
Ubah ke referensi foto
Yang baru Foto Tempat API mengharuskan Anda meneruskan nama resource dari foto yang diminta, yang menyertakan ID tempat dan referensi foto, dalam bentuk:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Versi baru Nearby Search,
Text Search, dan Place Details
semua menampilkan array photos[] dalam respons yang mendukung format ini. Masing-masing
elemen photos[] dalam respons baru berisi kolom berikut:
name— String yang berisi nama resource foto tersebut. String ini berbentuk:places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx— Tinggi maksimum gambar, dalam piksel.widthPx— Lebar maksimum gambar, dalam piksel.authorAttributions[]— Atribusi apa pun yang diperlukan. Ini akan selalu ada, namun mungkin kosong.
Dengan API yang ada, Anda hanya perlu meneruskan referensi foto, di bagian bentuk:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Find Place yang ada,
Nearby Search, Text Search, dan
Semua Place Details menampilkan array photos[] di
yang mendukung format ini. Setiap elemen photo dalam
berisi kolom-kolom berikut:
photo_reference— String yang digunakan untuk mengidentifikasi foto saat Anda melakukan permintaan Photo.height— Tinggi maksimum gambar.width— Lebar maksimum gambar.html_attributions[]— Atribusi apa pun yang diperlukan. Ini akan selalu ada, namun mungkin kosong.