Place API'nin bir parçası olan Place Photo hizmeti, uygulamanıza yüksek kaliteli fotoğraf içeriği eklemenize olanak tanıyan salt okunur bir API'dır. Yer Fotoğrafı hizmeti, Yerler veritabanında depolanan milyonlarca fotoğrafa erişmenizi sağlar. Yer Ayrıntıları isteğini kullanarak yer bilgileri aldığınızda, alakalı fotoğraf içeriği için fotoğraf referansları döndürülür. Yer Bulma, Yakın Arama ve Metin Arama istekleri aynı zamanda, ilgili her yerde tek bir fotoğraf referansı döndürür. Ardından, Fotoğraflar hizmetini kullanarak referans verilen fotoğraflara erişebilir ve resmi, uygulamanız için en uygun boyutta yeniden boyutlandırabilirsiniz.
Yer Fotoğrafı isteği
Yer Fotoğrafı isteği aşağıdaki biçimdeki bir HTTP URL'sidir:
https://maps.googleapis.com/maps/api/place/photo?parameters
Arama isteği başlatmak için belirli parametreler gereklidir. URL'lerde olduğu gibi, tüm parametreler "ve" (&
) karakteri kullanılarak ayrılır. Parametre listesi ve olası değerleri aşağıda verilmiştir.
Required parameters
photo_reference
A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.
Optional parameters
maxheight
Specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio. Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.maxwidth
Specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio. Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.
Generated from the OpenAPI specification. Edit Report bug
Fotoğraf referansları
Yer Fotoğrafı hizmetine yapılan tüm istekler bir Yer Bulma, Yakındaki Arama, Metin Arama veya Yer Ayrıntıları isteğine yanıt olarak döndürülen bir photoreference
içermelidir. Yerin ilgili fotoğraf içeriği varsa bu isteklere verilen yanıt bir photos[]
alanı içerir.
Not: Döndürülen fotoğraf sayısı isteğe göre değişir.
- Yer Bulma, Yakında Arama veya Metin Arama isteği dizideki en fazla bir
photo
öğesini döndürür. - Yer Ayrıntıları isteği en fazla on
photo
öğesi döndürür.
Her photo
öğesi aşağıdaki alanları içerir:
photo_reference
: Fotoğraf isteği gerçekleştirdiğinizde fotoğrafı tanımlamak için kullanılan bir dizedir.height
: Resmin maksimum yüksekliğidir.width
: Resmin maksimum genişliği.html_attributions[]
: Gerekli özellikleri içerir. Bu alan her zaman mevcut olur ancak boş olabilir.
Fotoğraf hizmeti tarafından döndürülen fotoğraflar çeşitli işletme kaynaklarından gelir (işletme sahipleri ve kullanıcıların katkıda bulunduğu fotoğraflar gibi). Çoğu durumda bu fotoğraflar ilişkilendirme olmadan kullanılabilir veya gerekli ilişkilendirmeyi resmin bir parçası olarak içerir. Ancak, döndürülen photo
öğesi html_attributions
alanında bir değer içeriyorsa resmi gösterdiğiniz her yerde uygulamanıza ek ilişkilendirmeyi eklemeniz gerekir.
Aşağıda photos[]
dizisi örneği verilmiştir.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
}
...
Yer Fotoğrafı örneği
Aşağıda örnek bir istek gösterilmektedir. Bu istek, başvurulan resmi döndürerek en fazla 400 piksel genişliğinde olması için yeniden boyutlandırır.
https://maps.googleapis.com/maps/api/place/photo ?maxwidth=400 &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT &key=YOUR_API_KEY
Yer Fotoğrafı yanıtı
Başarılı bir Yer Fotoğrafı isteğinin yanıtı bir resim olacaktır. Resmin türü, ilk gönderilen fotoğrafın türüne bağlıdır.
İsteğiniz kullanılabilir kotanızı aşarsa sunucu bir HTTP 403 durumu döndürür ve kotanın aşıldığını belirtmek için aşağıdaki resmi görüntüler:
Sunucu isteğinizi anlayamazsa geçersiz bir istek olduğunu belirten HTTP 400 durumunu döndürür. Geçersiz isteğin en yaygın nedenleri şunlardır:
- Gönderilen fotoğraf referansı doğru şekilde belirtilmemiş.
- İstek
maxwidth
veyamaxheight
parametrelerini içermiyordu. maxwidth
veyamaxheight
parametresinin değerinull
olarak belirlendi.