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](https://developers.google.cn/static/maps/documentation/maps-static/images/quota.png?authuser=5&hl=tr)
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
veyamaxWidthPx
yer almıyordu parametresinden sonra bir değer girin. maxHeightPx
veyamaxWidthtPx
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 birname
.
Deneyin!
API Gezgini sayesinde örnek isteklerde bulunabilirsiniz. hakkında da bilgi edineceksiniz.
İstekte bulunmak için:
- API simgesini,
sekmesini tıklayın.
name
parametresini şu değere ayarlayın:places/PLACE_ID/photos/PHOTO_RESOURCE/media
- İsteğin bir JSON döndürmesi için
skipHttpRedirect
öğesinitrue
olarak ayarlayın. tıklayın. Varsayılan olarak, istek API Gezgini'ni seçin. - Yürüt düğmesini seçin. Pop-up pencerede, kullanmaları gerekir.
API Gezgini panelinde genişlet simgesini seçin, API Gezgini penceresini genişletmek için
tuşlarına basın.