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 istenen 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 boyuttan daha küçük olana uyacak şekilde ölçeklendirilir. Hem maxHeightPx hem de maxWidthPx özellikleri, 1 ile 4.800 arasında (bu değerler 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 parametresinden en az biri belirtilmelidir. maxHeightPx veya maxWidthPx değeri belirtilmezse INVALID_ARGUMENT hatası döndürülür.

maxHeightPx

integer

İsteğe bağlı. Resmin istenen maksimum yüksekliğini piksel cinsinden 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 boyuttan daha küçük olana uyacak şekilde ölçeklendirilir. Hem maxHeightPx hem de maxWidthPx özellikleri, 1 ile 4.800 arasında (bu değerler dahil) bir tam sayı kabul eder. Değer izin verilen aralıkta değilse GEÇERSİZ_BAĞ_DEĞ_SAY hatası döndürülür.

maxHeightPx veya maxWidthPx parametresinden en az biri belirtilmelidir. maxHeightPx veya maxWidthPx değeri 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 (örneğin, 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.