Pengantar
Places API mendukung Place Photos (Lama). Jika Anda sudah familiar dengan Foto Tempat (Lama), Foto Tempat (Baru) melakukan perubahan berikut:
- Foto Tempat (Baru) mengharuskan Anda meneruskan nama resource foto, yang mencakup ID tempat dalam URL permintaan, bukan hanya referensi foto. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada referensi foto.
- Place Photos (Baru) mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.
Tabel berikut mencantumkan parameter di Place Photos (Lama) yang telah diganti namanya atau diubah untuk Place Photos (Baru), atau parameter yang tidak lagi didukung.
| Parameter saat ini | Parameter baru | Catatan |
|---|---|---|
maxheight |
maxHeightPx |
Anda harus menentukan salah satu dari maxHeightPx,
maxWidthPx, atau keduanya. |
maxwidth |
maxWidthPx |
Anda harus menentukan salah satu dari maxHeightPx,
maxWidthPx, atau keduanya. |
Ukuran foto yang lebih besar
Place Photos (Lama) mendukung ukuran foto maksimum 1600 x 1600 piksel. Foto yang ditempatkan (Baru) mendukung ukuran hingga 4800 x 4800 piksel.
Beralih ke referensi foto
API Place Photos (Baru) 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 (Baru),
Text Search (Baru), dan
Place Details (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 yang diperlukan. Kolom ini selalu ada, tetapi mungkin kosong.
Dengan API 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 (Lama),
Nearby Search (Lama),
Text Search (Lama), dan
Place Details (Lama) semuanya menampilkan array photos[] dalam
respons yang mendukung format ini. Setiap elemen photo dalam respons
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.