Yerin Fotoğrafları

Platform seçin: Android iOS JavaScript Web Hizmeti

Places API'nin bir parçası olan Yer Fotoğrafı hizmeti, uygulamanıza yüksek kaliteli fotoğraf içerikleri eklemenize olanak tanıyan salt okuma API'sidir. Yer Fotoğrafları hizmeti, 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, Yakındaki Yerler Arama ve Metin Arama istekleri, uygun olduğunda yer başına tek bir fotoğraf referansı da döndürür. Ardından, Fotoğraf hizmetini kullanarak referans verilen fotoğraflara erişebilir ve resmi uygulamanız için en uygun boyuta yeniden boyutlandırabilirsiniz.

Yer fotoğrafı istekleri

Yer fotoğrafı 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ı hizmetine yapılan tüm isteklerde, yer bulma, yakında arama, metin arama veya yer ayrıntıları isteğinin yanıtında döndürülen bir photo_reference bulunmalıdır. Yerle ilgili fotoğraf içerikleri varsa bu isteklerin yanıtında bir photos[] alanı bulunur.

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

  • Yer Bulma, Yakında Arama veya Metin Arama isteği, diziye en fazla bir photo öğesi 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 gönderdiğ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 ilişkilendirmeleri içerir. Bu alan her zaman mevcuttur ancak boş olabilir.

Fotoğraf hizmeti tarafından döndürülen fotoğraflar, işletme sahipleri ve kullanıcılar 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örüntülediğiniz her yerde uygulamanıza ek ilişkilendirmeyi eklemeniz gerekir.

Aşağıdaki örnekte bir Yer Ayrıntıları 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"
   }
...

Yer fotoğrafı ö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

Yer fotoğrafı yanıtı

Başarılı bir yer fotoğrafı isteğinin 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ı, Yer Bul, Yakındakiler Ara veya Metin Ara işlevlerine istek gönderin.