Place Photos

Pilih platform: Android iOS JavaScript Layanan Web

Layanan Place Photo, yang merupakan bagian dari Places API, adalah yang memungkinkan Anda menambahkan konten fotografi berkualitas tinggi ke aplikasi. Layanan Place Photo memberi Anda akses ke jutaan foto yang tersimpan di database Places. Saat Anda mendapatkan informasi tempat menggunakan Tempat Permintaan detail, referensi foto akan dikembalikan untuk keperluan fotografi terkait saat ini. Permintaan Find Place, Nearby Search, dan Text Search juga akan menampilkan satu foto di setiap tempat, jika relevan. Menggunakan layanan Photo yang kemudian Anda dapat akses foto yang direferensikan dan mengubah ukuran gambar ke ukuran yang optimal untuk aplikasi.

Permintaan Place Photo

Permintaan Place Photo 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 di URL, semua parameter dipisah menggunakan karakter ampersand (&). Tujuan daftar parameter dan kemungkinan nilainya disebutkan di bawah ini.

Required parameters

  • photo_reference

    A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.

  • maxheight or maxwidth

    maxheight specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    maxwidth specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

    You must specify either maxheight, or maxwidth, or both.

Referensi foto

Semua permintaan ke layanan Place Photo harus menyertakan photo_reference, yang ditampilkan sebagai respons terhadap Find Place, Nearby Search, Text Search, atau Place Details permintaan. Respons atas 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, Nearby Search, atau Text Search menampilkan maksimal satu elemen photo dalam array.
  • Permintaan Place Details menampilkan hingga sepuluh elemen photo.

Setiap elemen photo 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[] — berisi atribusi yang diperlukan. Ini bidang akan selalu ada, namun mungkin kosong.

Foto yang dikembalikan oleh layanan Foto berasal dari berbagai lokasi, termasuk foto kontribusi pengguna dan pemilik bisnis. Dalam kebanyakan kasus, foto dapat digunakan tanpa atribusi, atau akan memiliki atribusi yang diperlukan disertakan sebagai bagian dari gambar. Namun, jika elemen photo yang ditampilkan menyertakan nilai di kolom html_attributions, Anda harus menyertakan atribusi tambahan pada aplikasi di mana pun Anda menampilkan gambar.

Contoh berikut menunjukkan permintaan Place Details:

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

Contoh array photos[] dalam respons ditampilkan di bawah ini.

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

Contoh Foto Tempat

Contoh permintaan ditampilkan di bawah ini. Permintaan ini akan menampilkan gambar, mengubah ukurannya sehingga lebarnya maksimum 400 piksel.

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

Respons Place Photo

Respons permintaan Place Photo yang berhasil akan berupa gambar. Jenis gambar akan tergantung pada jenis foto asli yang dikirim.

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

Gambar Melebihi Kuota

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

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