Places 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'dir. Yer Fotoğrafı hizmeti, Yerler veritabanında depolanan milyonlarca fotoğrafa erişmenizi sağlar. Yer Ayrıntıları isteğini kullanarak yer bilgilerini aldığınızda, ilgili fotoğraf içeriği için fotoğraf referansları döndürülür. Yer Bulma, Yakında Arama ve Metin Arama istekleri de alakalı olduğunda yer başına tek bir fotoğraf referansı döndürür. Daha sonra, Fotoğraf hizmetini kullanarak referans verilen fotoğraflara erişebilir ve resmi, uygulamanız için optimum boyutu elde edecek şekilde yeniden boyutlandırabilirsiniz.
Yer Fotoğrafı istekleri
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ğinde bulunmak için belirli parametreler gerekir. URL'lerde standart olduğu gibi, tüm parametreler "ve" (&
) karakteri kullanılarak ayrılır. Parametre listesi ve olası değerleri aşağıda listelenmiş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.
maxheight or maxwidth
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.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
.You must specify either
maxheight
, ormaxwidth
, or both.
Fotoğraf referansları
Yer Fotoğrafı hizmetine yapılan tüm istekler Yer Bulma, Yakında Arama, Metin Arama veya Yer Ayrıntıları isteğine yanıt olarak döndürülen bir photo_reference
içermelidir. Yerde alakalı fotoğraf içeriği varsa bu isteklere verilen yanıtta bir photos[]
alanı bulunur.
Not: Döndürülen fotoğrafların sayısı isteğe bağlı olarak değişir.
- Yer Bulma, Yakında Arama veya Metin Arama isteği, dizide en fazla bir
photo
öğesi 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
— bir Fotoğraf isteği gerçekleştirdiğinizde fotoğrafı tanımlamak için kullanılan bir dize.height
: Resmin maksimum yüksekliği.width
- resmin maksimum genişliği.html_attributions[]
: Gerekli atıfları içerir. Bu alan her zaman bulunur ancak boş olabilir.
Fotoğraf hizmeti tarafından döndürülen fotoğraflar, işletme sahipleri ve kullanıcıların katkıda bulunduğu fotoğraflar da dahil olmak üzere çeşitli konumlardan elde edilir. Çoğu durumda, bu fotoğraflar atıf olmadan kullanılabilir veya gerekli atıf resmin bir parçası olarak dahil edilir. Bununla birlikte, döndürülen photo
öğesi html_attributions
alanında bir değer içeriyorsa resmi görüntülediğiniz her yerde ek ilişkilendirmeyi uygulamanıza eklemeniz gerekir.
Aşağıdaki örnekte bir Yer Ayrıntıları isteği gösterilmektedir:
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
Yanıttaki photos[]
dizisi örneği aşağıda gösterilmiştir.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}
...
Yer Fotoğrafı örneği
Aşağıda örnek bir istek gösterilmektedir. Bu istek, referans verilen resmi döndürerek en fazla 400 piksel genişliğinde olacak şekilde yeniden boyutlandırır.
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &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ü, gönderilen orijinal 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österir:
Sunucu isteğinizi anlayamazsa HTTP 400 durumunu döndürür. Bu durum, geçersiz istek olduğunu gösterir. Geçersiz isteklerin en yaygın nedenleri şunlardır:
- Gönderilen fotoğraf referansı doğru belirtilmedi.
- İstek,
maxwidth
veyamaxheight
parametrelerini içermiyordu. maxwidth
veyamaxheight
parametresinin değerinull
olarak ayarlandı.photo_reference
ödülünün süresi doldu.photo_reference
öğesinin süresi dolarsa güncellenmişphoto_reference
değerini almak için Yer Ayrıntıları, Yer Bulma, Yakındaki Arama veya Metin Arama isteğinde bulunun.