Yer Fotoğrafları (Yeni)

Giriş

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

Yer Ayrıntıları (Yeni), Yakındaki Yerleri Arama (Yeni) veya Metin Arama (Yeni) isteği kullanarak yer bilgisi aldığınızda, ilgili fotoğraf içerikleri için fotoğraf kaynakları da isteyebilirsiniz. Yer Fotoğrafları (Yeni) özelliğini kullanarak referans verilen fotoğraflara erişebilir ve resmi uygulamanız için ideal boyuta yeniden boyutlandırabilirsiniz.

API Gezgini, API ve API seçenekleri hakkında bilgi edinmek için canlı isteklerde bulunmanıza olanak tanır:

Yer Fotoğrafları (Yeni) istekleri

https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS

Aşağıdaki parametreler gereklidir:

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

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

Gerekli parametreler

Fotoğraf adı

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

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

maxHeightPx ve maxWidthPx

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

maxHeightPx, maxWidthPx veya her ikisini de belirtmeniz gerekir.

İsteğe bağlı parametreler

skipHttpRedirect

false (varsayılan) ise resmi döndürmek için resme bir HTTP yönlendirmesi yapın. true ise yönlendirmeyi atlayın ve görüntü 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

Place Photos (New) ile ilgili tüm istekler, Nearby Search (New), Text Search (New) veya Place Details (New) isteğine verilen yanıtta döndürülen bir fotoğraf kaynağı adı içermelidir. Bu isteklere verilen yanıtlarda, yerle ilgili fotoğraf içeriği varsa photos[] dizisi bulunur.

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

• name — Bir 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 atıflar. Bu alan her zaman mevcuttur ancak boş olabilir.

Yer Fotoğrafları (Yeni) tarafından döndürülen fotoğraflar, işletme sahipleri ve kullanıcı tarafından gönderilen fotoğraflar da dahil olmak üzere çeşitli konumlardan alınır. Çoğu durumda bu fotoğraflar, atıfta bulunulmadan kullanılabilir veya gerekli atıf, resmin bir parçası olarak eklenir. Ancak döndürülen photo öğesi authorAttributions alanında bir değer içeriyorsa resmi uygulamanızda her gösterdiğiniz yerde ek atıf bilgisi eklemeniz gerekir.

Aşağıdaki örnekte, yanıtın photos[] dizisini içermesi için alan maskesine photos ekleyen bir Yer Ayrıntıları (Yeni) isteği gösterilmektedir:

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

    ...
    "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, kaynağını name 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/ATKogpeivkIjQ1FT7QmbeT33nBSwqLhdPvIWHfrG1WfmgrFjeZYpS_Ls7c7rj8jejN9QGzlx4GoAH0atSvUzATDrgrZic_tTEJdeITdWL-oG3TWi5HqZoLozrjTaxoAIxmROHfV5KXVcLeTdCC6kmZExSy0CLVIG3lAPIgmvUiewNf-ZHYE4-jXYwPQpWHJgqVosvZJ6KWEgowEA-qRAzNTu9VH6BPFqHakGQ7EqBAeYOiU8Dh-xIQC8FcBJiTi0xB4tr-MYXUaF0p_AqzAhJcDE6FAgLqG1s7EsME0o36w2nDRHA-IuoISBC3SIahINE3Xwq2FzEZE6TpNTFVfgTpdPhV8CGLeqrauHn2I6ePm-2hA8-87aO7aClXKJJVzlQ1dc_JuHz6Ks07d2gglw-ZQ3ibCTF5lMtCF9O-9JHyRQXsfuXw/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY

Başarılı bir Yer Fotoğrafları (Yeni) isteğinin yanıtı bir resimdir.

Hata kodları

Yer Fotoğrafları (Yeni) istekleri aşağıdaki hata kodlarını döndürebilir.

Kota aşıldı (403)

İ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:

Geçersiz istek (404)

Sunucu isteğinizi anlayamazsa geçersiz bir 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 şekilde belirtilmedi.
• İstek, maxHeightPx veya maxWidthPx parametresini içermiyordu.
• maxHeightPx veya maxWidthtPx parametresinin değeri null olarak ayarlandı.
• name kodunun süresi doldu. name süresi dolarsa yeni bir name almak için Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) veya Metin Arama (Yeni)'ya istekte bulunun.

Çok fazla istek var (429)

Google, fotoğrafların isteğe bağlı olarak yüklenmesini önerir. Bir yerin tüm resimlerini aynı anda göstermeye çalışırsanız sunucu, aynı anda çok fazla fotoğraf yüklendiğini belirten bir HTTP 429 durumu döndürebilir. Bu hata mesajını alırsanız destek ekibiyle iletişime geçerek kota artışı isteğinde bulunun.

Deneyin!

API Gezgini, API ve API seçeneklerine alışabilmeniz için örnek istekler göndermenize olanak tanır.

İstek göndermek için:

1. Sayfanın sağ tarafındaki API simgesini api 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. İstek, varsayılan olarak API Explorer tarafından görüntülenemeyen resmi döndürür.
4. Yürüt düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.

5. API Gezgini panelinde, API Gezgini penceresini genişletmek için tam ekran simgesini fullscreen seçin.