Yer Fotoğrafı (Yeni)

Platform seçin: Android iOS Web Hizmeti

Yer Fotoğrafı (Yeni) 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ı, Yakındakiler Arama veya Metin Arama isteği kullanarak yer bilgisi aldığınızda alakalı fotoğraf içerikleri için fotoğraf kaynakları da isteyebilirsiniz. Ardından, Fotoğraf hizmetini kullanarak referans verilen fotoğraflara erişebilir ve resmi uygulamanız için en uygun boyuta yeniden boyutlandırabilirsiniz.

API Gezgini, API'ye ve API seçeneklerine aşina olabilmeniz için canlı istek göndermenize olanak tanır:

Deneyin.

Yer fotoğrafı istekleri

Yer Fotoğrafı isteği, şu biçimdeki bir URL için HTTP GET isteğidir: 
https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS

Aşağıdaki parametrelerin gerekli olduğu durumlarda:

  • NAME, fotoğrafın kaynak adını içerir.
  • API_KEY, API anahtarını içerir.
  • 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 dize tanımlayıcısı. Fotoğraf adları, Yer Ayrıntıları (Yeni), Yakındakiler Arama (Yeni) veya Metin Arama (Yeni) isteğinde photos[] dizisinin her bir öğesinin name mülkünde döndürülür.

Örnek için Fotoğraf adı alma bölümüne bakın.

maxHeightPx ve maxWidthPx

Resmin piksel cinsinden maksimum istenilen yüksekliğini ve genişliğini belirtir. Resim belirtilen değerlerden küçükse orijinal resim döndürülür. Resim herhangi bir boyutta daha büyükse orijinal en boy oranıyla sınırlı olarak iki boyuttan küçük olanla eşleşecek şekilde ölçeklendirilir. Hem maxheight hem de maxwidth özellikleri 1 ile 4.800 arasında bir tam sayı kabul eder.

maxHeightPx, maxWidthPx veya her ikisini birden belirtmeniz gerekir.

İsteğe bağlı parametreler

skipHttpRedirect

false (varsayılan) ise resmi döndürmek için resme HTTP yönlendirmesi yapın. true ise yönlendirmeyi atlayıp resim ayrıntılarını 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 dışı istekler için yoksayılır.

Fotoğraf adı alma

Yer Fotoğrafı hizmetine yapılan tüm istekler, Yakındakiler Arama, Metin Arama veya Yer Ayrıntıları isteğinin yanıtında döndürülen bir fotoğraf kaynağı adı içermelidir. Bu isteklerin yanıtı, ilgili fotoğraf içeriği varsa bir photos[] dizisi içerir.

photo[] öğelerinin her biri aşağıdaki alanları içerir:

  • name: Fotoğraf isteği gönderdiğ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 tüm atıflar. 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 authorAttributions alanında bir değer varsa resmi gösterdiğiniz her yerde uygulamanıza ek ilişkilendirmeyi eklemeniz gerekir.

Aşağıdaki örnekte, alan maskesinde photos bulunan bir Yer Ayrıntıları isteği gösterilmektedir. Bu sayede yanıtta photos[] dizisi yer alır:

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ıtta 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ı isteme

Aşağıdaki örnek istek, name kaynağını kullanarak bir resim döndürür ve bu resmi en fazla 400 piksel yüksekliğinde ve genişliğinde olacak şekilde yeniden boyutlandı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ü, 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 adı doğru şekilde belirtilmedi.
  • İstek, maxHeightPx veya maxWidthPx parametresini içermiyordu.
  • maxHeightPx veya maxWidthtPx parametresinin değeri null olarak ayarlandı.
  • name kodunun süresi doldu. name'nin süresi dolarsa yeni bir name almak için Yer Ayrıntıları (Yeni), Yakındakiler Arama (Yeni) veya Metin Arama (Yeni)'ya istek gönderin.

Deneyin!

API Gezgini, API'ye ve API seçeneklerine aşina olabilmeniz için örnek istekler göndermenize olanak tanır.

İstekte bulunmak için:

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

  5. API Gezgini panelinde, API Gezgini penceresini genişletmek için genişlet simgesini API Gezgini'ni genişletin. seçin.