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

Street View Resmi Meta Verileri

Giriş

Street View Static API meta veri istekleri, Street View panoramalarıyla ilgili veriler sağlar. Meta verileri kullanarak belirli bir konumda Street View görüntüsünün olup olmadığını öğrenebilir, ayrıca enlem ve boylam koordinatlarına, panorama kimliğine, fotoğrafın çekildiği tarihe ve resmin 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 ücretsizdir. Meta veri isteğinde bulunduğunuzda kota kullanılmaz. Teklif kotası yalnızca Street View Static API kullanılarak bir resim yüklendiğinde tüketilir.

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

Görüntü meta verilerine erişme

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

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

URL'lerde standart olarak 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ü istekleri ile aynı URL parametrelerini kabul eder. Ancak yalnızca aşağıdaki parametreler gereklidir:

Şu iki yöntemden birini kullanın:

location: 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şebileceğinden bu kimliği kalıcı yapmayı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:

key ve signature: İsteğin kimliğini doğrulamak için API anahtarı gerekir. Dijital imza, belirli durumlarda zorunludur 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 şöyle görünür:

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

veya şu şekilde:

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

Silinen panorama kimliklerini yenileme

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

Panorama kimliği almak için kullandığınız konum adresini veya enlem ve boylam koordinatlarını kaydedin. Böylece, gerektiğinde yenileyebilirsiniz.
Bir panorama kimliğinin değiştiğini tespit ettiğinizde, orijinal konum adresini veya enlem ve boylam koordinatlarını kullanarak söz konusu konuma en yakın panoramaları tekrar arayın ve yeni bir panorama kimliği alın.

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

Meta veri isteğinize aşağıdaki 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 bir meta veri isteği oluşturmayı kolaylaştırmak için görüntü isteği ile aynı parametrelerin dahil edilmesine izin verir ancak meta veri isteklerinde 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ı panoramanın meta verilerini ve resmini 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 resmin 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

2. Örnek: Panorama bulunamadı

Aşağıdaki URL'ler, belirtilen konumda veya yakınında bulunamayan bir panoramanın meta verilerini ve resmini 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

Durum kodları

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

Durum	Açıklama
`"OK"`	Hata olmadığını, bir panorama bulunduğunu ve meta verilerin döndürüldüğünü gösterir.
`"ZERO_RESULTS"`	Sağlanan konumun yakınında panorama bulunamadığını gösterir. Bu yanıt, var olmayan veya geçersiz bir panorama kimliği gönderirseniz gösterilebilir. [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, var olmayan bir adres girildiğ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 Statik 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, 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'nin veya diğer Google Haritalar API ürünlerinin kullanımı hakkında daha fazla bilgi için Haritalar API Destek sayfasını inceleyin.