Places API'nin bir parçası olan Yer Fotoğrafı hizmeti, uygulamanıza yüksek kaliteli fotoğrafik içerikler eklemenize olanak tanıyan salt okunur bir API'dir. Yer Fotoğrafı hizmeti, Yerler veritabanında saklanan milyonlarca fotoğrafa erişmenizi sağlar. Yer Ayrıntıları isteğini kullanarak yer bilgileri aldığınızda, alakalı fotoğraf içeriğine ait fotoğraf referansları döndürülür. Yer Bulma, Yakında Arama ve Metin Arama istekleri de alakalı olduğunda her yer için tek bir fotoğraf referansı döndürür. Fotoğraf hizmetini kullanarak referans verilen fotoğraflara erişebilir ve resmi uygulamanız için optimum boyuta ayarlayabilirsiniz.
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ğini başlatmak 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 belirtilmiş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ındaki Arama, Metin Arama veya Yer Ayrıntıları isteğine yanıt olarak döndürülen bir photo_reference
içermelidir. Yerle ilgili fotoğrafik içerik bulunuyorsa bu isteklere verilen yanıtta bir photos[]
alanı bulunur.
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, 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
: Fotoğraf isteği gerçekleştirdiğinizde fotoğrafı tanımlamak için kullanılan dizedir.height
— resmin maksimum yüksekliği.width
— resmin maksimum genişliği.html_attributions[]
: Gerekli ilişkilendirmeleri içerir. Bu alan her zaman mevcuttur, 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 alınır. Çoğu durumda, bu fotoğraflar atıf olmadan kullanılabilir veya gerekli atıf resmin 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ısı 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ğine verilen yanıt bir resim olacaktır. Resmin türü, başlangıçta 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österir:
Sunucu, isteğinizi anlayamazsa geçersiz isteği 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 belirtilmedi.
- İstek,
maxwidth
veyamaxheight
parametrelerini içermiyordu. maxwidth
veyamaxheight
parametresinin değerinull
olarak ayarlandı.photo_reference
için geçerlilik süresi doldu.photo_reference
alanının süresi dolarsa güncellenmişphoto_reference
değerini almak için Yer Ayrıntıları, Yer Bulma, Yakındakilerde Arama veya Metin Arama için istekte bulunun.