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 kullanılabilir 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ştirmenizi sağlar.

Street View Static API meta veri istekleri ücretsiz olarak kullanılabilir. Meta veri isteğinde bulunduğunuzda hiçbir kota kullanılmaz. Kota yalnızca Street View Static API'yi kullanarak resim yüklediğinizde kullanılır.

Street View görüntülerine ilişkin meta veri isteklerinde bulunulduğunda, panorama görüntüleri 50 metreye kadar doğruluktadır.

Görüntü meta verilerine erişme

Street View resim meta verisi isteği, aşağıdaki biçimdeki 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 etse de yalnızca aşağıdaki parametreler gereklidir:

Şu yöntemlerden birini kullanın:

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

veya:

pano — belirli bir panorama kimliği. Panoramaların kimliği zamanla değişebilir. Bu nedenle bu kimliği kullanmayı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ı gereklidir. Ayrıca bazı durumlarda dijital imza gerekir ve her zaman önerilir. Daha fazla bilgi için Anahtar ve İmza alma başlıklı makaleyi inceleyin.

Yalnızca gerekli parametrelerle birlikte meta veri isteğiniz şöyle 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çbir değer almazsanız panorama kimliği silinmiş ve yenilenmesi gerekiyor.

Panorama kimliği almak için kullandığınız konum adresini veya enlem ve boylam koordinatlarını kaydedin. Böylece gerektiğinde sayfayı yenileyebilirsiniz.
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.

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 bulunduğunu 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 bunların değerlerini yok sayar. Bu parametreleri kullanma hakkında bilgi 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 görüntüsünü başarıyla talep etmektedir.

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 olması beklenen 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 panoramanın meta veri ve resmini talep ediyor.

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. Ayrıca Street View isteğinin çalışmamasının nedenini gidermenize yardımcı olacak hata ayıklama bilgilerini içerebilir. status alanı aşağıdaki değerleri içerebilir:

Durum	Açıklama
`"OK"`	Herhangi bir hata oluşmadığını belirtir. Bir panorama bulunur ve meta veri döndürülür.
`"ZERO_RESULTS"`	Belirtilen konumun yakınında hiçbir panoramanın bulunamadığını gösterir. Bu yanıt, var olmayan veya geçersiz bir panorama kimliği sağladığınızda meydana gelebilir. [Silinen panorama kimliklerini yenileme](#refresh-pano) bölümüne göz atı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ı 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'yi 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"`	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'yi veya diğer Google Maps API ürünlerini kullanma hakkında daha fazla bilgi edinmek için Maps API Destek sayfasına göz atmayı unutmayın.