Street View Resmi isteği, şu biçimde bir HTTP URL'sidir:
https://maps.googleapis.com/maps/api/streetview?parameters
Resim, istek parametreleri kullanılarak belirtilir. URL'lerde standart olduğu gibi 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 yöntemlerden birini kullanın:
location, bir metin dizesi (Chagrin Falls, OHgibi) veya enlem ve boylam koordinatları çifti (40.457375,-80.009353) olabilir ve URL kodlamalı olmalıdır. Bu nedenle, isteği göndermeden önce "Belediye Binası, New York, NY" gibi adresleri "Şehir+ Salon,New+York,NY" olarak dönüştürün. Street View Static API, konuma en yakın panorama fotoğrafını tutturur. Bir adres metin dizesi sağladığınızda API, belirtilen konumu daha iyi görüntülemek 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ği ve fotoğraflar her defasında biraz farklı konumlardan çekilebildiğinden, görüntüler güncellendiğindelocationfarklı bir panoramaya tutturulabilir.
veya:
panobelirli bir panorama kimliğidir. Panoramaların kimliği zaman içinde değişebilir, bu nedenle bu kimliği saklamayın. Bunun yerine, panorama kimliğini yenileyebilmek için konumun adresini veya enlem ve boylam koordinatlarını kaydedin. Ayrıntılar için Silinen panorama kimliklerini yenileme bölümüne bakın.
Ayrıca:
size, resmin çıkış boyutunu piksel cinsinden belirtir. Boyut,{width}x{height}olarak belirtilir. Örneğin,size=600x400değeri 600 piksel genişliğinde ve 400 piksel yüksekliğinde bir resim döndürür.key, Google Cloud Console'da uygulamanızın API kullanımını izlemenize olanak tanır ve Google'ın gerekirse uygulamanız hakkında sizinle iletişime geçebilmesini sağlar. Daha fazla bilgi edinmek için Anahtar ve İmza alma başlıklı makaleyi inceleyin.
Silinen panorama kimliklerini yenile
Bir panorama kimliği almaya çalışır ve ZERO_RESULTS değerini görürseniz ya da hiç değer elde etmezseniz panorama kimliği silinmiştir ve yenilenmesi gerekir.
Gerektiğinde yenileyebilmek için panorama kimliği almak için kullandığınız konum adresini veya enlem ve boylam koordinatlarını kaydedin.
Bir panorama kimliğinin değiştiğini tespit ettiğinizde, bu konuma en yakın panoramaları tekrar aramak ve yeni bir panorama kimliği almak için orijinal konum adresini veya enlem ve boylam koordinatlarını kullanın.
İsteğe bağlı parametreler
signature(önerilir), API anahtarınızı kullanarak istek oluşturan tüm sitelerin bu işlemi gerçekleştirme yetkisine sahip 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 edinmek için Anahtar ve İmza alma başlıklı makaleyi inceleyin.Not: Eski Google Haritalar Platformu Premium Plan müşterileri için dijital imza gerekir. Premium Plan müşterileri için kimlik doğrulama parametreleri hakkında daha fazla bilgi edinin.
heading, kameranın pusula istikametini belirtir.0ile360arasındaki değerler kabul edilir (her iki değer de Kuzey,90değeri Doğu ve180Güney değerini belirtir). Yön belirtmezseniz en yakın fotoğrafın çekildiği noktadan kamerayı belirtilenlocationyönüne yönlendiren bir değer hesaplanır.fov(varsayılan:90), derece cinsinden ifade edilen resmin yatay görüş alanını belirler ve izin verilen maksimum değer120olur. Belirli bir boyutun Street View resminde olduğu gibi, sabit boyutlu görüntü alanı söz konusu olduğunda özünde görüş alanı yakınlaştırmayı temsil ederken daha küçük sayılar daha yüksek bir yakınlaştırma düzeyini belirtir.
(Sol:fov=120; Sağ:fov=20)pitch(varsayılan değer:0), kameranın Street View aracıyla göreceli yukarı veya aşağı açısını belirtir. Bu, her zaman olmasa da çoğu zaman 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ğı (-90) dimdik aşağıyı belirtir.radius(varsayılan:50) verilen enlem ve boylama göre ortalanmış bir panorama aranacağı, metre cinsinden belirtilen bir yarıçap belirler. Geçerli değerler, negatif olmayan tam sayılardır.return_error_code, resim bulunamadığında (404 NOT FOUND) veya geçersiz bir isteğe yanıt olarak (400 BAD REQUEST) API'nin hata kodu döndürmesi gerektiğini belirtir. Geçerli değerlertruevefalsedeğerleridir.truedeğerine ayarlanırsa genel gri resmin 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ı yapılması gerekmez.source(varsayılan: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. Belirtilen konum için açık hava panoramalarının mevcut olmayabileceğini unutmayın. Ayrıca, aramanın yalnızca kapalı mı yoksa açık mı olduğunun belirlenmesinin mümkün olduğu durumlarda panoramaları döndürdüğünü de unutmayın. Örneğin, içeride mi yoksa açık alanda mı oldukları bilinmediğinden, Photo Spheres döndürülmez.
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 kullanılamadığı konumlar için Street View Static API'si, aşağıdaki örnekte gösterildiği gibi "Maalesef burada görüntü yok" metniyle 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österildiğinden emin olmak için aşağıdaki önerileri uygulayın:
return_error_codeparametresinitrueolarak ayarlayın. Bu durum, belirtilen konum için herhangi bir görüntü yoksa Street View Static API'nin genel gri resim yerine 404 NOT FOUND hatası döndürmesine neden olur.- İstek gönderilmeden önce, belirtilen konum için görüntü olup olmadığını belirlemek amacıyla Street View görüntü meta verileri talep edin.