Street View Kutuları

Street View örneğiStreet View kartları şuna benzer: 2D Karolar Bunun tek farkı, sokak düzeyinde çekilen panoramik görüntülerdir. Entegre Street View ile dünyanın önemli noktalarını ve doğa harikalarını keşfedebilir, müze, arena, restoran veya küçük işletmeler gibi yerlerin içinde Bu API uç noktası şunlara erişmenizi sağlar:

  • Google Haritalar Street View Karoları
  • Street View meta verileri
  • Street View küçük resimleri

Sokak düzeyinden alınan resim karolarını birleştirerek Gerçek panoramik panoramik efekt. Bir grup için 100 panorama kimliğini sorgulayabilirsiniz. konuma (güzergâh gibi) ait veriler sunar ve kamera ile ilgili daha ayrıntılı meta veriler elde edersiniz. dokunun.

Görüntüleyicinin Street View karolarını birleştirmesi gerekir. Örneğin, Street View özel panorama görüntüleyici.

API anahtarınız olduğunda, aşağıdakileri yaparak Street View görüntülerine erişebilirsiniz: lütfen unutmayın.

  1. Oturum jetonu alın. Emin olun kullanarak mapType değerini streetview olarak ayarlayın.

  2. Oturum jetonunu şu amaçlarla kullanın: Bir veya daha fazla coğrafyanın panaronize tanımlayıcısını (panoId) alın yerler.

  3. panoId arama yanıtındaki panorama tanımlayıcılarını kullanarak şunları elde edebilirsiniz:

    1. Street View meta verileri. Ayrıca şunu da alabilirsiniz: Bir dizi koordinat ve yarıçap geçirerek meta verileri görüntüleyin.

    2. Street View küçük resimleri.

    3. Street View Karoları.

Street View yöntemleri

Aşağıdakilerden birini arayarak Street View görüntülerine ve meta verilerine erişebilirsiniz dört yöntem.

Yöntem Açıklama
https://tile.googleapis.com/v1/streetview/tiles Tek tek Street View Karolarını döndürür. Street View karolarını altı yakınlaştırma düzeyinde alabilirsiniz: 512 pikselden 13.312 piksele kadar.
https://tile.googleapis.com/v1/streetview/panoIds 100 adede kadar konum için toplu arama yapmanıza olanak tanır. Görüntü içeren tüm konumların panorama kimliklerini döndürür.
https://tile.googleapis.com/v1/streetview/thumbnail Bir Street View sahnesinin küçük resim JPEG resmini döndürür. Başlık, sunum, boyutlar ve görüş alanı sağlamanıza olanak tanır. Minimum boyutlar 16x16 pikseldir. Maksimum boyutlar 250x600 pikseldir.
https://tile.googleapis.com/v1/streetview/metadata Belirtilen panorama hakkında ayrıntılı bilgi verir. Ayrıntılar, ilgili adresi ve bitişik panoramaların bağlantılarını içerir.

Bir veya daha fazla coğrafi konumun panorama tanımlayıcısını koordinatlarını (lat, lng) panoIds yöntemine geçirerek. İstek body, bir locations dizisi ve isteğe bağlı olarak bir radius gibi, aşağıdaki JSON kodu örneğinde gösterildiği gibidir.

curl -X POST -d '{
  "locations": [
    {"lat": -33.883837, "lng": 151.209307},
    {"lat": -33.883700, "lng": 151.210307},
    {"lat": 0, "lng": 0}
  ],
  "radius": 50
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/streetview/panoIds?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY"
locations
locations dizisi, en az bir koordinat değerleri grubu içermelidir ancak en fazla 100 tane olmak üzere daha fazla ekleyebilirsiniz.
radius
radius değeri (metre cinsinden ölçülür) dairenin yarıçapını tanımlar panorama araması yapmak için belirli bir konumun çevresine bakın. Varsayılan değer 50 metre.

PanoId yanıtı

Map Tiles API, her konuma en yakın panoramayı bulmaya çalışır ve panorama kimliklerini döndürür. Başarılı bir panoIds isteği, panoIds dizisi içeren JSON nesnesi. Dizi, şunları içeren bir liste içerir: panorama kimliklerinin hangileri olduğunu istediğiniz sıraya göre alın. Harita Kutuları API'si istediğiniz konum için panorama bulunamıyorsa boş bir dizesinin ilgili konumda döndürülür. Örnek için aşağıdaki JSON kodunu içerir.

{
  "panoIds": [
    "ACfH-n2HcBvRry_3oc9grw",
    "f5DJZatBAAAXHlooS2wKbw",
    ""
  ]
}

panoIds ile şunları yapabilirsiniz:

Street View meta verileri

Street View meta veri istekleri, panoramalar hakkında bilgi getirir. Bir Sokak Meta verileri görüntüleme isteği, HTTPS GET isteğidir. Web sitemiz g.co/newsinitiative/labs üzerinden iki yöntemden birini kullanabilirsiniz:

  • Bir pano_id öğesini geçerseniz Map Tiles API, bunun meta verilerini döndürür bir plan yapın.

  • Ancak bir lat ve lng geçerseniz Map Tiles API'si meta verileri döndürür. belirtilen arama yarıçapındaki en yakın panorama için.

Bir dizi koordinat ve yarıçap iletme

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=lat&lng=lng&radius=meters"

Panorama kimlikleri geçici olduğundan, koordinatlar ve ilk Street View meta veri isteğinize bir radius değeri dahil edilir. Bir örnek için aşağıdaki kod snippet'ine bakın.

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=47.62066&lng=-122.34923&radius=50"

Bir Street View görüntüsünün panoId'sini iletin

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

Meta veri yanıtı

Aşağıdaki JSON kodu tipik bir meta veri yanıtı örneğidir.

{
 "panoId": "rZ9KeTyhA11i0VppYNzsSg",
 "lat": 37.420864219339165,
 "lng": -122.08446528377291,
 "imageHeight": 6656,
 "imageWidth": 13312,
 "tileHeight": 512,
 "tileWidth": 512,
 "heading": 94.35,
 "tilt": 88.39652,
 "roll": 1.7181772,
 "imageryType": "outdoor",
 "date": "2023-01",
 "copyright": "© 2023 Google",
 "reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0&hl=en-US&gl=us",
 "addressComponents": [
  {
   "longName": "United States",
   "shortName": "United States",
   "types": [
    "country"
   ]
  },
  {
   "longName": "Mountain View, California",
   "shortName": "Mountain View, California",
   "types": [
    "locality"
   ]
  },
  {
   "longName": "Charleston Rd",
   "shortName": "Charleston Rd",
   "types": [
    "route"
   ]
  },
  {
   "longName": "1635",
   "shortName": "1635",
   "types": [
    "street_number"
   ]
  }
 ],
 "links": [
  {
   "panoId": "Yw4pqzA4FEq1qs-BwZSvSQ",
   "heading": 274.47998046875,
   "text": "Charleston Rd"
  },
  {
   "panoId": "1cODYwFRw1aZ45IignDIMw",
   "heading": 94.47999572753906,
   "text": "Charleston Rd"
  }
 ]
}

Aşağıdaki liste, yanıt gövdesindeki alanların tanımlarını içerir.

panoId
Bu panoramanın benzersiz kimliği. Panorama kimliklerinin her zaman tek bir kullanıcı oturumundan daha uzun süre geçerlidir.
lat, lng
Panoramanın koordinatları (enlem ve boylam). Bu değerler, koordinatlardan farklı olduğundan, konum en yakın panoramaya tutturur.
imageHeight, imageWidth
Birleştirilmiş panorama resminin boyutları.
tileHeight, tileWidth
Tek bir panorama karosunun boyutları.
heading
Kuzeyden saat yönünde, derece cinsinden ölçülen pusula yönü. Başlıklar: 0,son değeri Kuzeyi temsil edecek şekilde [0,360] aralığında döndürülür.
tilt
Panoramanın eğimi, güney kutbundan derece olarak ölçülür. ve ufuk çizgisi çiziyor. Döndürülen değerler [0, 180] aralığındadır. Değer 90 derecelik çizgi, ufkun şu ekvatorla hizalandığını gösterir: düşünebiliriz.
roll
Görme çizgisi çevresinin saat yönünde dönmesi ufuk çizgisini ayarlayın. Döndürülen değerler [0, 360] aralığındadır.
imageryType
Görsel türünü belirtir. Geçerli değerler indoor ve outdoor değerleridir.
date
Resmin çekildiği tarih. Tüm resimlerde tarih verisi yoktur. Ama ne zaman kullanılabilir durumdaysa, bu alan yıl (YYYY) ve ayın bir kombinasyonunu içerir (AA). Örneğin: 2023-05 veya 2024.
copyright
Sokakla birlikte atıf olarak göstermeniz gereken telif hakkı metni Resmi göster.
reportProblemLink
Kullanıcılarınızın bu Street View ile ilgili sorunları bildirmek için kullanabilecekleri bir köprü tıklayın. Bu köprüyü, sayfanın sağ alt köşesinde görüntülemeniz gerekir. ve "Sorun bildir" gibi bir ifade içeren bir bağlantı metni içermelidir. ekle".
addressComponent
Yapılandırılmış Coğrafi kod (Panoramanın adresiyle ilgili ayrıntıları içeren) Daha fazla bilgi için bkz. İsteklerin ve yanıtların coğrafi kodlamasını yapma inceleyebilirsiniz.
links
Buna bağlantı veren panorama kimliklerinin listesi. Ayrıca, ilişkilidir. Örneğin, başlık 180° ise bağlantılı panoramanın geçerli panoramanın güneyinde bulunması gerekiyor. Herhangi bir nedenden dolayı geçici bir çözüm olduğundan emin olun. Daha fazla işlem için bunlara güvenmemelisiniz. daha fazla teklif sunabilir.

Street View küçük resimleri

Street View görüntülerini thumbnail biçiminde isteyebilirsiniz. Küçük resimler kullanıcı tanımlı boyut, başlık, ses perdesi ve görüş alanına sahip karosuz resimler. Küçük resimlerin çözünürlüğü karolardan daha düşüktür ve dosya boyutu daha küçüktür. seçin. Küçük resim isteğinde bulunmak için thumbnail öğesine GET isteği gönderirsiniz. aşağıdaki kod prototipinde gösterildiği gibi, uç noktanın değerini içerir.

curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId&height=FROM_16_TO_250&width=FROM_16_TO_600&pitch=FROM-90_TO_90&yaw=FROM-360_TO_360&fov=FROM_30_TO_120"

Street View görüntülerinin küçük resmini indiren aşağıdaki kod örneğini inceleyin. Whistler, Kanada'da çekilen görüntüler

curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=Zzl28rqGJgaL2IdkUleP8A&height=200&width=200&pitch=0&yaw=250&fov=80" --output /tmp/example_thumbnail.png

Kanada'da Whistler şehrinin Street View küçük resmi

Gerekli parametreler

panoId
İstediğiniz küçük resmin benzersiz kimliği. Panorama kimlik değerlerini alabilirsiniz panoIds uç noktasından veya metadata uç nokta - her ikisi de coğrafi verileri kabul eder ve uygun panoId değerini döndürür.
session
Geçerli bir oturum jetonu.
key
API anahtarınız.

İsteğe bağlı parametreler

height
Küçük resmin yüksekliğini 16 pikselden 16 piksele kadar piksel cinsinden belirtir 250 piksel. Bir yükseklik belirtmezseniz yükseklik varsayılan olarak izin verilen maksimum değer 250 piksel. Aralık dışında bir değer belirtirseniz Ardından küçük resim, en yakın geçerli değere tutturulur.
width
Küçük resmin genişliğini 16 piksel ile 600 piksel arasında bir değerle belirtir piksel. Genişlik belirtmezseniz genişlik varsayılan olarak maksimum değerine ayarlanır 600 piksellik izin verilen değer. Aralık dışında bir değer belirtirseniz, Küçük resim, en yakın geçerli değere tutturulur.
pitch
Kameranın dikey eksendeki açısını belirtir. Geçerli değerler: -90 - 90 (dahil) aralığı. Varsayılan değer 0'dır.
yaw
Yatay eksen boyunca kameranın yönünü belirtir. Geçerli değerler -360 - 360 (dahil) aralığındadır. Varsayılan değer 0'dır.
fov
Derece cinsinden ifade edilen, maksimum ile yatay görüş alanını belirtir olduğunu varsayalım. Street View'da olduğu gibi, sabit boyutlu bir görüntü alanıyla çalışırken belirli bir boyuttaki resim, görünüm alanı ise yakınlaştırmayı temsil eder; burada daha küçük değerler, daha yüksek yakınlaştırma seviyesi sunar. Varsayılan değer 90'dır.

Street View resim karoları

panoId sahibi olduktan sonra, Street View resim karosu isteyebilirsiniz. Fayans istekleri, HTTPS GET istekleridir. Aşağıdaki örneği inceleyin.

curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

Bu kod örneğinde, z yakınlaştırma düzeyidir ve x ve y parça koordinatları istediğiniz Street View parçasını gösterir. Street View panoramalarındaki yakınlaştırma düzeyleri [0,5] aralığında olmalıdır; 0, en geniş görüş alanını temsil eder.

Yakınlaştırma Düzeyi Yaklaşık Görüntüleme Alanı
0 360°
1 180°
2 90°
3 45°
4 22,5°
5 11,25°

Street View parçaları yanıtları

Başarılı bir Street View karo isteği, biçim ve boyutta bir resim döndürüyor createSession yanıtınızda belirttiğiniz yeterli olacaktır.

Başarılı bir Kart isteğinin sonucu

Yakınlaştırma düzeyi sıfır olduğunda, panoramanın tamamı bir boyut karosu olarak yeniden boyutlandırılır tileHeight - tileWidth. Panoramalar x boyutunda daha büyük olduğundan, karo y boyutunda boş alan içerir:

Zum düzeyi sıfır

Beşinci yakınlaştırma düzeyinde, tam boyutlu panorama kullanılır ve karolara bölünür.

Telif hakkı bilgilerini her Street View panoramasında göstermeniz gerekir. İlgili içeriği oluşturmak için kullanılan farklı panoramalara göre değişebilir. Telif hakkı bilgilerini almak için Street View meta verileri isteğinde bulunmanız gerekir, ardından yanıtın copyright alanına bakın. Daha fazla bilgi için bkz. Veri ilişkilendirmeleri.