Bu sayfa, Cloud Translation API ile çevrilmiştir.

Street View Resmi Meta Verileri

Giriş

Street View Static API meta veri istekleri, Street View panoramaları hakkında veri sağlar. Meta verileri kullanarak, bir Street View resminin belirli bir konumda mevcut olup olmadığını öğrenebilir, ayrıca enlem ve boylam koordinatları, panorama kimliğine, fotoğrafın çekildiği tarih ve resimle ilgili telif hakkı bilgilerine programlı erişim elde edebilirsiniz. Bu meta verilere erişmek uygulamanızdaki hata davranışını özelleştirmenize olanak tanır.

Street View Static API meta veri istekleri ücretsiz olarak sunulur. Meta veri isteğinde bulunduğunuzda kota harcanmaz. Kota yalnızca Street View Static API ile görüntü yüklediğinizde tüketilir.

Street View görüntüsü meta verisi isteklerinde bulunurken panorama görüntüleri 50 metreye kadar doğru olur.

Görüntü meta verilerine erişme

Bir Street View resim meta verisi 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" (&) 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 gerekli olur:

Şu yöntemlerden birini kullanın:

location, bir metin dizesi (Chagrin Falls, OH gibi) veya virgülle ayrılmış bir enlem ve boylam koordinatı çifti (40.457375,-80.009353) olabilir.

veya:

pano: Belirli bir panorama kimliği. Panoramaların kimlikleri zaman içinde 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 bölümüne bakın.

Ayrıca:

key ve signature: İsteğin kimliğini doğrulamak için API anahtarı gerekir. Dijital imza da belirli durumlarda gereklidir ve her zaman önerilir. Daha fazla bilgi için Anahtar ve İmza Alma bölümüne bakın.

Yalnızca gerekli parametreler 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=

veya aşağıdaki gibi:

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

Silinen panorama kimliklerini yenile

Bir panorama kimliği almaya çalışırken ZERO_RESULTS veya hiç değer almazsanız panorama kimliği silinmiştir ve yenilenmesi gerekir.

Gerektiğinde yenileyebilmeniz 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, 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.

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 bulunan panoramayı 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 isteklerinde API, isteğe bağlı parametreleri ve değerlerini yok sayar. Bu parametreleri kullanma 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ı panoramanın meta verilerini ve resmini başarıyla istiyor.

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 resmin beklendiği yerde 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

2. Örnek: Panorama bulunamadı

Aşağıdaki URL'ler, belirtilen konumda veya bu konumun yakınında bulunamayan bir panoramaya ait meta verileri ve resmi istiyor.

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

Durum kodları

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

Durum	Açıklama
`"OK"`	Herhangi bir hata oluşmadığını belirtir; bir panorama bulundu ve meta veriler döndürülür.
`"ZERO_RESULTS"`	Sağlanan konumun yakınında herhangi bir panoramanın bulunamadığını belirtir. Mevcut olmayan veya geçersiz bir panorama kimliği sağlarsanız bu yanıt oluşabilir. [Silinen panorama kimliklerini yenileme](#refresh-pano) konusuna bakın.
`"NOT_FOUND"`	`location` parametresinde sağlanan adres dizesinin bulunamadığını belirtir. Var olmayan bir adres verilirse bu mesaj gösterilebilir.
`"OVER_QUERY_LIMIT"`	Bu API için günlük kotanızı veya saniye başına kotanızı aştığınızı belirtir.
`"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örünebilir.
`"INVALID_REQUEST"`	Genellikle, sorgu parametrelerinin (adres, enlem ve boylam koordinatları veya bileşenler) eksik olduğunu belirtir.
`"UNKNOWN_ERROR"`	Sunucu hatası nedeniyle isteğin işlenemediğini belirtir. Bu sorun genellikle geçicidir. Tekrar denerseniz istek başarılı olabilir.

Daha fazla bilgi

Street View Static API'sini veya diğer Google Maps API ürünlerini kullanmayla ilgili daha fazla bilgi için Maps API Destek sayfasına göz atmayı unutmayın.