Yer Fotoğrafı (Yeni)

Yer Fotoğrafı (Yeni) hizmeti, uygulamanıza yüksek kaliteli fotoğraf içeriği eklemenize olanak tanıyan salt okunur bir API'dir. Yer Fotoğrafı hizmeti, Yerler veritabanında depolanan milyonlarca fotoğrafa erişmenizi sağlar.

Yer Ayrıntıları, Yakında Arama veya Metin Arama isteğini kullanarak yer bilgileri aldığınızda, alakalı fotoğraf içerikleri için fotoğraf kaynakları da isteyebilirsiniz. Fotoğraf hizmetini kullanarak referans edilen fotoğraflara erişebilir ve resmi uygulamanız için optimum boyuta ayarlayabilirsiniz.

API Explorer, API'yi ve API seçeneklerini tanımanız için canlı isteklerde bulunmanıza olanak tanır:

Deneyin.

Yer Fotoğrafı istekleri

Yer Fotoğrafı isteği, aşağıdaki formda bir URL'ye yapılan HTTP GET isteğidir: 
https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS

Aşağıdaki parametrelerin gerektiği durumlarda:

  • NAME, fotoğrafın kaynak adını içerir.
  • API_KEY, API anahtarını içeriyor.
  • PARAMETERS; maxHeightPx parametresini, maxWidthPx parametresini veya ikisini birden içerir.

Zorunlu ve isteğe bağlı parametrelerin tam listesi aşağıda açıklanmıştır.

Gerekli parametreler

Fotoğraf adı

Bir fotoğrafı benzersiz şekilde tanımlayan bir dize tanımlayıcısı. Fotoğraf adları, photos[] dizisinin her bir öğesinin name özelliğinde bir Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) veya Metin Arama (Yeni) isteğinden döndürülür.

Örnek için Fotoğraf adı alma başlıklı makaleyi inceleyin.

maxHeightPx ve maxWidthPx

Resmin istenen maksimum yüksekliğini ve genişliğini piksel cinsinden belirtir. Resim belirtilen değerlerden küçükse orijinal resim döndürülür. Resim her iki boyutta da daha büyükse iki boyuttan küçük olanına uyacak şekilde ölçeklendirilir ve orijinal en boy oranıyla sınırlandırılır. Hem maxheight hem de maxwidth özellikleri, 1 ile 4800 arasında bir tam sayı kabul eder.

maxHeightPx ve maxWidthPx ya da her ikisini birden belirtmeniz gerekir.

İsteğe bağlı parametreler

skipHttpRedirect

false (varsayılan) değerine ayarlanırsa resmi döndürmek için resme bir HTTP yönlendirmesi yapın. true ise yönlendirmeyi atlayın ve hatalı resmi içeren bir JSON yanıtı döndürün. Örneğin:

{
  "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media",
  "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
}

Bu seçenek, HTTP olmayan istekler için yoksayılır.

Bir fotoğraf adı alın

Yer Fotoğrafı hizmetine yapılan tüm istekler; Yakındaki Arama, Metin Arama veya Yer Ayrıntısı isteğine yanıt olarak döndürülen bir fotoğraf kaynağı adı içermelidir. Yerin alakalı fotoğrafik içeriği varsa bu isteklere verilen yanıt bir photos[] dizisi içerir.

Her photo[] öğesi şu alanları içerir:

  • name: Fotoğraf isteği gerçekleştirdiğinizde fotoğrafın kaynak adını içeren bir dize. Bu dize şu biçimdedir:

    places/PLACE_ID/photos/PHOTO_RESOURCE
  • heightPx: Resmin piksel cinsinden maksimum yüksekliği.
  • widthPx: Resmin piksel cinsinden maksimum genişliği.
  • authorAttributions[]: Gerekli ilişkilendirmeler. 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ın katkıda bulunduğu fotoğraflar da dahil olmak üzere çeşitli konumlardan alınır. Çoğu durumda, bu fotoğraflar atıf olmadan kullanılabilir veya gerekli atıf resmin parçası olarak dahil edilir. Bununla birlikte, döndürülen photo öğesi authorAttributions alanında bir değer içeriyorsa resmi görüntülediğiniz her yerde ek ilişkilendirmeyi uygulamanıza eklemeniz gerekir.

Aşağıdaki örnekte, alan maskesinde photos içeren bir Yer Ayrıntıları isteği gösterilmektedir. Böylece yanıt, photos[] dizisini içerir:

curl -X GET \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,photos" \
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E
Yanıttaki photos[] dizisi örneği aşağıda gösterilmiştir. 
    ...
    "photos" : [
      {
        "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1",
        "widthPx": 6000,
        "heightPx": 4000,
        "authorAttributions": [
          {
            "displayName": "John Smith",
            "uri": "//maps.google.com/maps/contrib/101563",
            "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
          }
        ]
      },    ...

Yer fotoğrafı isteğinde bulunma

Aşağıdaki örnek istek, name kaynağını kullanan ve en fazla 400 piksel yüksekliğinde ve genişliğinde olacak şekilde yeniden boyutlandırılan bir resim döndürür:

https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY

Başarılı bir Yer Fotoğrafı isteğinin yanıtı bir resimdir. Resmin türü, gönderilen orijinal 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 isteği belirten HTTP 400 durumunu döndürür. Geçersiz isteğin en yaygın nedenleri şunlardır:

  • Gönderilen fotoğraf adı doğru belirtilmedi.
  • İstek, maxHeightPx veya maxWidthPx parametresini içermiyordu.
  • maxHeightPx veya maxWidthtPx parametresinin değeri null olarak ayarlandı.
  • name için geçerlilik süresi doldu. name talimatının süresi dolarsa yeni bir name edinmek için Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) veya Metin Arama (Yeni) içeriklerinden istekte bulunun.

Deneyin.

API Explorer, API'yi ve API seçeneklerini tanımanız için örnek isteklerde bulunmanıza olanak tanır.

İstekte bulunmak için:

  1. Sayfanın sağ tarafındaki API simgesini (API Explorer'ı genişletin.) seçin.
  2. name parametresini şu şekilde ayarlayın: 
    places/PLACE_ID/photos/PHOTO_RESOURCE/media
  3. İsteğin bir JSON yanıtı döndürmesi için skipHttpRedirect değerini true olarak ayarlayın. Varsayılan olarak istek, API Gezgini tarafından görüntülenemeyen resmi döndürür.
  4. Yürüt düğmesini seçin. Pop-up pencerede, istekte bulunurken kullanmak istediğiniz hesabı seçin.

  5. API Gezgini panelinde API Gezgini penceresini genişletmek için genişletme simgesini (API Explorer'ı genişletin.) seçin.