Yerin Fotoğrafları

Platform seçin: Android iOS JavaScript Web Hizmeti

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

  • 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.

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:

Kotanın üzerinde resim

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