Street View isteği ve yanıtı

Street View görüntü 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 (&) 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 koordinatları çifti (40.457375,-80.009353) olabilir ve URL kodlu 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 yerleşir. 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 metre yarıçaplı bir alanda arama yapar. Street View görüntüleri düzenli olarak yenilendiğinden ve fotoğraflar her seferinde biraz farklı konumlardan çekilebildiğinden, görüntüler güncellendiğinde location işaretinizin farklı bir panoramaya tutturulması mümkündür.

veya:

• pano, belirli bir panorama kimliğidir. Panoramaların kimliği zaman içinde değişebilir. Bu nedenle, bu kimliği kalıcı hale getirmeyin. 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=600x400, 600 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ızla ilgili olarak 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ğini almaya çalıştığınızda ZERO_RESULTS veya değer yok yanıtını alırsanız panorama kimliği silinmiş demektir ve yenilenmesi gerekir.

1. Gerektiğinde yenileyebilmek için panorama kimliği almak üzere kullandığınız konum adresini veya enlem ve boylam koordinatlarını kaydedin.

2. 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 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 yönünü gösterir. Kabul edilen değerler 0 ile 360 arasındadır (her iki değer de Kuzey'i gösterir. 90 Doğu'yu, 180 ise Güney'i gösterir). Başlık belirtmezseniz en yakın fotoğrafın çekildiği noktadan başlayarak kamerayı belirtilen location yönüne çeviren bir değer hesaplanır.
• fov (varsayılan değer 90) görüntünün yatay görüş alanını derece cinsinden belirler. İzin verilen maksimum değer 120'dir. Sabit boyutlu bir görünüm penceresiyle (ör. belirli bir boyuttaki Street View görüntüsü) çalışırken görüş alanı aslında 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ğer 0) kameranın Street View aracına göre yukarı veya aşağı açısını belirtir. Bu genellikle düz ve yataydır ancak her zaman böyle olmayabilir. Pozitif değerler kamerayı yukarı doğru (90 derece düz yukarıyı gösterir), negatif değerler ise aşağı doğru (-90 derece düz aşağıyı gösterir) açılı hale getirir.
• radius (varsayılan değer 50) belirtilen enlem ve boylamda ortalanmış bir panorama aramak için metre cinsinden belirtilen bir yarıçap ayarlar. 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) hata kodu döndürüp döndürmeyeceğini gösterir. Geçerli değerler true ve false'dir. true olarak ayarlanırsa genel gri resim yerine bir hata mesajı döndürülür. Bu sayede, resim kullanılabilirliğini kontrol etmek için ayrı bir arama yapmanız gerekmez.
• source (varsayılan default) Street View aramalarını seçilen kaynaklarla sınırlar. 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ırlar. Kapalı mekan koleksiyonları arama sonuçlarına dahil edilmez. Belirtilen konum için dış mekan panoramalarının mevcut olmayabileceğini unutmayın. Ayrıca, arama yalnızca kapalı veya açık alan olup olmadığı belirlenebilen panoramaları döndürür. Örneğin, Photo Sphere'ler iç veya dış mekanda çekilip çekilmediği bilinmediği için 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 bulunmadığı konumlarda 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_code parametresini true olarak ayarlayın. Bu durum, belirtilen konum için resim yoksa Street View Static API'nin genel gri resim yerine 404 NOT FOUND 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 verileri isteğinde bulunun.