Migrasi ke Foto Tempat (Baru)

Places API mendukung Place Photo yang sudah ada. Jika Anda sudah terbiasa dengan Foto Tempat yang sudah ada, Foto Tempat versi baru akan membuat perubahan berikut:

  • Layanan Place Photo yang baru mengharuskan Anda meneruskan nama resource foto, yang menyertakan ID tempat dalam URL permintaan, bukan hanya referensi foto. Untuk mengetahui informasi selengkapnya, lihat Mengubah ke referensi foto.
  • Layanan Place Photo yang baru mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.

Tabel berikut mencantumkan parameter di Place Photo yang ada yang telah diganti namanya atau diubah untuk Place Photo 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 diperbesar

Place Photo yang ada mendukung ukuran foto maksimum 1600x1600 piksel. Place Photo (Baru) mendukung ukuran hingga 4800x4800 piksel.

Ubah ke referensi foto

Place Photo API baru 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

Semua versi baru Nearby Search, Text Search, dan Place Details 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 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. Kolom ini selalu ada, tetapi mungkin kosong.

Dengan API yang ada, Anda hanya perlu meneruskan referensi foto, dalam formulir:

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

Find Place, Nearby Search, Text Search, dan Place Details yang ada 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 Photo.
  • height — Tinggi maksimum gambar.
  • width — Lebar maksimum gambar.
  • html_attributions[] — Atribusi apa pun yang diperlukan. Kolom ini selalu ada, tetapi mungkin kosong.