Migrasi ke Foto Tempat (Baru)

Places API mendukung Place Photo (Lama). Jika Anda sudah terbiasa dengan Place Photo (Lama), Place Photo (Baru) akan melakukan perubahan berikut:

  • Place Photo (New) mengharuskan Anda meneruskan nama resource foto, yang menyertakan ID tempat di URL permintaan, bukan hanya referensi foto. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada referensi foto.
  • Place Photo (Baru) mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.

Tabel berikut mencantumkan parameter di Foto Tempat (Lama) 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 yang ditingkatkan

Foto Tempat (Lama) mendukung ukuran foto maksimum 1.600x1.600 piksel. Foto Tempat (Baru) mendukung ukuran hingga 4.800x4.800 piksel.

Mengubah ke referensi foto

Place Photo (Baru) API 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

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 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 (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 apa pun yang diperlukan. Kolom ini selalu ada, tetapi mungkin kosong.