Street 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şletme 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 verileri alabilir ve kamera ile ilgili daha ayrıntılı meta veriler alabilirsiniz. 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.
Oturum jetonu alın. Emin olun kullanarak
mapType
değerinistreetview
olarak ayarlayın.Oturum jetonunu şu amaçlarla kullanın: Bir veya daha fazla coğrafyanın panaronize tanımlayıcısını (panoId) alın yerler.
panoId arama yanıtındaki panorama tanımlayıcılarını kullanarak şunları elde edebilirsiniz:
Street View meta verileri. Ayrıca şunu da alabilirsiniz: Bir dizi koordinat ve yarıçap geçirerek meta verileri görüntüleyin.
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. |
Street View panoId araması
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
velng
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
veoutdoor
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 yüksek olduğunu unutmayın.
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
Gerekli parametreler
panoId
- İstediğiniz küçük resmin benzersiz kimliği. Panorama kimlik değerlerini alabilirsiniz
panoIds
uç noktasından veyametadata
uç nokta - her ikisi de coğrafi verileri kabul eder ve uygunpanoId
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 bir 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.
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:
Beşinci yakınlaştırma düzeyinde, tam boyutlu panorama kullanılır ve karolara bölünür.
Telif hakkı bilgileri
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.