Yer Fotoğrafı (Yeni)

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 Explorer, API ve API seçenekleri hakkında bilgi edinebilmeniz için canlı istekler yapmanıza olanak tanır:

Yer fotoğrafı istekleri

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 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 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 ek ilişkilendirmeyi uygulamanıza eklemeniz gerekir.

Aşağıdaki örnekte, yanıtta photos[] dizisinin yer alması için alan maskesinde photos içeren bir 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

    ...
    "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 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:

Sunucu isteğinizi anlayamazsa HTTP 400 durumunu döndürür. Bu durum, geçersiz istek olduğunu gösterir. 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'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 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 () 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 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'ta, isteği göndermek için kullanmak istediğiniz hesabı seçin.

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