Yer Fotoğrafları (eski)

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Places API'nin bir parçası olan Place Photos (Eski), uygulamanıza yüksek kaliteli fotoğraf içeriği eklemenize olanak tanıyan salt okunur bir API'dir. Place Photos (Eski), Places veritabanında depolanan milyonlarca fotoğrafa erişmenizi sağlar. Yer Ayrıntıları isteği kullanarak yer bilgisi aldığınızda, alakalı fotoğraf içerikleri için fotoğraf referansları döndürülür. Find Place (Eski), Yakında Arama (Eski) ve Metin Arama (Eski) istekleri de uygun olduğunda yer başına tek bir fotoğraf referansı döndürür. Place Photos (Eski) özelliğini kullanarak referans verilen fotoğraflara erişebilir ve resmi uygulamanız için en uygun boyuta yeniden boyutlandırabilirsiniz.

Place Photos (Eski) istekleri

Place Photos (Eski) isteği, aşağıdaki biçimde 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 standart olduğu gibi, tüm parametreler ve işareti (&) karakteri kullanılarak ayrılır. Parametrelerin listesi ve olası değerleri aşağıda sıralanmıştır.

Gerekli parametreler

  • photo_reference

    Bir fotoğrafı benzersiz şekilde tanımlayan dize tanımlayıcısı. Fotoğraf referansları, Yer Arama veya Yer Ayrıntıları isteğinden döndürülür.

  • maxheight veya maxwidth

    maxheight, resmin piksel cinsinden tercih edilen maksimum yüksekliğini belirtir. Resim, belirtilen değerlerden küçükse orijinal resim döndürülür. Resim, boyutlardan birinde daha büyükse iki boyuttan daha küçük olanla eşleşecek şekilde ölçeklendirilir ve orijinal en boy oranıyla sınırlandırılır.

    maxwidth, resmin piksel cinsinden tercih edilen maksimum genişliğini belirtir. Resim, belirtilen değerlerden küçükse orijinal resim döndürülür. Resim, boyutlardan birinde daha büyükse orijinal en boy oranıyla sınırlı olmak üzere iki boyutun daha küçük olanıyla eşleşecek şekilde ölçeklendirilir.

    Hem maxheight hem de maxwidth özellikleri, 1 ile 1600 arasında bir tam sayı kabul eder.

    maxheight veya maxwidth ya da her ikisini birden belirtmeniz gerekir.

Fotoğraf referansları

Place Photos (Eski) için gönderilen tüm istekler, Find Place (Eski), Yakında Arama (Eski), Text Search (Eski) veya Yer Ayrıntıları (Eski) isteğine verilen yanıtta döndürülen bir photo_reference içermelidir. Yerin ilgili fotoğraf içeriği varsa 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.

  • Bir Yer Bulma (Eski), Yakında Arama (Eski) veya Metin Arama (Eski) isteği, dizide en fazla bir photo öğesi döndürür.
  • Yer Ayrıntıları (Eski) isteği en fazla on photo öğesi döndürür.

Her photo öğesi aşağıdaki alanları içerir:

  • photo_reference: Place Photos (Eski) isteği gönderdiğinizde fotoğrafı tanımlamak için kullanılan dize.
  • 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 mevcut olur ancak boş olabilir.

Place Photos (Eski) tarafından döndürülen fotoğraflar, işletme sahipleri ve kullanıcıların katkıda bulunduğu fotoğraflar dahil olmak üzere çeşitli konumlardan alınır. Çoğu durumda bu fotoğraflar, atıf yapılmadan kullanılabilir veya gerekli atıf, resmin bir parçası olarak eklenir. 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 atıf eklemeniz gerekir.

Aşağıdaki örnekte bir Yer Ayrıntıları (Eski) isteği gösterilmektedir:

curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"

Yanıttaki photos[] dizisiyle ilgili bir örnek aşağıda gösterilmiştir.

    ...
    "photos" : [
       {
          "html_attributions" : [],
          "height" : 853,
          "width" : 1280,
          "photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
       }]
    ...

Place Photos (Legacy) örneği

Aşağıda örnek bir istek gösterilmektedir. Bu istek, referans verilen resmi en fazla 400 piksel genişliğinde olacak şekilde yeniden boyutlandırarak döndürür.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Place Photos (Eski) yanıtı

Başarılı bir Place Photos (Eski) isteğinin yanıtı bir resimdir. Resmin türü, başlangıçta gönderilen fotoğrafın türüne bağlıdır.

İsteğiniz mevcut 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 geçersiz bir isteği belirten HTTP 400 durumunu döndürür. Geçersiz isteklerin 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 ayarlandı.
  • photo_reference ödülünün süresi doldu. photo_reference süresi dolarsa güncellenmiş photo_reference değerini almak için Yer Ayrıntıları (Legacy), Find Place (Legacy), Yakında Arama (Legacy) veya Text Search (Legacy) isteği gönderin.