Street View Resmi Meta Verileri

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ı kullanın. Örneğin, Silinen panorama kimliklerini yenileme başlıklı makaleyi inceleyin.

Ayrıca:

  • key ve signature - 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.

  1. Daha önce kullandığınız konum adresini ya da enlem ve boylam koordinatlarını kaydedin bir panorama kimliği alabilirsiniz.

  2. Bir panorama kimliğinin değiştiğini tespit ettiğinizde orijinal konumu kullanın adresini 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
.
Eyfel Kulesi

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
.
Burada Görüntü Yok Yer Tutucusu

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ı.