Street View resim isteği, şu biçimdeki bir HTTP URL'sidir:
https://maps.googleapis.com/maps/api/streetview?parameters
Resim, istek parametreleri kullanılarak belirtilir. URL'lerde standart olarak olduğu gibi, tüm parametreler "ve" işareti (&) 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, OHgibi) veya enlem ve boylam koordinatları çifti (40.457375,-80.009353) olabilir ve URL olarak kodlanmalıdır. Bu nedenle, isteği göndermeden önce "Belediye Binası, İstanbul, İstanbul" gibi adresleri "Belediye+Binası,İstanbul,İstanbul" şeklinde dönüştürün. Street View Static API, konuma en yakın panorama fotoğrafına odaklanır. Bir adres metin dizesi sağladığınızda API, belirtilen konumu daha iyi göstermek için farklı bir kamera konumu kullanabilir. Enlem ve boylam koordinatlarını sağladığınızda API, konuma en yakın fotoğrafı bulmak için 50 metrelik bir yarıçap içinde arama yapar. Street View görüntüleri düzenli olarak yenilendiğinden ve fotoğraflar her seferinde biraz farklı konumlardan çekilebileceğinden, görüntüler güncellendiğindelocation'ünüz farklı bir panoramaya çekilebilir.
veya:
pano, belirli bir panorama kimliğidir. Panoramaların kimliği zaman içinde değişebileceğinden bu kimliği kalıcı yapmayın. Bunun yerine, panorama kimliğini yenileyebilmek için konum adresini veya enlem ve boylam koordinatlarını kaydedin. Ayrıntılar için Silinen panorama kimliklerini yenileme başlıklı makaleyi inceleyin.
Ayrıca:
size, resmin piksel cinsinden çıkış boyutunu belirtir. Boyut{width}x{height}olarak belirtilir. Örneğin,size=600x400600 piksel genişliğinde ve 400 piksel yüksekliğinde bir resim döndürür.key, uygulamanızın API kullanımını Google Cloud Console'da izlemenize olanak tanır ve gerekirse Google'ın uygulamanız hakkında sizinle iletişime geçebilmesini sağlar. Daha fazla bilgi için Anahtar ve İmza Alma başlıklı makaleyi inceleyin.
Silinen panorama kimliklerini yenileme
Bir panorama kimliği almaya çalışırken ZERO_RESULTS veya hiçbir değer almazsanız panorama kimliği silinmiş demektir ve yenilenmesi gerekir.
Panorama kimliği almak için kullandığınız konum adresini veya enlem ve boylam koordinatlarını kaydedin. Böylece, gerektiğinde yenileyebilirsiniz.
Bir panorama kimliğinin değiştiğini tespit ettiğinizde, orijinal konum adresini veya enlem ve boylam koordinatlarını kullanarak söz konusu konuma en yakın panoramaları tekrar arayın ve yeni bir panorama kimliği alın.
İsteğe bağlı parametreler
signature(önerilir), API anahtarınızı kullanarak istek oluşturan tüm sitelerin bunu yapmaya yetkili olduğunu doğrulamak için kullanılan bir dijital imzadır. Dijital imza içermeyen istekler başarısız olabilir. Daha fazla bilgi için Anahtar ve İmza Alma başlıklı makaleyi inceleyin.Not: Eski Google Haritalar Platformu Premium Plan müşterileri için dijital imza gereklidir. Premium Plan müşterileri için kimlik doğrulama parametreleri hakkında daha fazla bilgi edinin.
heading, kameranın pusula istikametini gösterir. Kabul edilen değerler0ile360arasındadır (90değeri doğu,180değeri güney ve her iki değer de kuzey yönünü belirtir). Bir yön belirtmezseniz en yakın fotoğrafın çekildiği noktadan kamerayı belirtilenlocationdeğerine yönlendiren bir değer hesaplanır.fov(varsayılan değer90) görüntünün yatay görüş alanını derece cinsinden belirler. İzin verilen maksimum değer120'tir. Sabit boyutlu bir görüntü alanında (ör. belirli bir boyuttaki Street View görüntüsü) görüş alanı, temelde yakınlaştırmayı temsil eder. Daha küçük sayılar, daha yüksek bir yakınlaştırma düzeyini gösterir.
(Sol:fov=120; Sağ:fov=20)pitch(varsayılan değer0), kameranın Street View aracıyla göreceli yukarı veya aşağı açısını belirtir. Bu, her zaman olmamakla birlikte genellikle düz yataydır. Pozitif değerler kamera açısını yukarı (90derece dimdik yukarıyı belirtir), negatif değerler de kamera açısını aşağı (-90değeri dimdik aşağıyı belirtir) doğru döndürür.radius(varsayılan değer50) belirtilen enlem ve boylama odaklı bir panorama aramak için metre cinsinden belirtilen bir yarıçapı belirler. Geçerli değerler sıfırdan büyük tam sayılardır.return_error_code, API'nin resim bulunamadığında (404 NOT FOUND) veya geçersiz bir isteğe yanıt olarak (400 BAD REQUEST) bir hata kodu döndürüp döndürmeyeceğini belirtir. Geçerli değerlertruevefalse'dir.trueolarak ayarlanırsa genel gri resim yerine bir hata mesajı döndürülür. Bu sayede, görüntü kullanılabilirliğini kontrol etmek için ayrı bir çağrı yapmanıza gerek kalmaz.source(varsayılan değerdefault) Street View aramalarını seçili kaynaklarla sınırlandırır. Geçerli değerler: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. Kapalı koleksiyonlar arama sonuçlarına dahil edilmez. Belirtilen konum için açık hava panoramalarının bulunmayabileceğini unutmayın. Aramanın yalnızca kapalı veya açık olup olmadığının belirlenebildiği panoramaları döndürdüğünü de unutmayın. Örneğin, kapalı alanda mı yoksa açık alanda mı çekildiği bilinmediği için PhotoSphere'ler döndürülmez.
Bu bir istek örneğidir.
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 kullanılamadığı konumlar için Street View Static API, bu örnekte gösterildiği gibi "Üzgünüz, burada görüntü yok" metnini içeren gri bir genel resim döndürür:
Yalnızca geçerli resimleri göster
Genel resmin gösterilmesini önlemek ve web sayfanızda yalnızca geçerli Street View Static API resimlerinin gösterilmesini sağlamak için aşağıdaki önerileri uygulayın:
return_error_codeparametresinitrueolarak ayarlayın. Bu durumda, belirtilen konum için resim yoksa Street View Static API, genel gri resim yerine 404 NOT FOUND hatası döndürür.- İstekte bulunmadan önce, belirtilen konum için görüntü olup olmadığını belirlemek üzere Street View görüntü meta verilerini isteyin.