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çeriği eklemenize olanak tanıyan API'dan kabul edersiniz. Yer Fotoğrafı hizmeti, milyonlarca fotoğrafa erişebilmenizi sağlar Rehber veritabanında saklanır. Bir Yeri kullanarak yer bilgilerini aldığınızda Ayrıntı isteği, ilgili fotoğraf için fotoğraf referansları döndürülür içerik. Yer Bulma, Yakında Arama ve Metin Arama istekleri de tek bir fotoğraf döndürür bir referans noktası görevi görebilir. Fotoğraf hizmetini kullanarak referanslı fotoğrafları kaldırmanızı ve resmi sizin için optimum boyuta kabul edersiniz.

Yer Fotoğrafı istekleri

Yer Fotoğrafı isteği, aşağıdaki biçimdeki bir HTTP URL'sidir:

https://maps.googleapis.com/maps/api/place/photo?parameters

Arama isteğinde bulunmak için belirli parametreler gerekir. Standart olduğu gibi URL'lerde, tüm parametreler "ve" (&) karakteri kullanılarak ayrılır. İlgili içeriği oluşturmak için kullanılan Parametre listesi ve olası değerleri aşağıda listelenmiş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ğrafı hizmetine yapılan tüm istekler bir photo_reference, Yer Bulma, Yakında Arama, Metin Arama veya Yer Ayrıntılarına yanıt olarak döndürüldü isteği gönderin. Bu isteklerin yanıtı,photos[] yerle ilgili fotoğraf içeriğine sahip.

Not: Döndürülen fotoğrafların sayısı isteğe bağlı olarak değişir.

  • Yer Bulma, Yakında Arama veya Metin Arama isteği en fazla bir photo öğesi döndürür değeri gösterilir.
  • 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 gerçekleştirebilirim.
  • height: Resmin maksimum yüksekliği.
  • width - resmin maksimum genişliği.
  • html_attributions[]: Gerekli atıfları içerir. Bu alanı her zaman bulunur ancak boş olabilir.

Fotoğraf hizmeti tarafından döndürülen fotoğraflar çeşitli konumlardan elde edilir. ve kullanıcılar tarafından katkıda bulunulan fotoğraflar dahil. Çoğu durumda bu fotoğraflar atıf yapılmadan kullanılabilir veya gerekli atıfa sahip olur resmin bir parçası olarak eklenir. Ancak döndürülen photo öğesi html_attributions alanında bir değer içeriyorsa uygulamanızda ek ilişkilendirme ve özellik ekleme.

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[] dizisi örneği aşağıda gösterilmiş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 resim, en fazla 400 piksel genişliğinde olacak şekilde yeniden boyutlandırın.

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 resim olacaktır. Türü, fotoğraf, orijinal olarak gönderilen fotoğrafın türüne bağlıdır.

İsteğiniz kullanılabilir kotanızı aşarsa sunucu, HTTP 403 durumu ve kotanın aşıldı:

Kota Aşımı resmi

Sunucu isteğinizi anlayamazsa HTTP 400 hatası döndürür durumudur. Bu, geçersiz bir istek olduğunu gösterir. Bir sorunun geçersiz istek şunları içerir:

  • Gönderilen fotoğraf referansı doğru belirtilmedi.
  • Talepte maxwidth veya maxheight yer almıyordu parametreleridir.
  • maxwidth veya maxheight parametresi değeri ayarlandı alıcı: null.
  • photo_reference ödülünün süresi doldu. photo_reference alanının süresi dolarsa Yer Ayrıntıları'na istek gönderirseniz Yer Bulma, Yakında Arama, veya Metin Arama güncel photo_reference değerini alın.