Method: places.photos.getMedia

Fotoğraf referans dizesi içeren bir fotoğraf medyası alın.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Zorunlu. Fotoğraf medyasının kaynak adı. places/{placeId}/photos/{photo_reference}/media biçimindedir.

Bir yer nesnesinin photos.name alanında döndürülen fotoğrafın kaynak adı, places/{placeId}/photos/{photo_reference} biçimindedir. Fotoğraf medya kaynağı adını almak için fotoğraf kaynağının sonuna /media eklemeniz gerekir.

Sorgu parametreleri

Parametreler
maxWidthPx

integer

İsteğe bağlı. Resmin piksel cinsinden istenilen maksimum genişliğini belirtir. Resim belirtilen değerlerden küçükse orijinal resim döndürülür. Resim herhangi bir boyutta daha büyükse orijinal en boy oranıyla kısıtlanarak iki boyutun daha küçük olanıyla eşleşecek şekilde ölçeklendirilir. Hem maxHeightPx hem de maxWidthPx özellikleri, 1 ile 4.800 arasında (ikisi de dahil) bir tam sayı kabul eder. Değer izin verilen aralık içinde değilse INVALID_ARGUMENT hatası döndürülür.

maxHeightPx veya maxWidthPx'den en az biri belirtilmelidir. maxHeightPx veya maxWidthPx belirtilmezse INVALID_ARGUMENT hatası döndürülür.
maxHeightPx

integer

İsteğe bağlı. Resmin piksel cinsinden istenilen maksimum yüksekliğini belirtir. Resim belirtilen değerlerden küçükse orijinal resim döndürülür. Resim herhangi bir boyutta daha büyükse orijinal en boy oranıyla kısıtlanarak iki boyutun daha küçük olanıyla eşleşecek şekilde ölçeklendirilir. Hem maxHeightPx hem de maxWidthPx özellikleri, 1 ile 4.800 arasında (ikisi de dahil) bir tam sayı kabul eder. Değer izin verilen aralık içinde değilse INVALID_ARGUMENT hatası döndürülür.

maxHeightPx veya maxWidthPx'den en az biri belirtilmelidir. maxHeightPx veya maxWidthPx belirtilmezse INVALID_ARGUMENT hatası döndürülür.
skipHttpRedirect

boolean

İsteğe bağlı. Ayarlanırsa varsayılan HTTP yönlendirme davranışını atlar ve metin biçiminde (ör. HTTP kullanım alanı için JSON biçiminde) bir yanıt oluşturur. Ayarlanmazsa çağrıyı resim medyasına yönlendirmek için bir HTTP yönlendirmesi gönderilir. Bu seçenek, HTTP dışı istekler için yoksayılır.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Places API'den bir fotoğraf medyası.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "name": string,
  "photoUri": string
}
Alanlar
name

string

Fotoğraf medyasının kaynak adı. places/{placeId}/photos/{photo_reference}/media biçimindedir.
photoUri

string

Fotoğrafı oluşturmak için kullanılabilecek kısa ömürlü bir uri.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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