Foto Tempat

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
Pilih platform: Android iOS JavaScript Layanan Web

Layanan Place Photo, bagian dari Places API, adalah API hanya baca yang memungkinkan Anda menambahkan konten fotografi berkualitas tinggi ke aplikasi Anda. Layanan Place Photo memberi Anda akses ke jutaan foto yang disimpan dalam database Places. Saat Anda mendapatkan informasi tempat menggunakan permintaan Place Details, referensi foto akan ditampilkan untuk konten fotografi yang relevan. Permintaan Find Place, Nearby Search, dan Text Search juga menampilkan satu referensi foto per tempat, jika relevan. Dengan layanan Foto, Anda dapat mengakses foto yang direferensikan dan mengubah ukuran gambar ke ukuran yang optimal untuk aplikasi Anda.

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. Sebagaimana standar dalam URL, semua parameter dipisahkan menggunakan karakter ampersand (&). Daftar parameter dan kemungkinan nilainya dihitung 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.

Optional parameters

  • 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. Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

  • 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.

Generated from the OpenAPI specification. Edit Report bug

Referensi foto

Semua permintaan ke layanan Place Photo harus menyertakan photoreference, yang ditampilkan sebagai respons terhadap permintaan Find Place, Nearby Search, Text Search, atau Place Details. Respons terhadap permintaan ini akan berisi kolom photos[] jika tempat tersebut memiliki konten fotografi terkait.

Catatan: Jumlah foto yang ditampilkan bervariasi berdasarkan 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 akan berisi kolom berikut:

  • photo_reference — string yang digunakan untuk mengidentifikasi foto saat Anda membuat permintaan Foto.
  • 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 layanan Foto berasal dari berbagai lokasi, termasuk foto pemilik bisnis dan kontribusi pengguna. Umumnya, foto ini dapat digunakan tanpa atribusi, atau akan menyertakan atribusi yang diperlukan sebagai bagian dari gambar. Namun, jika elemen photo yang ditampilkan menyertakan nilai dalam kolom html_attributions, Anda harus menyertakan atribusi tambahan ke aplikasi di mana pun Anda menampilkan gambar.

Contoh array photos[] ditampilkan di bawah ini.

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

Contoh Place Photo

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

https://maps.googleapis.com/maps/api/place/photo
  ?maxwidth=400
  &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT
  &key=YOUR_API_KEY

Respons Place Photo

Respons permintaan Place Photo yang berhasil akan berupa gambar. Jenis gambar akan bergantung pada jenis foto yang pertama kali 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 tidak dapat memahami permintaan Anda, server akan menampilkan status HTTP 400, yang menunjukkan permintaan yang tidak valid. Alasan paling umum untuk permintaan yang 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.