Yer Fotoğrafları (eski)

Avrupa Ekonomik Alanı (AEA) geliştiricileri

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.

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ğrafları (Eski) ile ilgili tüm istekler, bir photo_reference içermelidir. Bu, Yer Bulma (Eski), Yakınlarda Arama (Eski), Metin Arama (Eski) veya Yer Ayrıntıları (Eski) isteğine verilen yanıtta döndürülür. 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ındaki 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: 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 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[] dizisinin bir örneği aşağıda gösterilmiştir.

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

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

Örnek bir istek aşağıda gösterilmiştir. 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:

Kota aşımı resmi

Sunucu isteğinizi anlayamazsa 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.