Pengantar
Places API mendukung Place Photos (Versi Lama). Jika Anda sudah memahami Place Photos (Versi Lama), Place Photos (Versi Baru) akan melakukan perubahan berikut:
- Place Photos (Versi Baru) mengharuskan Anda meneruskan nama resource foto, yang mencakup ID tempat di URL permintaan, bukan hanya referensi foto. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada referensi foto.
- Place Photos (Versi Baru) mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.
Tabel berikut mencantumkan parameter di Place Photos (Versi Lama) yang telah diganti namanya atau diubah untuk Place Photos (Versi 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 yang ditingkatkan
Place Photos (Versi Lama) mendukung ukuran foto maksimum 1600 x 1600 piksel. Place Photos (Versi Baru) mendukung ukuran hingga 4800 x 4800 piksel.
Perubahan pada referensi foto
Place Photos (Versi Baru) API mengharuskan Anda meneruskan nama resource foto yang diminta, yang mencakup ID tempat dan referensi foto, dalam bentuk:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Nearby Search (Versi Baru), Text Search (Versi Baru), dan Place Details (Versi Baru) 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 yang diperlukan. Kolom ini selalu ada, tetapi mungkin kosong.
Dengan API versi lama, 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 (Versi Lama), Nearby Search (Versi Lama), Text Search (Versi Lama), dan Place Details (Versi Lama) menampilkan array photos[] dalam respons yang mendukung format ini. Setiap elemen photo dalam respons versi lama 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 yang diperlukan. Kolom ini selalu ada, tetapi mungkin kosong.