Yer Fotoğrafları (eski)

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

Yer Fotoğrafları (Eski) istekleri

Yer Fotoğrafları (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 (&) kullanılarak ayrılır. Parametrelerin listesi ve olası değerleri aşağıda sıralanmıştır.

Gerekli parametreler

• photo_reference

  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 maksimum tercih edilen yüksekliğini belirtir. Resim, belirtilen değerlerden küçükse orijinal resim döndürülür. Resim, boyutlardan herhangi birinde daha büyükse orijinal en boy oranı korunarak iki boyuttan daha küçüğüne uyacak şekilde ölçeklendirilir.

  maxwidth, resmin piksel cinsinden maksimum tercih edilen genişliğini belirtir. Resim, belirtilen değerlerden küçükse orijinal resim döndürülür. Resim, boyutlardan herhangi birinde daha büyükse orijinal en boy oranı korunarak iki boyuttan daha küçüğüyle eşleşecek şekilde ölçeklendirilir.

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

  maxheight, maxwidth veya her ikisini de belirtmeniz gerekir.

Fotoğraf referansları

Yer Fotoğrafları (Eski) ile ilgili tüm istekler, Find Place (Eski), Yakında Arama (Eski), Metin Arama (Eski) veya Yer Ayrıntıları (Eski) isteğine verilen yanıtta döndürülen bir photo_reference içermelidir. Bu isteklere verilen yanıtlarda, yerle ilgili fotoğraf içeriği varsa 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 Metinle 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: Yer Fotoğrafları (Eski) isteği gönderdiğ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 mevcut olur ancak boş olabilir.

Yer Fotoğrafları (Eski) tarafından döndürülen fotoğraflar, işletme sahipleri ve kullanıcı tarafından gönderilen fotoğraflar da dahil olmak üzere çeşitli konumlardan alınır. Çoğu durumda bu fotoğraflar, atıfta bulunulmadan 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 uygulamanızda her gösterdiğiniz yerde ek atıf bilgisi 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[] dizisinin bir örneği aşağıda gösterilmiştir.

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

Yer Fotoğrafları (Eski) örneği

Örnek bir istek aşağıda gösterilmektedir. Bu istek, referans verilen resmi döndürür ve genişliği en fazla 400 piksel 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ğrafları (Eski) yanıtı

Başarılı bir Yer Fotoğrafları (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, 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 anlayamıyorsa geçersiz bir isteği gösteren 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 ayarlandı.
• photo_reference kodunun süresi doldu. photo_reference süresi dolarsa güncellenmiş photo_reference değerini almak için Yer Ayrıntıları (Eski), Yer Bulma (Eski), Yakındaki Arama (Eski) veya Metin Arama (Eski)'ya istek gönderin.