Place Photos (Lama)

Developer Wilayah Ekonomi Eropa (EEA)

Place Photos (Legacy), bagian dari Places API, adalah API hanya baca yang memungkinkan Anda menambahkan konten fotografi berkualitas tinggi ke aplikasi Anda. Place Photos (Lama) memberi Anda akses ke jutaan foto yang disimpan dalam database Places. Jika Anda mengambil informasi tempat menggunakan permintaan Place Details, referensi foto akan ditampilkan untuk materi fotografi yang relevan. Permintaan Find Place (Lama), Nearby Search (Lama), dan Text Search (Lama) juga menampilkan satu referensi foto per tempat, jika relevan. Dengan Place Photos (Legacy), Anda kemudian dapat mengakses foto yang direferensikan dan mengubah ukuran gambar ke ukuran yang optimal untuk aplikasi Anda.

Permintaan Place Photos (Lama)

Permintaan Foto Tempat (Lama) adalah URL HTTP dengan bentuk berikut:

https://maps.googleapis.com/maps/api/place/photo?parameters

Diperlukan parameter tertentu untuk memulai permintaan penelusuran. Sesuai dengan standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&). Daftar parameter dan kemungkinan nilainya tercantum di bawah.

Parameter yang diperlukan

  • photo_reference

    ID string yang secara unik mengidentifikasi foto. Referensi foto ditampilkan dari permintaan Place Search atau Place Details.

  • maxheight atau maxwidth

    maxheight menentukan tinggi maksimum yang diinginkan, dalam piksel, dari gambar. Jika gambar lebih kecil dari nilai yang ditentukan, gambar asli akan ditampilkan. Jika gambar lebih besar dalam salah satu dimensi, gambar akan diskalakan agar sesuai dengan dimensi yang lebih kecil, dengan rasio aspek aslinya.

    maxwidth menentukan lebar pilihan maksimum gambar, dalam piksel. Jika gambar lebih kecil dari nilai yang ditentukan, gambar asli akan ditampilkan. Jika gambar lebih besar dalam salah satu dimensi, gambar akan diskalakan agar sesuai dengan dimensi yang lebih kecil, dengan dibatasi pada rasio aspek aslinya.

    Properti maxheight dan maxwidth menerima bilangan bulat antara 1 dan 1600.

    Anda harus menentukan salah satu dari maxheight, atau maxwidth, atau keduanya.

Referensi foto

Semua permintaan ke Place Photos (Lama) harus menyertakan photo_reference, yang ditampilkan dalam respons terhadap permintaan Find Place (Lama), Nearby Search (Lama), Text Search (Lama), atau Place Details (Lama). Respons terhadap permintaan ini akan berisi kolom photos[] jika tempat tersebut memiliki konten fotografi terkait.

Catatan: Jumlah foto yang ditampilkan akan bervariasi menurut permintaan.

  • Permintaan Find Place (Lama), Nearby Search (Lama), atau Text Search (Lama) menampilkan maksimal satu elemen photo dalam array.
  • Permintaan Place Details (Legacy) menampilkan hingga sepuluh elemen photo.

Setiap elemen photo berisi kolom berikut:

  • photo_reference — string yang digunakan untuk mengidentifikasi foto saat Anda melakukan permintaan Place Photos (Lama).
  • height — tinggi maksimum gambar.
  • width — lebar maksimum gambar.
  • html_attributions[] — berisi atribusi yang diperlukan. Kolom ini akan selalu ada, tetapi mungkin kosong.

Foto yang ditampilkan oleh Place Photos (Lama) berasal dari berbagai lokasi, termasuk foto dari pemilik bisnis dan pengguna. Umumnya, foto ini dapat digunakan tanpa atribusi, atau atribusi yang diperlukan akan disertakan sebagai bagian dari gambar. Namun, jika elemen photo yang ditampilkan menyertakan nilai di kolom html_attributions, Anda harus menyertakan atribusi tambahan dalam aplikasi di mana pun Anda menampilkan gambar.

Contoh berikut menunjukkan permintaan Place Details (Legacy):

curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"

Contoh array photos[] dalam respons ditampilkan di bawah.

    ...
    "photos" : [
       {
          "html_attributions" : [],
          "height" : 853,
          "width" : 1280,
          "photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
       }]
    ...

Contoh Place Photos (Lama)

Contoh permintaan ditampilkan di bawah ini. Permintaan ini menampilkan gambar yang dirujuk, mengubah ukurannya sehingga lebarnya maksimal 400 piksel.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Respons Place Photos (Lama)

Respons permintaan Place Photos (Legacy) yang berhasil adalah gambar. Jenis gambar bergantung pada jenis foto yang awalnya dikirimkan.

Jika permintaan Anda melebihi kuota yang tersedia, server akan menampilkan status HTTP 403 dan menampilkan gambar di bawah untuk menunjukkan bahwa kuota telah terlampaui:

Gambar Melebihi Kuota

Jika server tidak dapat memahami permintaan Anda, server akan menampilkan status HTTP 400, yang menunjukkan permintaan tidak valid. Alasan paling umum permintaan tidak valid meliputi:

  • Referensi foto yang dikirimkan tidak ditentukan dengan benar.
  • Permintaan tidak menyertakan parameter maxwidth atau maxheight.
  • Nilai untuk parameter maxwidth atau maxheight ditetapkan ke null.
  • Masa berlaku photo_reference telah berakhir. Jika photo_reference habis masa berlakunya, buat permintaan ke Place Details (Lama), Find Place (Lama), Nearby Search (Lama), atau Text Search (Lama) untuk mendapatkan nilai photo_reference yang diperbarui.