Yer Fotoğrafları (eski)

Places API'nin bir parçası olan Yer Fotoğrafları (eski), uygulamanıza yüksek kaliteli fotoğraf içerikleri eklemenize olanak tanıyan salt okuma API'sidir. Yer Fotoğrafları (eski), Yerler veritabanında depolanan milyonlarca fotoğrafa erişmenizi sağlar. Yer Ayrıntıları isteği kullanarak yer bilgileri aldığınızda, alakalı 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, uygun olduğunda yer başına tek bir fotoğraf referansı da döndürür. Fotoğraf Yerleştir (eski) özelliğini kullanarak referans verilen fotoğraflara erişebilir ve resmi uygulamanız için en uygun boyuta yeniden boyutlandırabilirsiniz.

Yer Fotoğrafları (eski) istekleri

Yer Fotoğrafları (eski) isteği, aşağıdaki biçime sahip 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 olarak olduğu gibi, tüm parametreler "ve" işareti (&) karakteri kullanılarak ayrılır. Parametrelerin 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.

  • 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, Yer Bulma (eski), Yakındakiler Arama (eski), Metin Arama (eski) veya Yer Ayrıntıları (eski) isteğinin yanıtında döndürülen bir photo_reference içermelidir. Bu isteklerin yanıtında, yerle ilgili fotoğraf içerikleri varsa bir photos[] alanı bulunur.

Not: Döndürülen fotoğraf sayısı isteğe göre değişir.

  • Yer Bul (eski), Yakındakileri Ara (eski) veya Metin Ara (eski) isteği, dizede 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: Fotoğraf Yerleşim (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 tüm atıfları içerir. Bu alan her zaman mevcuttur ancak boş olabilir.

Yer Fotoğrafları (eski) tarafından döndürülen fotoğraflar, işletme sahipleri ve kullanıcı tarafından eklenen fotoğraflar da dahil olmak üzere çeşitli kaynaklardan alınır. Çoğu durumda bu fotoğraflar ilişkilendirme olmadan kullanılabilir veya gerekli ilişkilendirme, resmin bir parçası olarak eklenir. Ancak, döndürülen photo öğesinde html_attributions alanında bir değer varsa resmi gösterdiğiniz her yerde ek ilişkilendirmeyi uygulamanıza eklemeniz gerekir.

Aşağıdaki örnekte 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[] dizisine örnek aşağıda verilmiştir.

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

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

Aşağıda örnek bir istek gösterilmektedir. Bu istek, referans verilen resmi döndürür ve en fazla 400 piksel genişliğinde 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ı

Yer Fotoğrafları (eski) isteği başarıyla tamamlandığında yanıt bir resimdir. Resmin türü, ilk gönderilen fotoğrafın türüne bağlıdır.

İsteğiniz mevcut kotanızı aşıyorsa 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 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 kodunun süresi doldu. photo_reference'nin süresi dolarsa güncellenmiş photo_reference değerini almak için Yer Ayrıntıları (Eski), Yer Bul (Eski), Yakındakiler Arama (Eski) veya Metin Arama (Eski)'ya istek gönderin.