Yerler API'sinin bir parçası olan Yer Fotoğrafı 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 bilgileri aldığınızda, alakalı 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 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 formun 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 bir photo_reference
içermelidir. Bu istekler Yer Bulma, Yakındaki Arama, Metin Arama veya Yer Ayrıntıları isteğine yanıt olarak döndürülür. Söz konusu yerle ilgili fotoğrafik içerikler varsa bu isteklere verilen yanıtta bir photos[]
alanı bulunur.
Not: İade edilen 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
: Bir Fotoğraf isteği gerçekleştirdiğinizde fotoğrafı tanımlamak için kullanılan bir dizedir.height
- resmin maksimum yüksekliği.width
: Resmin maksimum genişliği.html_attributions[]
: Gerekli tüm atıfları içerir. Bu alan her zaman mevcuttur ancak boş olabilir.
Fotoğraflar 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 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ı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ğraflı 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 bölümünden istekte bulunun.