Street View Resmi Meta Verileri

Giriş

Street View Static API meta veri istekleri, Street View panoramaları hakkında veri sağlar. Meta verileri kullanarak belirli bir konumda Street View görüntüsü olup olmadığını öğrenebilir, ayrıca enlem ve boylam koordinatlarına, panorama kimliğine, fotoğrafın çekildiği tarihe ve görüntünün telif hakkı bilgilerine programatik olarak erişebilirsiniz. Bu meta verilere erişmek, uygulamanızdaki hata davranışını özelleştirmenize olanak tanır.

Street View Static API meta veri istekleri ücretsiz olarak kullanılabilir. Meta veri istediğinizde kota tüketilmez. Kota yalnızca Street View Static API'yi kullanarak bir resim yüklediğinizde kullanılır.

Street View görüntüleri meta veri istekleri yapılırken panorama görüntüleri 50 metreye kadar doğru olur.

Görüntü meta verilerine erişme

Street View görüntü meta verileri isteği, aşağıdaki biçimde bir HTTP URL'sidir:

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

URL'lerde standart olduğu gibi, tüm parametreler ve işareti (&) karakteri kullanılarak ayrılır.

Meta veri istekleri için gerekli parametreler

Meta veri istekleri, Street View Static API görüntü istekleriyle aynı URL parametrelerini kabul eder ancak yalnızca aşağıdaki parametreler gereklidir:

Şu iki yöntemden birini kullanın:

  • location: Metin dizesi (ör. Chagrin Falls, OH) veya virgülle ayrılmış enlem ve boylam koordinatları çifti (40.457375,-80.009353) olabilir.

veya:

  • pano: Belirli bir panorama kimliği. Panoramaların kimlikleri zaman içinde değişebileceğinden 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:

  • key ve signature: İsteğin kimliğini doğrulamak için API anahtarı gereklidir. Dijital imza da belirli durumlarda gereklidir ve her zaman önerilir. Daha fazla bilgi için Anahtar ve İmza Alma başlıklı makaleyi inceleyin.

Yalnızca gerekli parametreleri içeren meta veri isteğiniz aşağıdaki gibi görünür:

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

veya şu şekilde:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

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.

  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, 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.

Meta veri istekleri için isteğe bağlı parametreler

Meta veri isteğinize şu parametreleri ekleyebilirsiniz: size, heading, fov ve pitch. Bu parametrelerin panoramayla ilgili verileri veya hangi panoramanın bulunacağını etkilemediğini unutmayın. API, belirli bir görüntü isteğiyle ilgili meta veri isteği oluşturmayı kolaylaştırmak için görüntü isteğiyle aynı parametrelerin eklenmesine olanak tanır. Ancak meta veri istekleri için API, isteğe bağlı parametreleri ve değerlerini yoksayar. Bu parametrelerin kullanımı hakkında bilgi edinmek için Street View Static API geliştirici kılavuzuna bakın.

Yanıt biçimi

Meta veri yanıtları yalnızca JSON biçiminde döndürülür.

Örnekler

1. örnek: Panorama bulundu

Aşağıdaki URL'ler, aynı panoramaya ait meta verileri ve resmi başarıyla ister.

Meta veri isteği ve yanıtı

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
 
{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

Eksik görüntünün beklendiği görüntü isteği ve yanıtı.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Eyfel Kulesi

2. örnek: Panorama bulunamadı

Aşağıdaki URL'ler, belirtilen konumda veya yakınında bulunamayan bir panoramayla ilgili meta verileri ve resmi ister.

Meta veri isteği ve yanıtı

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
 
{
   "status" : "ZERO_RESULTS"
}

Görüntü isteği ve yanıtı

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
No Imagery Here Placeholder

Durum kodları

Meta veri yanıt nesnesindeki status alanı, isteğin durumunu içerir ve Street View isteğinin neden çalışmadığıyla ilgili sorunları gidermenize yardımcı olacak hata ayıklama bilgilerini içerebilir. status alanı aşağıdaki değerleri içerebilir:

Durum Açıklama
"OK" Hata oluşmadığını, bir panoramik görüntü bulunduğunu ve meta verilerin döndürüldüğünü gösterir.
"ZERO_RESULTS" Belirtilen konumun yakınında panorama bulunamadığını gösterir. Mevcut olmayan veya geçersiz bir panorama kimliği sağlarsanız bu yanıtı alabilirsiniz. [Silinen panorama kimliklerini yenileme](#refresh-pano) bölümüne bakın.
"NOT_FOUND" location parametresinde sağlanan adres dizesinin bulunamadığını gösterir. Bu mesaj, mevcut olmayan bir adres verildiğinde gösterilebilir.
"OVER_QUERY_LIMIT" Bu API için günlük kotanızı veya saniye başına kotanızı aştığınızı gösterir.
"REQUEST_DENIED" İsteğinizin reddedildiğini gösterir. Bu mesaj, isteğinizi yetkilendirmediyseniz veya API anahtarınızı içeren Google Cloud Console projesinde Street View Static API etkinleştirilmemişse gösterilebilir.
"INVALID_REQUEST" Genellikle sorgu parametrelerinin (adres, enlem ve boylam koordinatları veya bileşenler) eksik olduğunu gösterir.
"UNKNOWN_ERROR" İsteğin bir sunucu hatası nedeniyle işlenemediğini gösterir. Bu sorun genellikle geçicidir. Tekrar denerseniz istek başarılı olabilir.

Daha fazla bilgi

Street View Static API veya diğer Google Maps API ürünlerini kullanma hakkında daha fazla bilgi için Maps API Destek sayfasını inceleyin.