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 tersimpan dalam database Places. Jika Anda mengambil informasi tempat menggunakan permintaan Place Details, referensi foto akan ditampilkan untuk konten fotografi yang relevan. Permintaan Find Place, Nearby Search, dan Text Search juga akan menampilkan satu referensi foto per tempat, jika relevan. Dengan layanan Photo, Anda kemudian 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 dipisah menggunakan karakter ampersand (&
). 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
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, or both.
Referensi foto
Semua permintaan ke layanan Place Photo harus menyertakan photo_reference
,
yang ditampilkan sebagai respons atas permintaan Find Place, Nearby Search, Text Search, atau Place Details. Respons terhadap permintaan ini akan berisi kolom photos[]
jika tempat tersebut memiliki konten fotografi yang 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 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 Photo berasal dari berbagai lokasi,
termasuk foto dari pemilik bisnis dan pengguna. Umumnya, foto
ini dapat digunakan tanpa atribusi, atau harus menyertakan atribusi yang diperlukan
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 tersebut.
Contoh berikut menampilkan permintaan Place Details:
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
Contoh array photos[]
dalam respons ditunjukkan di bawah ini.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}
...
Contoh Place Photo
Contoh permintaan ditampilkan di bawah ini. Permintaan ini akan menampilkan gambar yang direferensikan, dengan 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 Photo
Respons permintaan Place Photo yang berhasil akan berupa gambar. Jenis gambar akan bergantung pada jenis foto awal yang dikirimkan.
Jika permintaan Anda melebihi kuota yang tersedia, server akan menampilkan status HTTP 403 dan menampilkan gambar di bawah ini untuk menunjukkan bahwa kuota telah terlampaui:
Jika server tidak dapat memahami permintaan Anda, server akan menampilkan status HTTP 400, yang menunjukkan permintaan yang tidak valid. Alasan paling umum permintaan tidak valid meliputi:
- Referensi foto yang dikirimkan tidak ditentukan dengan benar.
- Permintaan tidak menyertakan parameter
maxwidth
ataumaxheight
. - Nilai untuk parameter
maxwidth
ataumaxheight
ditetapkan kenull
. - Masa berlaku
photo_reference
telah berakhir. Jika masa berlakuphoto_reference
berakhir, buat permintaan ke Place Details, Find Place, Nearby Search, atau Text Search untuk mendapatkan nilaiphoto_reference
yang telah diperbarui.