Yerin Fotoğrafları

Platform seçin: Android iOS JavaScript Web Hizmeti

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 and maxwidth properties accept an integer between 1 and 1600.

    You must specify either maxheight, or maxwidth, 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.

bölümün 5.4'te belirtilen önbelleğe alma kısıtlamalarına bakın.

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:

Kota Aşımı resmi

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 veya maxheight parametrelerini içermiyordu.
  • maxwidth veya maxheight parametresinin değeri null 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.