Street View görüntüsü isteği, şu biçimdeki bir HTTP URL'sidir:
https://maps.googleapis.com/maps/api/streetview?parameters
Resim, istek parametreleri kullanılarak belirtilir. Bu programda standart olduğu gibi URL'leri içeriyorsa tüm parametreler "ve" (&) karakteri kullanılarak ayrılır. İzin verilen parametreler ve olası değerleri aşağıda listelenmiştir.
Gerekli parametreler
Şu iki yöntemden birini kullanın:
location
bir metin dizesi (Chagrin Falls, OH
gibi) olabilir veya bir enlem ve boylam koordinat çifti (40.457375,-80.009353
), URL olarak kodlanmalıdır. Dolayısıyla, "Belediye Binası, New York, NY" gibi adresler "City+Hall,New+York,NY" olarak kontrol edin. Street View Static API, konumu. Bir adres metin dizesi sağladığınızda API, belirtilen konumu daha iyi görüntülemek için farklı bir kamera konumu. Enlem ve boylam koordinatlarını verdiğinizde API, konuma en yakın fotoğrafı bulmak için 50 metre yarıçapında arama yapar. Street View görüntüleri düzenli olarak yenilendiğinden ve fotoğraflarda her seferinde biraz farklı konumlardan alınabilir. Bu kişilerin görüntüler güncellendiğindelocation
cihazınız farklı bir panoramaya geçebilir.
veya:
pano
belirli bir panorama kimliğidir. Panoramaların kimliği zamanla değişebilir. bu kimliği kullanmayın. Bunun yerine, konum adresini kaydedin veya panorama kimliğini yenileyebilmek için enlem ve boylam koordinatlarını kullanın. Örneğin, Silinen panorama kimliklerini yenileme başlıklı makaleyi inceleyin.
Ayrıca:
size
, resmin çıkış boyutunu piksel cinsinden belirtir. Boyut:{width}x{height}
- örneğin,size=600x400
600 piksel genişliğinde ve 400 yüksekliğinde bir resim döndürür.key
, uygulamanızın API kullanımını Google Cloud Console, ve gerektiğinde Google'ın başvurunuzla ilgili olarak sizinle iletişim kurabilmesini sağlar. Daha fazla bilgi edinmek için Anahtar ve İmza alma başlıklı makaleye göz atın.
Silinen panorama kimliklerini yenile
Bir panorama kimliği almaya çalışırken ZERO_RESULTS
veya
değer yoksa panorama kimliği silinir ve yenilenmesi gerekir.
Daha önce kullandığınız konum adresini ya da enlem ve boylam koordinatlarını kaydedin bir panorama kimliği alabilirsiniz.
Bir panorama kimliğinin değiştiğini tespit ettiğinizde orijinal konumu kullanın adresi veya enlem/boylam koordinatlarını yeni bir panorama kimliği alabilirsiniz.
İsteğe bağlı parametreler
signature
(önerilir) kullanılan bir dijital imzadır API anahtarınızı kullanarak istek oluşturan tüm sitelerin yetkilendirildiğini doğrulamak için sahip olmanız gerekir. Dijital imza içermeyen istekler başarısız olabilir. Daha fazla bilgi edinmek için Anahtar ve İmza alma başlıklı makaleye göz atın.Not: Eski Google Haritalar Platformu Premium Planı müşterileri için dijital imzalanması gerekir. Daha fazla bilgi için: kullanıcının kimliğini doğrulamak için Premium Plan müşterileri.
heading
, şunun pusula yönünü gösterir göstermenin iyi bir yoludur.0
ile360
arasında kabul edilen değerler (her iki değer de Kuzeyi,90
ise Doğuyu ve180
Güney). Başlık belirtmezseniz bir değer kamerayı belirtilen hedefe yönlendiren hesaplanırlocation
, en yakın fotoğrafın olduğu andan itibaren alır.fov
(varsayılan ayar:90
) resmin derece cinsinden ifade edilen yatay görüş alanını belirler. izin verilen maksimum değer120
olacak şekilde ekleyin. Sabit boyutlu bir görüntü alanı üzerinde çalışırken, bir resmin Street View resmi gibi boyutu ayarla, özünde görüş alanı yakınlaştırmayı, daha küçük sayıları temsil eder. gösteren resimler de belirir.
.
(Sol:fov=120
; Sağ:fov=20
)pitch
(varsayılan ayar:0
) kameranın Street View'a göre yukarı veya aşağı açısını belirtir kullanabilirsiniz. Bu, her zaman olmasa da genellikle düz yataydır. Pozitif değerler kamera açısını yukarı doğru tutun (90
derece dik bir şekilde yukarıyı gösterir); negatif değerler kamera açısını aşağı çeker (-90
, tepeden tırnağa).radius
(varsayılan ayar:50
) metre cinsinden belirtilen bir yarıçap belirler. alınan enlem ve boylama odaklanır. Geçerli değerler negatif değildir tam sayılar.return_error_code
, API'nin döndürülüp döndürülmeyeceğini belirtir hata kodu (404 BULUNAMADI) veya yanıt olarak geçersiz istek (400 BAD REQUEST). Geçerli değerler:true
vefalse
.true
olarak ayarlanırsa bir hata mesajı eski haline döner. Bu sayede ekip arkadaşlarınızın görsel olup olmadığını kontrol etmek için ayrı bir arama yapın.source
(varsayılan ayar:default
) Street View aramalarını seçili kaynaklarla sınırlar. Geçerli değerler şunlardır:default
, Street View için varsayılan kaynakları kullanır; aramalar belirli kaynaklarla sınırlı değildir.outdoor
, aramaları açık hava koleksiyonlarıyla sınırlandırır. İç Mekan koleksiyonlar arama sonuçlarına dahil edilmez. Açık hava panoramalarının mevcut olmayabileceğini unutmayın belirtilen konum için. Ayrıca, aramanın yalnızca panoramaları döndürdüğünü unutmayın. tespit edilebiliyor. Örneğin, İçeride mi yoksa dışarıda mı olduğu bilinmediği için PhotoSphere döndürülmüyor.
Bu, örnek bir istektir.
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Görüntü yok
Street View görüntülerinin bulunmadığı konumlar için Street View Static API'yi kullanabilirsiniz. "Maalesef hiçbir görüntülerimiz yok. burada." gibi bir ifade kullanabilirsiniz:
Yalnızca geçerli resimleri göster
Genel bir resim görüntülemekten kaçınmak ve web sayfanızın yalnızca geçerli Street View Static API resimlerini gösteriyorsa aşağıdakileri uygulayın: öneriler:
return_error_code
parametresinitrue
olarak ayarlayın. Bu durum, Street View Static API'nin 404 NOT FOUND (BULUNAMADI) döndürmesine neden olur. hatasını (ör. genel gri resim yerine) belirtilen konum.- Street View resim meta verisi isteğinde bulunma söz konusu yer için görüntü olup olmadığını belirlemek üzere bir istek gönderme sürecidir.