Bu sayfa, Cloud Translation API ile çevrilmiştir.

Yer Fotoğrafları (Yeni)

Platform seçin: Android iOS Web Hizmeti

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

Yer Ayrıntıları (Yeni), Yakındakiler Arama (Yeni) veya Metin Arama (Yeni) isteği kullanarak yer bilgileri aldığınızda alakalı fotoğraf içerikleri için fotoğraf kaynakları da isteyebilirsiniz. Fotoğraf Yerleştir (Yeni) özelliğini 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.

Not: Yer Ayrıntıları (Yeni) yanıt gövdenizdeki photos dizisinden name yerini girin ve "Yürüt"ü tıklayın. Fotoğrafı görüntülemek için Yer Fotoğrafları (Yeni) yanıt gövdesinde photoUri değerini kullanın.

Yer Fotoğrafları (Yeni) istekleri

Yer Fotoğrafları (Yeni) isteği, aşağıdaki 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 yerler:

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ı, photos[] dizisinin her bir öğesinin name mülkünde Yer Ayrıntıları (Yeni), Yakındakiler 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 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ğrafları (Yeni) ile ilgili tüm istekler, Yakınımda Arama (Yeni), Metin Arama (Yeni) veya Yer Ayrıntıları (Yeni) 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 bulunan yerler için bir photos[] dizisi içerir.

Not: photos[] dizisini yanıta dahil etmek için istek alanına photos (Yer Ayrıntıları (Yeni)) veya places.photos (Yakındakiler Arama (Yeni) ve Metin Arama (Yeni)) eklediğinizden emin olun. Her API, bir yer konumu için en fazla 10 fotoğraf döndürebilir.

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.

Yer Fotoğrafları (Yeni) 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 maskesine photos dahil edilen 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

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

Fotoğraf Yerleşim (Yeni) isteği başarıyla tamamlandığında 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:

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:

Sayfanın sağ tarafındaki API simgesini api seçin.
name parametresini şu şekilde ayarlayın:
```
places/PLACE_ID/photos/PHOTO_RESOURCE/media
```
Not: name'nin süresi dolayabileceğinden, son bir Yer Ayrıntıları (Yeni) isteğinde alınan bir name kullandığınızdan emin olun.
İ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.
Yürüt düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.
API Gezgini panelinde, API Gezgini penceresini genişletmek için tam ekran simgesini fullscreen seçin.