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ında Arama veya Metin Arama isteğini kullanarak yer bilgileri aldığınızda, alakalı fotoğraf içerikleri için fotoğraf kaynakları da isteyebilirsiniz. Fotoğraf hizmetini kullanarak referans edilen fotoğraflara erişebilir ve resmi uygulamanız için optimum boyuta ayarlayabilirsiniz.
API Explorer, API'yi ve API seçeneklerini tanımanız için canlı isteklerde bulunmanıza olanak tanır:
Deneyin.Yer Fotoğrafı istekleri
Yer Fotoğrafı isteği, aşağıdaki formda bir URL'ye yapılan HTTP GET isteğidir:https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS
Aşağıdaki parametrelerin gerektiği durumlarda:
- NAME, fotoğrafın kaynak adını içerir.
- API_KEY, API anahtarını içeriyor.
- 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 bir dize tanımlayıcısı. Fotoğraf adları, photos[]
dizisinin her bir öğesinin name
özelliğinde bir Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) veya Metin Arama (Yeni) isteğinden döndürülür.
Örnek için Fotoğraf adı alma başlıklı makaleyi inceleyin.
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 her iki boyutta da daha büyükse iki boyuttan küçük olanına uyacak şekilde ölçeklendirilir ve orijinal en boy oranıyla sınırlandırılır. Hem maxheight hem de maxwidth özellikleri, 1 ile 4800 arasında bir tam sayı kabul eder.
maxHeightPx
ve maxWidthPx
ya da her ikisini birden belirtmeniz gerekir.
İsteğe bağlı parametreler
skipHttpRedirect
false
(varsayılan) değerine ayarlanırsa resmi döndürmek için resme bir HTTP yönlendirmesi yapın.
true
ise yönlendirmeyi atlayın ve hatalı resmi 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.
Bir fotoğraf adı alın
Yer Fotoğrafı hizmetine yapılan tüm istekler; Yakındaki Arama, Metin Arama veya Yer Ayrıntısı isteğine yanıt olarak döndürülen bir fotoğraf kaynağı adı içermelidir. Yerin alakalı fotoğrafik içeriği varsa bu isteklere verilen yanıt bir photos[]
dizisi içerir.
Her photo[]
öğesi şu alanları içerir:
name
: 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 ilişkilendirmeler. 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 alınır. Çoğu durumda, bu fotoğraflar atıf olmadan kullanılabilir veya gerekli atıf resmin 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, alan maskesinde photos
içeren bir Yer Ayrıntıları isteği gösterilmektedir. Böylece yanıt, photos[]
dizisini içerir:
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/ChIJ2fzCmcW7j4AR2JzfXBBoh6EYanıttaki
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ı isteğinde bulunma
Aşağıdaki örnek istek, name
kaynağını kullanan ve en fazla 400 piksel yüksekliğinde ve genişliğinde olacak şekilde yeniden boyutlandırılan bir resim döndü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ü, gönderilen orijinal 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 geçersiz 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 belirtilmedi.
- İstek,
maxHeightPx
veyamaxWidthPx
parametresini içermiyordu. maxHeightPx
veyamaxWidthtPx
parametresinin değerinull
olarak ayarlandı.name
için geçerlilik süresi doldu.name
talimatının süresi dolarsa yeni birname
edinmek için Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) veya Metin Arama (Yeni) içeriklerinden istekte bulunun.
Deneyin.
API Explorer, API'yi ve API seçeneklerini tanımanız için örnek isteklerde bulunmanıza olanak tanır.
İstekte bulunmak için:
- Sayfanın sağ tarafındaki API simgesini () seçin.
name
parametresini şu şekilde ayarlayın:places/PLACE_ID/photos/PHOTO_RESOURCE/media
- İsteğin bir JSON yanıtı döndürmesi için
skipHttpRedirect
değerinitrue
olarak ayarlayın. Varsayılan olarak istek, API Gezgini tarafından görüntülenemeyen resmi döndürür. - Yürüt düğmesini seçin. Pop-up pencerede, istekte bulunurken kullanmak istediğiniz hesabı seçin.
API Gezgini panelinde API Gezgini penceresini genişletmek için genişletme simgesini () seçin.