Street View isteği ve yanıtı

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. 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, OH gibi) veya enlem ve boylam koordinat çifti (40.457375,-80.009353) olabilir ve URL olarak kodlanmalıdır. Bu nedenle, isteği göndermeden önce "Belediye Binası, New York, NY" gibi adresleri "Şehir+Hall,İstanbul, Türkiye"ye dönüştürün. Street View Static API, konuma en yakın panorama fotoğrafına tutturur. 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 için 50 metrelik bir yarıçapta arama yapar. Street View görüntüleri düzenli olarak yenilendiği ve fotoğraflar her seferinde biraz farklı konumlardan çekilebileceği için, görüntüler güncellendiğinde location cihazınız farklı bir panoramaya yansıtılabilir.

veya:

• pano belirli bir panorama kimliğidir. Panoramaların kimliği zamanla değişebilir. Bu nedenle, bu kimliği saklamayı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 çı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, Google Cloud Console'da uygulamanızın API kullanımını izlemenize ve Google'ın gerektiğinde uygulamanız hakkında sizinle iletişime geçebilmesine olanak tanır. 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 hiçbir değer almazsanız panorama kimliği silinmiş ve yenilenmesi gerekiyor.

1. Panorama kimliği almak için kullandığınız konum adresini veya enlem ve boylam koordinatlarını kaydedin. Böylece gerektiğinde sayfayı yenileyebilirsiniz.

2. Bir panorama kimliğinin değiştiğini tespit ettiğinizde orijinal konum adresini ya da enlem ve boylam koordinatlarını kullanarak söz konusu konuma en yakın panoramaları yeniden arayabilir ve yeni bir panorama kimliği alabilirsiniz.

İsteğe bağlı parametreler

• signature (önerilir), API anahtarınızı kullanarak istek oluşturan tüm sitelerin buna yetkili olduğunu doğrulamak için kullanılan 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ı makaleye göz atı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ü belirtir. 0 ile 360 arasındaki değerler kabul edilir (her iki değer de Kuzey, 90 değeri Doğu ve 180 Güneyi belirtir). Yön belirtmezseniz kamerayı en yakın fotoğrafın çekildiği noktadan belirtilen location yönüne yönlendiren bir değer hesaplanır.
• fov (varsayılan ayar: 90), resmin yatay görüş alanını derece cinsinden ifade edilen ve izin verilen maksimum değer 120 olacak şekilde belirler. 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ı, özünde yakınlaştırmayı temsil eder. Küçük sayılar ise daha yüksek bir yakınlaştırma düzeyini gösterir.

  
  
  (Sol: fov=120; Sağ: fov=20)

• pitch (varsayılan ayar: 0), kameranın Street View aracına göre yukarı veya aşağı açısını belirtir. Bu, her zaman olmasa da genellikle düz yataydır. Pozitif değerler kamera açısını yukarı (90 derece dik yukarıyı belirtir), negatif değerler kamera açısını aşağı (-90 değeri dimdik aşağıyı belirtir) doğru döndürür.
• radius (varsayılan değer: 50), metre cinsinden belirtilen, belirtilen enlem ve boylama ortalanmış şekilde bir panorama aranacağı yarıçapı belirler. Geçerli değerler, negatif olmayan tam sayılardır.
• return_error_code, API'nin görüntü bulunamadığında (404 BULUNAMADI) mı yoksa geçersiz isteğe (400 BAD REQUEST) yanıt olarak mı hata kodu döndürmesi gerektiğini belirtir. Geçerli değerler true ve false değerleridir. true olarak 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ı yapma ihtiyacı ortadan kalkar.
• 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. Belirtilen konum için dış mekan panoramalarının mevcut olmayabileceğini unutmayın. Ayrıca, aramanın yalnızca, iç mekanda mı yoksa açık mı olduğunun belirlenmesinin mümkün olduğu durumlarda panoramaları döndürdüğünü unutmayın. Örneğin, iç mi yoksa açık mı oldukları bilinmediği için PhotoSphere'ler 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 bulunmadığı konumlar için Street View Static API'si şu örnekte gösterildiği gibi, "Maalesef burada görüntü yok" metnini içeren gri genel bir 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_code parametresini true olarak ayarlayın. Bu durum, belirtilen konum için kullanılabilir 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 için Street View resim meta verilerini isteyin.