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 ortamının şu biçimindeki kaynak adı: places/{placeId}/photos/{photo_reference}/media.

Bir fotoğrafın, Yer nesnesinin photos.name alanında döndürülen 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 istenen maksimum genişliğini piksel cinsinden belirtir. Resim, belirtilen değerlerden küçükse orijinal resim döndürülür. Resim, iki boyuttan herhangi birinde daha büyükse orijinal en boy oranıyla sınırlı olmak üzere iki boyuttan daha küçük olanla eşleşecek şekilde ölçeklendirilir. Hem maxHeightPx hem de maxWidthPx özellikleri, 1 ile 4800 arasında (bu değerler dahil) bir tam sayıyı kabul eder. Değer, izin verilen aralıkta değilse bir GEÇERSİZ_BAĞ_DEĞER hatası döndürülür.

maxHeightPx veya maxWidthPx parametresinden en az biri belirtilmelidir. maxHeightPx ve 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, iki boyuttan herhangi birinde daha büyükse orijinal en boy oranıyla sınırlı olmak üzere iki boyuttan daha küçük olanla eşleşecek şekilde ölçeklendirilir. Hem maxHeightPx hem de maxWidthPx özellikleri, 1 ile 4800 arasında (bu değerler dahil) bir tam sayıyı kabul eder. Değer, izin verilen aralıkta değilse bir GEÇERSİZ_BAĞ_DEĞER hatası döndürülür.

maxHeightPx veya maxWidthPx parametresinden en az biri belirtilmelidir. maxHeightPx ve 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ı atlayın ve metin biçimi (örneğin, HTTP kullanım alanı için JSON biçiminde) yanıt oluşturun. Ayarlanmazsa çağrıyı resim medyasına yönlendirmek için bir HTTP yönlendirmesi yayınlanır. Bu seçenek, HTTP olmayan 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 ortamının şu biçimindeki kaynak adı: places/{placeId}/photos/{photo_reference}/media.
photoUri

string

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