Method: places.photos.getMedia

Mendapatkan media foto dengan string referensi foto.

Permintaan HTTP

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama resource media foto dalam format: places/{placeId}/photos/{photo_reference}/media.

Nama resource foto seperti yang ditampilkan di kolom photos.name objek Place memiliki format places/{placeId}/photos/{photo_reference}. Anda harus menambahkan /media di akhir resource foto untuk mendapatkan nama resource media foto.

Parameter kueri

Parameter
maxWidthPx

integer

Opsional. Menentukan lebar 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 diubah skalanya agar sesuai dengan dimensi yang lebih kecil, yang dibatasi oleh rasio aspek aslinya. Properti maxHeightPx dan maxWidthPx menerima bilangan bulat antara 1 dan 4800, inklusif. Jika nilai tidak berada dalam rentang yang diizinkan, error INVALID_ARGUMENT akan ditampilkan.

Setidaknya salah satu dari maxHeightPx atau maxWidthPx harus ditentukan. Jika maxHeightPx maupun maxWidthPx tidak ditentukan, error INVALID_ARGUMENT akan ditampilkan.
maxHeightPx

integer

Opsional. 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 diubah skalanya agar sesuai dengan dimensi yang lebih kecil, yang dibatasi oleh rasio aspek aslinya. Properti maxHeightPx dan maxWidthPx menerima bilangan bulat antara 1 dan 4800, inklusif. Jika nilai tidak berada dalam rentang yang diizinkan, error INVALID_ARGUMENT akan ditampilkan.

Setidaknya salah satu dari maxHeightPx atau maxWidthPx harus ditentukan. Jika maxHeightPx maupun maxWidthPx tidak ditentukan, error INVALID_ARGUMENT akan ditampilkan.
skipHttpRedirect

boolean

Opsional. Jika ditetapkan, lewati perilaku pengalihan HTTP default dan render respons format teks (misalnya, dalam format JSON untuk kasus penggunaan HTTP). Jika tidak ditetapkan, pengalihan HTTP akan dikeluarkan untuk mengalihkan panggilan ke media gambar. Opsi ini diabaikan untuk permintaan non-HTTP.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Media foto dari Places API.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "name": string,
  "photoUri": string
}
Kolom
name

string

Nama resource media foto dalam format: places/{placeId}/photos/{photo_reference}/media.
photoUri

string

URI berumur pendek yang dapat digunakan untuk merender foto.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/maps-platform.places.getphotomedia
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform