Giriş
Street View Static API meta veri istekleri Street hakkında veri sağlar. Panoramaları göster. Meta verileri kullanarak, bir Street View görüntüsünün erişilebilir olduğu gibi programlı erişim de enlem ve boylam koordinatları, panorama kimliği, fotoğrafın çekildiği tarih ve resmin telif hakkı bilgilerini içerir. Erişim meta veriler, uygulamanızdaki hata davranışını özelleştirmenizi sağlar.
Street View Static API meta veri istekleri şarj edin. Meta veri isteğinde bulunduğunuzda hiçbir kota kullanılmaz. Kota yalnızca Street View Static API.
Street View görüntüleri meta verisi isteğinde bulunurken, panorama görüntülerinin kullanılması 50 metreye kadar doğruluk oranı vardı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" işareti kullanılarak ayrılır. (&) karakteri ekleyin.
Meta veri istekleri için gerekli parametreler
Meta veri istekleri, aynı URL parametreleri Street View Static API görüntü istekleri gibi şu parametreler gereklidir:
Şu iki yöntemden birini kullanın:
location
— bir metin dizesi (Chagrin Falls, OH
gibi) olabilir veya virgülle ayrılmış bir enlem ve boylam koordinatları çifti (40.457375,-80.009353
)
veya:
pano
— belirli bir panorama kimliği. Panoramaların kimliği zamanla değişebilir. bu kimliği kullanmayın. Bunun yerine, konum adresini kaydedin veya Panorama kimliğini yenileyebilmek için enlem ve boylam koordinatlarını girin. Örneğin, Silinen panorama kimliklerini yenileme başlıklı makaleyi inceleyin.
Ayrıca:
key
vesignature
- isteği gönderin. Dijital imza bazı durumlarda da gereklidir. her zaman önerilir. Daha fazla bilgi için bkz. Anahtar ve İmza alın.
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
değer yoksa panorama kimliği silinir ve yenilenmesi gerekir.
Daha önce kullandığınız konum adresini ya da enlem ve boylam koordinatlarını kaydedin bir panorama kimliği alabilirsiniz.
Bir panorama kimliğinin değiştiğini tespit ettiğinizde orijinal konumu kullanın adresi veya enlem/boylam koordinatlarını 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
veya panoramanın bulunduğu yerleri görebilirsiniz.
API,
görüntü isteği
belirli bir görüntüyle ilgili meta veri isteği oluşturmayı kolaylaştırmak için
isteğini yerine getirir ancak meta veri istekleri için API isteğe bağlı parametreleri
değerlerini daha iyi anlayacaksınız. Bu parametreleri kullanma hakkında bilgi için
Street View Static API geliştirici kılavuzu.
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ı sitenin meta verilerini ve resmini başarıyla istiyor. bir plan yapın.
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 bir panoramanın meta veri ve resmini talep ediyor. belirtilen konumda veya yakınında bulunamadı.
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ı,
ve hata ayıklamanıza yardımcı olacak hata ayıklama bilgilerini içerebilir
Street View isteğinin neden çalışmadığını gösterir. status
alanı şunları içerebilir:
şu değerler:
Durum | Açıklama |
---|---|
"OK" |
Herhangi bir hata oluşmadığını belirtir; bir panorama bulunur ve meta veriler geri döndü. |
"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 içinde sağlanan adres dizesini belirtir
parametresi bulunamadı. Mevcut olmayan bir adres varsa bu mesaj gösterilebilir
verilir. |
"OVER_QUERY_LIMIT" |
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, şu işlemi yaptıysanız ortaya çıkabilir: isteğiniz yetkilendirilmezse Street View Static API şurada etkinleştirilmedi: API anahtarınızı içeren Google Cloud Console projesi. |
"INVALID_REQUEST" |
Genellikle, sorgu parametrelerinin (adres, enlem ve boylam koordinatları veya bileşenleri) eksiktir. |
"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 kullanma hakkında daha fazla bilgi için veya diğer Google Maps API ürünleri varsa, mutlaka Maps API'ye göz atmayı unutmayın. Destek sayfası.