Places API mendukung Foto Tempat yang ada. Jika Anda sudah terbiasa dengan Foto Tempat yang ada, Foto Tempat versi baru akan melakukan perubahan berikut:
- Layanan Foto Tempat baru mengharuskan Anda meneruskan nama resource foto, yang menyertakan ID tempat di URL permintaan, bukan hanya referensi foto. Untuk informasi selengkapnya, lihat Perubahan pada referensi foto.
- Layanan Foto Tempat baru mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.
Tabel berikut mencantumkan parameter di Foto Tempat yang ada 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. |
Peningkatan ukuran foto
Foto Tempat yang ada mendukung ukuran foto maksimum 1.600x1.600 piksel. Tempatkan Foto (Baru) mendukung ukuran hingga 4.800x4.800 piksel.
Mengubah ke referensi foto
API Foto Tempat baru mengharuskan Anda meneruskan nama resource 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
Penelusuran Langsung, Penelusuran Teks, dan Place Details versi baru semuanya menampilkan array photos[] dalam respons yang mendukung format ini. Setiap elemen photos[] dalam respons baru berisi kolom berikut:
name— String yang berisi nama resource foto. String ini dalam bentuk:places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx— Tinggi maksimum gambar, dalam piksel.widthPx— Lebar maksimum gambar, dalam piksel.authorAttributions[]— Atribusi apa pun yang diperlukan. Kolom ini selalu ada, tetapi mungkin kosong.
Dengan API yang ada, Anda hanya perlu meneruskan referensi foto, dalam bentuk:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Find Place, penelusuran Langsung, Penelusuran Teks, dan Place Details yang ada semuanya menampilkan array photos[] dalam respons yang mendukung format ini. Setiap elemen photo dalam respons yang ada berisi kolom berikut:
photo_reference— String yang digunakan untuk mengidentifikasi foto saat Anda melakukan permintaan Foto.height— Tinggi maksimum gambar.width— Lebar maksimum gambar.html_attributions[]— Atribusi apa pun yang diperlukan. Kolom ini selalu ada, tetapi mungkin kosong.