Yer Fotoğrafı (Yeni)

Platform seçin: Android iOS Web Hizmeti

Yer Fotoğrafı (Yeni) hizmet düzeyi yüksek kaliteli reklam kodu eklemenize olanak tanıyan fotoğraf içeriği yükleyebilirsiniz. Yer Fotoğrafı hizmeti, Rehber 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, ilgili fotoğraf içeriği için fotoğraf kaynakları da isteyebilirsiniz. Fotoğraf hizmetini kullanırken referanslı fotoğraflara erişebilir ve resmin boyutunu kendi isteğinize göre bir uygulamadır.

API Gezgini, API'yi ve sunulan API'yi tanıyabilmeniz için canlı isteklerde bulunmanızı sağlar. API seçenekleri:

Deneyin.

Yer Fotoğrafı istekleri

Yer Fotoğrafı isteği, formdaki 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 kontrol etmeniz gerekir.

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ı Yer Ayrıntıları (Yeni), Yakında Arama (Yeni), veya Metin Arama (Yeni) isteği photos[] dizisinin her bir öğesinin name özelliğinde

Ö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 daha küçükse orijinal resim döndürülür. Resim iki boyutun daha küçük olanına uyacak şekilde ölçeklendirilir ve orijinal boyutla sınırlandırılır. en boy oranı. 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 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 olmayan istekler için yoksayılır.

Fotoğraf adı alın

Yer Fotoğrafı hizmetine yapılan tüm istekler bir Yakındaki Arama, Metin Arama veya Yer Ayrıntıları isteği. Bu isteklerin yanıtı, aşağıdaki durumlarda bir photos[] dizisi içerir: yerle ilgili fotoğraf içeriğine sahip.

Her photo[] öğesi aşağıdaki alanları içerir:

  • name — Aşağıdaki komutu tıkladığınızda fotoğrafın kaynak adını içeren bir dize Fotoğraf isteği gerçekleştirebilirim. 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 bulunur ancak boş olabilir.

Fotoğraf hizmeti tarafından döndürülen fotoğraflar çeşitli konumlardan elde edilir. ve kullanıcılar tarafından katkıda bulunulan fotoğraflar dahil. Çoğu durumda bu fotoğraflar atıf yapılmadan kullanılabilir veya gerekli atıfa sahip olur resmin bir parçası olarak eklenir. Ancak döndürülen photo öğesi authorAttributions alanında bir değer içeriyorsa uygulamanızda ek ilişkilendirme ve özellik ekleme.

Aşağıdaki örnekte photos içeren bir Yer Ayrıntıları isteği gösterilmektedir alan maskesini, yanıtta photos[] dizisini içerecek şekilde değiştirin:

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 görüntü döndürerek yeniden boyutlandırır. en fazla 400 piksel yüksekliğinde ve genişliğinde olduğundan emin olun:

https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY

Yanıt başarılı bir Yer Fotoğrafı isteğinin en önemli özelliği 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, HTTP 403 durumu ve kotanın aşıldı:

Kota Aşımı resmi

Sunucu isteğinizi anlayamazsa HTTP 400 hatası döndürür durumudur. Bu, geçersiz bir istek olduğunu gösterir. Bir sorunun geçersiz istek şunları içerir:

  • Gönderilen fotoğraf adı doğru şekilde belirtilmedi.
  • Talepte maxHeightPx veya maxWidthPx yer almıyordu parametresinden sonra bir değer girin.
  • maxHeightPx veya maxWidthtPx parametresinin değeri ayarlandı alıcı: null.
  • name ödülünün süresi doldu. name alanının süresi dolarsa Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) isteği, veya Metin Arama (Yeni) yeni bir name.

Deneyin!

API Gezgini sayesinde örnek isteklerde bulunabilirsiniz. hakkında da bilgi edineceksiniz.

İstekte bulunmak için:

  1. API simgesini, API Gezgini'ni genişletin. sekmesini tıklayın.
  2. name parametresini şu değere ayarlayın:
    places/PLACE_ID/photos/PHOTO_RESOURCE/media
  3. İsteğin bir JSON döndürmesi için skipHttpRedirect öğesini true olarak ayarlayın. tıklayın. Varsayılan olarak, istek API Gezgini'ni seçin.
  4. Yürüt düğmesini seçin. Pop-up pencerede, kullanmaları gerekir.
  5. API Gezgini panelinde genişlet simgesini seçin, API Gezgini penceresini genişletmek için API Gezgini'ni genişletin. tuşlarına basın.