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ı şu biçimdedir: places/{placeId}/photos/{photo_reference}/media.

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, boyutlardan herhangi birinde daha büyükse orijinal en boy oranı korunarak 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ı kabul eder. Değer izin verilen aralıkta değilse INVALID_ARGUMENT hatası döndürülür.

maxHeightPx veya maxWidthPx özelliklerinden en az biri belirtilmelidir. Ne maxHeightPx ne de maxWidthPx belirtilirse INVALID_ARGUMENT hatası döndürülür.
maxHeightPx

integer

İsteğe bağlı. Resmin piksel cinsinden istenen maksimum yüksekliğini belirtir. Resim, belirtilen değerlerden küçükse orijinal resim döndürülür. Resim, boyutlardan herhangi birinde daha büyükse orijinal en boy oranı korunarak 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ı kabul eder. Değer izin verilen aralıkta değilse INVALID_ARGUMENT hatası döndürülür.

maxHeightPx veya maxWidthPx özelliklerinden en az biri belirtilmelidir. Ne maxHeightPx ne de maxWidthPx belirtilirse 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 bir metin biçimi (örneğin, HTTP kullanım alanı için JSON biçiminde) yanıtı oluşturun. Ayarlanmamışsa çağrıyı resim medyasına yönlendirmek için bir HTTP yönlendirmesi verilir. Bu seçenek, HTTP dışı istekler için yoksayılır.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Places API'den alınan 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ı şu biçimdedir: places/{placeId}/photos/{photo_reference}/media.
photoUri

string

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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