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ünün olup olmadığını öğrenebilir, 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şerek uygulamanızdaki hata davranışını özelleştirebilirsiniz.

Street View Static API meta veri istekleri ücretsizdir. 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ü meta verileri istekleri gönderilirken 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 (&) 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 zaman içinde kimlik değiştirebilir. Bu nedenle, bu kimliği kalıcı hale getirmeyin. 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ı gerekir. Dijital imza bazı durumlarda zorunlu, her zaman ise ö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 şu şekilde 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ıştığınızda ZERO_RESULTS veya değer yok yanıtını alırsanız panorama kimliği silinmiş demektir 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, 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, panorama hakkındaki 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 dahil edilmesine izin verir. Ancak meta veri istekleri için API, isteğe bağlı parametreleri ve değerlerini yoksayar. Bu parametreleri kullanma hakkında bilgi edinmek için Street View Static API geliştirici kılavuzu'na 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 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 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 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 Sokak Görünümü 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:

Daha fazla bilgi

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