Yerin Fotoğrafları

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Platform seçin: Android iOS JavaScript Web Hizmeti

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, ilgili fotoğraf içeriği için fotoğraf referansları döndürülür. Yer, Yakındaki Arama ve Metin Arama istekleri, alakalı olduğu durumlarda her yer için tek bir fotoğraf referansı döndürür. Ardından Fotoğraflar hizmetini kullanarak, başvurulan fotoğraflara erişebilir ve resmi, uygulamanız için en uygun boyutta yeniden boyutlandırabilirsiniz.

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ği başlatmak için bazı 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 Hizmeti'ne 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. İlgili isteğe ait fotoğraf içeriği varsa bu isteklere yanıt olarak bir photos[] alanı sunulur.

Not: Döndürülen fotoğrafların 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ği.
  • width: Resmin maksimum genişliği.
  • html_attributions[]: Gerekli tüm özellikleri içerir. Bu alan her zaman mevcut olur ancak boş olabilir.

Fotoğraf hizmeti tarafından döndürülen fotoğraflar, işletme sahipleri ve kullanıcıların eklediği fotoğraflar dahil olmak üzere çeşitli konumlardan elde edilir. Çoğu durumda, bu fotoğraflar atıf olmadan kullanılabilir veya gerekli atıfın resmin bir parçası olarak eklenmesi gerekir. 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 dahil etmeniz gerekir.

Bir photos[] dizisi örneği aşağıda gösterilmiş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ürecek ve en fazla 400 piksel genişliğinde olacak şekilde yeniden boyutlandırılacaktı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

Yerin Fotoğraf yanıtı

Başarılı bir Yer Fotoğrafı isteğinin yanıtı bir resim olur. 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örüntüler:

Aşırı Kota resmi

Sunucu isteğinizi anlayamıyorsa HTTP 400 durumunu döndürür. Bu durum geçersiz bir istek olduğunu gösterir. Geçersiz isteğin en yaygın nedenleri şunlardır:

  • Gönderilen fotoğraf referansı doğru belirtilmemiş.
  • İstek maxwidth veya maxheight parametrelerini içermiyordu.
  • maxwidth veya maxheight parametresinin değeri null olarak belirlendi.