Street View Image 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" 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 (ör.Chagrin Falls, OH) veya enlem ve boylam koordinat çifti (40.457375,-80.009353) olabilir ve URL kodlamalı olmalıdır. Bu nedenle, isteği göndermeden önce "City Hall, New York, NY" gibi adresleri "City+Hall,New+York,NY" olarak dönüştürün. Street View Static API, konuma en yakın panorama fotoğrafına geçer. 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 için 50 metrelik bir yarıçapta 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öğeniz farklı bir panoramaya tutturulabilir.
veya:
pano, belirli bir panorama kimliğidir. Panoramaların kimliği zaman içinde değişebilir. Bu nedenle, bu kimliği kalıcı olarak kullanmayın. Bunun yerine, panorama kimliğini yenileyebilmek için konum adresini veya enlem ve boylam koordinatlarını kaydedin. Ayrıntılı bilgi için Silinen panorama kimliklerini yenileme başlıklı makaleyi inceleyin.
Ayrıca:
size, resmin çıkış boyutunu piksel cinsinden 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 gerektiğinde Google'ın uygulamanızla ilgili olarak sizinle iletişime geçebilmesini sağlar. Daha fazla bilgi için Anahtar ve imza alma bölümüne bakın.
Silinen panorama kimliklerini yenileme
Bir panorama kimliğini almaya çalışır ve ZERO_RESULTS veya boş değer alırsanız panorama kimliği silinmiştir ve yenilenmesi gerekir.
Gerektiğinde yenileyebilmek için panorama kimliği almak üzere kullandığınız konum adresini veya enlem ve boylam koordinatlarını kaydedin.
Bir panorama kimliğinin değiştiğini tespit ettiğinizde, o 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 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 imza alma bölümüne bakın.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 yönünü gösterir. Kabul edilen değerler0ile360arasındadır (her iki değer de kuzeyi,90doğuyu ve180güneyi gösterir). Yön belirtmezseniz kamerayı en yakın fotoğrafın çekildiği noktadan belirtilenlocationdeğerine yönlendiren bir değer hesaplanır.fov(varsayılan değer90), görüntünün derece cinsinden ifade edilen yatay görüş alanını belirler. İzin verilen maksimum değer120'dir. Belirli bir boyuttaki Street View görüntüsünde olduğu gibi sabit boyutlu bir görüntü alanıyla çalışırken görüş alanı, esasen 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ına göre yukarı veya aşağı açısını belirtir. Bu genellikle düz yataydır ancak her zaman böyle olmayabilir. Pozitif değerler kamerayı yukarı doğru açılı hale getirir (90derece tam yukarıyı gösterir); negatif değerler kamerayı aşağı doğru açılı hale getirir (-90tam aşağıyı gösterir).radius(varsayılan değer50), belirtilen enlem ve boylamı merkez alan bir panoramayı aramak için metre cinsinden belirtilen bir yarıçap ayarlar. Geçerli değerler, negatif olmayan tam sayılardır.return_error_code, resim bulunamadığında (404 Bulunamadı Hatası) veya geçersiz bir isteğe yanıt olarak (400 HATALI İSTEK) API'nin 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ünün kullanılabilirliğini kontrol etmek için ayrı bir çağrı yapmanız gerekmez.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ı dış mekan koleksiyonlarıyla sınırlandırır. İç mekan koleksiyonları arama sonuçlarına dahil edilmez. Belirtilen konum için dış mekan panoramaları olmayabilir. Ayrıca, aramanın yalnızca iç mekan veya dış mekan olduğu belirlenebilen panoramaları döndürdüğünü unutmayın. Örneğin, iç mekanda mı yoksa dış mekanda mı olduğu bilinmediği için PhotoSphere'ler döndürülmez.
Bu bir örnek 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ığı yerlerde Street View Static API, aşağıdaki örnekte gösterildiği gibi "Maalesef burada görüntümüz 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, belirtilen konum için resim yoksa Street View Static API'nin genel gri resim yerine 404 BULUNAMADI hatası döndürmesine neden olur.- İstek göndermeden önce belirtilen konum için görüntü olup olmadığını belirlemek üzere Street View görüntü meta verilerini isteyin.