Ubin Street View mirip dengan
Ubin 2D
kecuali bahwa foto tersebut berisi citra panorama yang diambil di permukaan jalan. Dengan
Dengan Street View, Anda dapat menjelajahi tolok ukur dunia, melihat keajaiban alam, dan melangkah
di dalam tempat seperti museum, arena, restoran, atau usaha kecil.
Endpoint API ini memberi Anda akses ke:
- Ubin Street View Google Maps
- Metadata Street View
- Thumbnail Street View
Anda dapat menggabungkan ubin gambar yang diambil dari permukaan jalan untuk membuat efek panorama kehidupan nyata. Dan Anda bisa mengkueri hingga 100 ID panorama untuk satu set lokasi (seperti rute), dan mendapatkan metadata yang lebih mendalam tentang kamera posisi Anda.
Penampil diperlukan untuk merangkai Ubin Street View menjadi satu. Misalnya, Street View penampil panorama kustom.
Setelah memiliki kunci API, Anda dapat mengakses gambar Street View dengan melakukan mengikuti langkah-langkah berikut.
Dapatkan token sesi. Pastikan untuk menetapkan nilai
mapType
kestreetview
.Gunakan token sesi untuk mendapatkan ID panorama (panoId) dari satu atau beberapa lokasi geografis lokasi HTTP/HTTPS.
Gunakan ID panorama dari respons penelusuran panoId untuk mendapatkan:
Metadata Street View. Anda juga bisa mendapatkan gambar Street Melihat metadata dengan meneruskan sekumpulan koordinat dan radius.
Metode Street View
Anda dapat mengakses gambar dan metadata Street View dengan memanggil salah satu empat metode.
Metode | Deskripsi |
---|---|
https://tile.googleapis.com/v1/streetview/tiles |
Menampilkan setiap Ubin Street View. Anda dapat mengambil Ubin Street View pada enam tingkat zoom: mulai dari 512 piksel, hingga 13.312 piksel. |
https://tile.googleapis.com/v1/streetview/panoIds |
Memungkinkan Anda melakukan penelusuran secara massal hingga 100 lokasi. Menampilkan ID panorama untuk semua lokasi dengan gambar. |
https://tile.googleapis.com/v1/streetview/thumbnail |
Menampilkan gambar JPEG thumbnail dari suasana Street View. Memungkinkan Anda memberikan judul, pitch, dimensi, dan ruang pandang. Dimensi minimum adalah 16x16 piksel. Dimensi maksimum adalah 250x600 piksel. |
https://tile.googleapis.com/v1/streetview/metadata |
Memberikan informasi mendetail tentang panorama yang ditentukan. Detail mencakup alamat terkait, dan tautan ke panorama yang berdekatan. |
Penelusuran panoId Street View
Anda bisa menemukan ID panorama dari satu atau beberapa lokasi geografis dengan
meneruskan koordinat (lat
, lng
) ke metode panoIds
. Permintaan
body adalah objek JSON yang berisi array locations
dan secara opsional, sebuah
radius
, seperti yang ditunjukkan dalam contoh kode JSON berikut.
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
- Array
locations
harus berisi setidaknya satu kumpulan nilai koordinat, tetapi Anda dapat menyertakan lebih banyak, hingga maksimum 100. radius
- Nilai
radius
(diukur dalam meter) menentukan radius lingkaran di sekitar lokasi tertentu, untuk mencari panorama. Nilai default adalah 50 meter.
Respons PanoId
Map Tiles API mencoba menemukan panorama yang terdekat dengan setiap lokasi, dan
maka ID panorama mereka akan dikembalikan. Permintaan panoIds
yang berhasil akan menampilkan
Objek JSON yang berisi array panoIds
. {i>Array <i}berisikan
ID panorama, sesuai dengan urutan Anda memintanya. Jika Map Tiles API
tidak dapat menemukan panorama untuk lokasi yang Anda minta, maka panorama kosong
ditampilkan di lokasi tersebut dalam array. Misalnya, lihat
kode JSON berikut ini.
{
"panoIds": [
"ACfH-n2HcBvRry_3oc9grw",
"f5DJZatBAAAXHlooS2wKbw",
""
]
}
Anda dapat menggunakan panoIds
untuk:
Metadata Street View
Permintaan metadata Street View mengambil informasi tentang panorama. Jalan Permintaan metadata View adalah permintaan GET HTTPS. Anda dapat mengambil informasi tentang panorama dengan salah satu dari dua cara berikut:
Jika Anda meneruskan
pano_id
, Map Tiles API akan menampilkan metadata untuk kode tersebut panorama.Namun, jika Anda meneruskan
lat
danlng
, Map Tiles API akan menampilkan metadata untuk panorama terdekat dalam radius pencarian yang ditentukan.
Meneruskan sekumpulan koordinat dan radius
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY &lat=lat &lng=lng &radius=meters"
Karena ID panorama bersifat sementara, kami sarankan Anda meneruskan serangkaian
dan nilai radius
dalam permintaan metadata Street View awal.
Sebagai contoh, lihat cuplikan kode berikut.
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &lat=47.62066 &lng=-122.34923 &radius=50"
Meneruskan panoId gambar Street View
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
Respons metadata
Kode JSON berikut adalah contoh respons metadata yang umum.
{
"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"
}
]
}
Daftar berikut berisi definisi kolom dalam isi respons.
panoId
- ID unik panorama ini. Anda tidak boleh mengandalkan ID Panorama yang valid untuk waktu yang lebih dari satu sesi pengguna.
lat
,lng
- Koordinat (lintang dan bujur) panorama. Nilai-nilai ini dapat berupa berbeda dengan koordinat yang Anda teruskan dalam permintaan, karena lokasi terpaskan ke panorama terdekat.
imageHeight
,imageWidth
- Dimensi gambar panorama yang digabungkan.
tileHeight
,tileWidth
- Dimensi satu ubin panorama.
heading
- Arah kompas, diukur dalam derajat, searah jarum jam dari Utara. {i>Heading<i} adalah ditampilkan dalam rentang [0.360], dengan 0 mewakili Utara.
tilt
- Kemiringan panorama, yang diukur dalam derajat dari kutub selatan ke cakrawala. Nilai yang ditampilkan berada dalam rentang [0, 180]. Sebuah nilai 90 derajat menunjukkan bahwa cakrawala sudah sejajar dengan khatulistiwa panorama.
roll
- Rotasi searah jarum jam di sekitar garis pandang yang diterapkan ke untuk menyejajarkan cakrawala. Nilai yang ditampilkan berada dalam rentang [0, 360].
imageryType
- Menunjukkan jenis gambar. Nilai yang valid adalah
indoor
danoutdoor
. date
- Tanggal pengambilan gambar. Tidak semua gambar memiliki data tanggal. Tapi ketika tersedia, kolom ini berisi kombinasi tahun (YYYY) dan bulan (BB). Misalnya: 2023-05 atau 2024.
copyright
- Teks hak cipta yang harus Anda tampilkan sebagai atribusi bersama dengan Nama Lihat gambar.
reportProblemLink
- Hyperlink bagi pengguna Anda untuk melaporkan masalah Street View kartu. Anda harus menampilkan {i>hyperlink<i} ini di sudut kanan bawah gambar, dan harus menyertakan teks link yang bertuliskan "Laporkan masalah dengan gambar ini".
addressComponent
- Terstruktur Geocode yang berisi detail tentang alamat panorama. Untuk informasi selengkapnya, lihat Permintaan dan respons geocoding dokumentasi Geocoding API.
links
- Daftar ID panorama yang tertaut ke panorama ini. Juga berisi judul tentang di mana tautan ditemukan. Misalnya, jika arahnya adalah 180°, maka panorama yang ditautkan adalah di sebelah selatan panorama saat ini. Perhatikan bahwa karena ID panorama yang bersifat sementara, Anda tidak boleh mengandalkannya untuk daripada sesi satu pengguna.
Thumbnail Street View
Anda dapat meminta gambar Street View dalam format thumbnail
. Thumbnail adalah
gambar tanpa ubin dengan ukuran, judul, pitch, dan ruang pandang yang ditentukan pengguna.
Gambar thumbnail memiliki resolusi lebih rendah daripada kartu, dan ukurannya lebih kecil
ukuran. Anda membuat permintaan thumbnail dengan mengirim permintaan GET ke thumbnail
endpoint, seperti yang ditunjukkan dalam prototipe kode berikut.
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"
Perhatikan contoh kode berikut, yang mendownload thumbnail Street View gambar yang diambil di Whistler, Kanada.
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
Parameter wajib
panoId
- ID unik thumbnail yang Anda inginkan. Anda bisa mendapatkan nilai ID panorama
dari endpoint
panoIds
, atau dari endpointmetadata
—keduanya menerima lokasi geografis koordinat, dan menampilkanpanoId
yang sesuai. session
- Token sesi yang valid.
key
- Kunci API Anda.
Parameter opsional
height
- Menentukan tinggi thumbnail dalam piksel, mulai dari 16 piksel hingga 250 piksel. Jika Anda tidak menetapkan tinggi, maka tinggi default adalah maksimum 250 piksel. Jika Anda menentukan nilai yang di luar rentang, thumbnail akan dipaskan ke nilai valid terdekat.
width
- Menentukan lebar thumbnail dalam piksel, antara 16 piksel hingga 600 {i>pixel<i}. Jika Anda tidak menentukan lebar, maka lebarnya akan ditetapkan secara default ke ukuran maksimum sebesar 600 piksel. Jika Anda menentukan nilai yang berada di luar rentang, maka thumbnail akan dipaskan ke nilai valid terdekat.
pitch
- Menentukan sudut kamera di sepanjang sumbu vertikal. Nilai yang valid adalah
rentang
-90
hingga90
(inklusif). Nilai defaultnya adalah 0. yaw
- Menentukan arah kamera di sepanjang sumbu horizontal. Nilai valid
berada dalam rentang
-360
hingga360
(inklusif). Nilai defaultnya adalah 0. fov
- Menentukan ruang pandang horizontal, yang dinyatakan dalam derajat, dengan sebesar 120. Saat menangani area pandang berukuran tetap, seperti pada Street View gambar dengan ukuran tertentu, ruang pandang mewakili zoom; di mana nilai yang lebih kecil menentukan tingkat zoom yang lebih tinggi. Nilai defaultnya adalah 90.
Petak gambar Street View
Setelah memiliki panoId
, Anda dapat meminta ubin gambar Street View. Kotak
permintaan adalah permintaan GET HTTPS. Perhatikan contoh berikut.
curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
Dalam contoh kode ini, z
adalah tingkat zoom, dan
x
dan y
adalah
koordinat ubin
pada ubin Street View yang Anda inginkan. Tingkat zoom dalam panorama Street View harus
berada dalam rentang [0,5], dengan 0 mewakili ruang pandang terluas.
Tingkat Zoom | Perkiraan Ruang Pandang |
---|---|
0 | 360° |
1 | 180° |
2 | 90° |
3 | 45° |
4 | 22,5 ° |
5 | 11,25 ° |
Respons Ubin Street View
Permintaan petak Street View yang berhasil akan menampilkan gambar dengan format dan ukuran yang sama
yang ditentukan dalam respons createSession
Anda.
Pada tingkat zoom nol, seluruh panorama diubah ukurannya menjadi ubin dimensi
tileWidth
oleh tileHeight
. Karena panorama lebih besar
dalam dimensi x,
kartu akan berisi ruang kosong dalam dimensi y:
Pada tingkat zoom lima, panorama ukuran penuh digunakan dan dibagi menjadi ubin.
Informasi hak cipta
Anda harus menampilkan informasi hak cipta pada setiap panorama Street View. Tujuan
string yang ditampilkan dapat bervariasi di antara panorama. Untuk mendapatkan informasi hak cipta,
Anda harus meminta metadata Street View, lalu Anda dapat
lihat kolom copyright
respons. Untuk informasi selengkapnya, lihat
Atribusi data.