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 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 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/ChIJ2fzCmcW7j4AR2JzfXBBoh6EYanı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](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/quota.png?authuser=4&hl=tr)
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
veyamaxWidthPx
parametresini içermiyordu. maxHeightPx
veyamaxWidthtPx
parametresinin değerinull
olarak ayarlandı.name
ödülünün süresi doldu.name
alanının süresi dolarsa yeni birname
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:
- Sayfanın sağ tarafındaki API simgesini (
) seçin.
name
parametresini şu şekilde ayarlayın:places/PLACE_ID/photos/PHOTO_RESOURCE/media
- İsteğin JSON yanıtı döndürmesi için
skipHttpRedirect
öğesinitrue
olarak ayarlayın. Varsayılan olarak istek, API Gezgini tarafından görüntülenemeyen görüntüyü döndürür. - Yürüt düğmesini seçin. Pop-up pencerede, istekte bulunmak için kullanmak istediğiniz hesabı seçin.
API Gezgini panelinde genişletme simgesini (
) seçerek API Gezgini penceresini genişletin.