Yer Fotoğrafı (Yeni)

Platform seçin: Android iOS Web Hizmeti

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ındaki Arama veya Metin Arama isteğini kullanarak yer bilgileri aldığınızda, alakalı fotoğraf içeriği için fotoğraf kaynakları da isteyebilirsiniz. Fotoğraf hizmetini kullanarak, referans verilen fotoğraflara erişebilir ve resmi, uygulamanız için ideal boyuta getirmek üzere yeniden boyutlandırabilirsiniz.

API Explorer, API ve API seçenekleri hakkında bilgi edinebilmeniz için canlı istekler yapmanıza olanak tanır:

Deneyin.

Yer Fotoğrafı istekleri

Yer Fotoğrafı isteği, aşağıdaki biçimdeki bir URL'ye yapılan 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çeriyor.
  • API_KEY, API anahtarını içeriyor.
  • PARAMETERS; maxHeightPx parametresini, maxWidthPx parametresini veya her 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[] dizisindeki her bir öğenin name özelliğinde bir Yer Ayrıntıları (Yeni), Yakındaki 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 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, iki boyuttan herhangi biri açısından daha büyükse orijinal en boy oranıyla sınırlı olmak kaydıyla iki boyuttan daha küçük olanla eşleşecek şekilde ölçeklendirilir. Hem maxheight hem de maxwidth özellikleri 1 ile 4800 arasında bir tam sayıyı kabul eder.

maxHeightPx veya maxWidthPx ya da her ikisini de belirtmelisiniz.

İ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ın ve varsayılan resmin yer aldığı 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.

Fotoğraf adı alın

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

Her photo[] öğesi 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.

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 elde edilir. Çoğu durumda, bu fotoğraflar atıf olmadan kullanılabilir veya gerekli atıf resmin bir 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, yanıtın yanıtta photos[] dizisini içermesi için alan maskesinde photos içeren Yer Ayrıntıları 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
Yanıttaki bir 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 görüntüyü 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ü, orijinal olarak gönderilen 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 HTTP 400 durumunu döndürür. Bu durum, geçersiz istek olduğunu gösterir. 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 ödülünün süresi doldu. name alanının süresi dolarsa yeni bir name edinmek için Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) veya Metin Arama (Yeni) hizmetinden istekte bulunun.

Deneyin.

API Gezgini, API ve API seçeneklerini tanıyabilmeniz için örnek isteklerde bulunmanıza 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 öğesini true olarak ayarlayın. Varsayılan olarak istek, API Gezgini tarafından görüntülenemeyen görüntüyü döndürür.
  4. Yürüt düğmesini seçin. Pop-up pencerede, istekte bulunmak için kullanmak istediğiniz hesabı seçin.

  5. API Gezgini panelinde genişletme simgesini (API Gezgini'ni genişletin.) seçerek API Gezgini penceresini genişletin.