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ğrafı hizmeti, Yerler veritabanında depolanan milyonlarca fotoğrafa erişim sağlar. Yer Ayrıntıları isteği kullanarak yer bilgileri aldığınızda, ilgili fotoğraf içeriği için fotoğraf referansları döndürülür. Yer Bulma, Yakında Arama ve Metin Arama istekleri, alakalı olduğunda yer başına tek bir fotoğraf referansı da döndürür. Ardından, Fotoğraflar 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 istekler, bir photo_reference içermelidir. Bu değer, Yer Bulma, Yakında Arama, Metin Arama veya Yer Ayrıntıları isteğinin yanıtında döndürülür. 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 Bulma, Yakındakileri Ara veya Metin Arama isteği, dizgede 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österdiğiniz her yerde ek ilişkilendirmeyi uygulamanıza eklemeniz gerekir.

Özgü Şartlar'ın 5.4 numaralı bölümünde belirtilen önbelleğe alma kısıtlamalarına bakın.

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ıtta photos[] dizisi örneği aşağıda gösterilmiştir.

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

Yer fotoğrafı örneği

Aşağıda bir istek örneği verilmiştir. 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ğ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 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ı, Yer Bul, Yakındakiler Araması veya Metin Araması'na istek gönderin.