Gambar ditetapkan menggunakan parameter permintaan. Sesuai dengan standar dalam
URL, semua parameter dipisah menggunakan karakter ampersand (&).
Parameter dan kemungkinan nilainya yang diperbolehkan dicantumkan di bawah ini.
Parameter wajib
Yakni:
location dapat berupa string teks (seperti Chagrin Falls, OH)
atau pasangan koordinat lintang dan bujur (40.457375,-80.009353),
dan harus dienkode ke URL. Jadi, konversi alamat seperti "City Hall, New York, NY" menjadi "City+Hall,New+York,NY" sebelum Anda mengirim permintaan.
Street View Static API akan menyesuaikan dengan foto panorama yang paling dekat dengan
lokasi. Saat Anda memberikan string teks alamat, API dapat menggunakan
lokasi kamera yang berbeda untuk menampilkan lokasi yang ditentukan dengan lebih baik.
Saat Anda memberikan koordinat lintang dan bujur, API akan menelusuri foto dalam radius 50 meter yang paling dekat dengan lokasi tersebut.
Karena gambar Street View diperbarui secara berkala, dan foto mungkin diambil dari posisi yang sedikit berbeda setiap kali, location Anda mungkin berpindah ke panorama yang berbeda saat gambar diperbarui.
Atau:
pano adalah ID panorama tertentu. Panorama dapat mengubah ID seiring waktu, jadi jangan mempertahankan ID ini. Sebagai gantinya, simpan alamat lokasi atau koordinat lintang dan bujur agar Anda dapat memperbarui ID panorama. Untuk
mengetahui detailnya, lihat Memuat ulang ID panorama yang dihapus.
Begitu juga:
size menentukan ukuran output gambar dalam piksel. Ukuran ditentukan sebagai
{width}x{height} - misalnya, size=600x400
menampilkan gambar dengan lebar 600 piksel, dan tinggi 400 piksel.
key memungkinkan Anda memantau penggunaan API aplikasi di
Konsol Google Cloud,
dan memastikan bahwa Google dapat menghubungi Anda terkait aplikasi Anda jika diperlukan.
Untuk mengetahui informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.
Memuat ulang ID panorama yang dihapus
Jika Anda mencoba mengambil ID panorama dan mendapatkan ZERO_RESULTS atau tidak ada nilai, berarti ID panorama telah dihapus dan perlu dimuat ulang.
Simpan alamat lokasi atau koordinat lintang dan bujur yang Anda gunakan untuk mendapatkan ID panorama sehingga Anda dapat memperbaruinya jika diperlukan.
Saat Anda mendeteksi bahwa ID panorama telah berubah, gunakan alamat lokasi asli atau koordinat lintang dan bujur untuk menelusuri lagi panorama terdekat ke lokasi tersebut dan mendapatkan ID panorama baru.
Parameter opsional
signature (direkomendasikan) adalah tanda tangan digital yang digunakan
untuk memverifikasi bahwa situs yang membuat permintaan menggunakan kunci API Anda telah diberi otorisasi
untuk melakukannya. Permintaan yang tidak menyertakan tanda tangan digital mungkin gagal.
Untuk mengetahui informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.
heading menunjukkan arah kompas
kamera. Nilai yang diterima adalah dari 0 hingga 360
(kedua nilai menunjukkan Utara, dengan 90 menunjukkan Timur, dan
180 Selatan). Jika Anda tidak menentukan heading, nilai akan
dihitung yang mengarahkan kamera ke location yang ditentukan, dari titik tempat foto terdekat diambil.
fov (default adalah90)
menentukan bidang pandang horizontal gambar yang dinyatakan dalam derajat,
dengan nilai maksimum yang diizinkan adalah 120.
Saat berurusan dengan area tampilan berukuran tetap, seperti gambar Street View dengan
ukuran yang ditetapkan, ruang pandang pada dasarnya merepresentasikan zoom, dengan angka yang lebih kecil
menunjukkan tingkat zoom yang lebih tinggi.
(Kiri: fov=120; Kanan: fov=20)
pitch (default adalah0)
menentukan sudut atas atau bawah kamera relatif terhadap kendaraan Street View. Biasanya, namun tidak selalu, horizontal datar. Nilai positif
memiringkan kamera ke atas (dengan 90 derajat menunjukkan lurus ke atas);
nilai negatif memiringkan kamera ke bawah (dengan -90 menunjukkan
lurus ke bawah).
radius (default adalah50)
menetapkan radius, yang ditentukan dalam meter, untuk menelusuri panorama,
yang dipusatkan pada lintang dan bujur yang diberikan. Nilai yang valid adalah bilangan bulat non-negatif.
return_error_code menunjukkan apakah API harus menampilkan
kode error saat tidak ada gambar yang ditemukan (404 NOT FOUND), atau sebagai respons terhadap
permintaan yang tidak valid (400 BAD REQUEST). Nilai yang valid adalah true dan
false. Jika disetel ke true, pesan error akan ditampilkan sebagai pengganti gambar abu-abu generik. Dengan demikian, Anda tidak perlu
melakukan panggilan terpisah untuk memeriksa ketersediaan gambar.
source (defaultnya adalahdefault)
membatasi penelusuran Street View ke sumber yang dipilih. Nilai yang valid adalah:
default menggunakan sumber default untuk Street View; penelusuran tidak terbatas pada sumber tertentu.
outdoor membatasi penelusuran ke koleksi luar ruangan. Koleksi dalam ruangan tidak disertakan dalam hasil penelusuran. Perhatikan bahwa panorama luar ruangan mungkin tidak ada
untuk lokasi yang ditentukan. Perhatikan juga bahwa penelusuran hanya menampilkan panorama yang memungkinkan untuk menentukan apakah panorama tersebut berada di dalam atau di luar ruangan. Misalnya,
PhotoSphere tidak ditampilkan karena tidak diketahui apakah diambil di dalam atau di luar ruangan.
Untuk lokasi yang tidak memiliki citra Street View, Street View Static API akan menampilkan gambar generik berwarna abu-abu, dengan teks "Maaf, kami tidak memiliki citra di sini", seperti yang ditunjukkan dalam contoh ini:
Gambar: Gambar generik yang ditampilkan saat tidak ada gambar yang tersedia untuk
lokasi yang ditentukan.
Hanya tampilkan gambar yang valid
Untuk menghindari menampilkan gambar umum, dan memastikan halaman web Anda hanya menampilkan gambar Street View Static API yang valid, ikuti saran berikut:
Tetapkan parameter return_error_code ke true.
Hal ini menyebabkan Street View Static API menampilkan error 404 NOT FOUND, bukan gambar abu-abu generik, jika tidak ada gambar yang tersedia untuk lokasi yang ditentukan.
Minta metadata gambar Street View
untuk menentukan apakah ada gambar yang tersedia untuk lokasi yang ditentukan sebelum
mengirim permintaan.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[[["\u003cp\u003eAccess Street View images via HTTP URL using specified parameters for location, size, and API key.\u003c/p\u003e\n"],["\u003cp\u003eYou can use either a text string location like "Chagrin Falls, OH" or latitude/longitude coordinates like "40.457375,-80.009353" to specify the location for Street View image requests.\u003c/p\u003e\n"],["\u003cp\u003eCustomize Street View image requests by adjusting parameters such as \u003ccode\u003eheading\u003c/code\u003e, \u003ccode\u003efov\u003c/code\u003e, \u003ccode\u003epitch\u003c/code\u003e, and \u003ccode\u003eradius\u003c/code\u003e to control the camera's view.\u003c/p\u003e\n"],["\u003cp\u003eIf Street View imagery is unavailable for the specified location, the API returns a generic gray image, which you can prevent by using the \u003ccode\u003ereturn_error_code\u003c/code\u003e parameter or checking image metadata beforehand.\u003c/p\u003e\n"],["\u003cp\u003eTo avoid misuse, it's recommended to use a digital signature (\u003ccode\u003esignature\u003c/code\u003e parameter) with your API key, especially for former Google Maps Platform Premium Plan customers.\u003c/p\u003e\n"]]],[],null,["# Streetview request and response\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nA Street View Image request is an HTTP URL in this format: \n\n```text\nhttps://maps.googleapis.com/maps/api/streetview?parameters\n```\n\nThe image is specified using request parameters. As is standard in\nURLs, all parameters are separated using the ampersand (\\&) character.\nAllowed parameters and their possible values are listed below.\n\nRequired parameters\n-------------------\n\nEither:\n\n- `location` can be either a text string (such as `Chagrin Falls, OH`) or a latitude and longitude coordinates pair (`40.457375,-80.009353`), and should be [URL-encoded](/maps/url-encoding). So convert addresses such as \"City Hall, New York, NY\" to \"City+Hall,New+York,NY\" before you send the request. The Street View Static API snaps to the panorama photograph closest to the location. When you provide an address text string, the API may use a different camera location to better display the specified location. When you provide latitude and longitude coordinates, the API searches a 50 meter radius for a photograph closest to the location. Because Street View imagery is periodically refreshed, and photographs may be taken from slightly different positions each time, it's possible that your `location` may snap to a different panorama when imagery is updated.\n\nOr:\n\n- `pano` is a specific panorama ID. Panoramas may change ID over time, so don't persist this ID. Instead, save the location address or latitude and longitude coordinates so you can refresh the panorama ID. For details, see [Refresh deleted panorama IDs](#refresh-pano).\n\nAs well as:\n\n- `size` specifies the output size of the image in pixels. Size is specified as `{width}x{height}` - for example, `size=600x400` returns an image 600 pixels wide, and 400 high.\n- `key` lets you monitor your application's API usage in the [Google Cloud console](https://console.cloud.google.com), and ensures that Google can contact you about your application if necessary. For more information, see [Get a Key and Signature](/maps/documentation/streetview/get-api-key).\n\n### Refresh deleted panorama IDs\n\nIf you attempt to retrieve a panorama ID and get either `ZERO_RESULTS` or\nno value, then the panorama ID has been deleted and needs to be refreshed.\n\n1. Save the location address or latitude and longitude coordinates you used to\n get a panorama ID so you can refresh when needed.\n\n2. When you detect that a panorama ID has changed, use the original location\n address or latitude and longitude coordinates to search again for the nearest\n panoramas to that location and get a new panorama ID.\n\n| **Note:** Because Street View imagery is periodically refreshed, and photographs may be taken from slightly different positions each time, a given panorama ID may snap to a different panorama when imagery or the panorama ID is updated.\n\nOptional parameters\n-------------------\n\n- `signature` (*recommended* ) is a digital signature used to verify that any site generating requests using your API key is authorized to do so. Requests that don't include a digital signature might fail. For more information, see [Get a Key and Signature](/maps/documentation/streetview/get-api-key).\n\n **Note:** for former Google Maps Platform Premium Plan customers, the **digital\n signature is required** . Get more information on\n [authentication parameters for\n Premium Plan customers](/maps/documentation/streetview/get-api-key#premium-auth).\n- `heading` indicates the compass heading of the camera. Accepted values are from `0` to `360` (both values indicating North, with `90` indicating East, and `180` South). If you don't specify a heading, a value is calculated that directs the camera towards the specified `location`, from the point at which the closest photograph was taken.\n- `fov` (*default is* `90`) determines the horizontal field of view of the image expressed in degrees, with a maximum allowed value of `120`. When dealing with a fixed-size viewport, as with a Street View image of a set size, field of view in essence represents zoom, with smaller numbers indicating a higher level of zoom.\n\n \u003cbr /\u003e\n\n\n \u003cbr /\u003e\n\n *(Left: `fov=120`; Right: `fov=20`)*\n\n\n- `pitch` (*default is* `0`) specifies the up or down angle of the camera relative to the Street View vehicle. This is often, but not always, flat horizontal. Positive values angle the camera up (with `90` degrees indicating straight up); negative values angle the camera down (with `-90` indicating straight down).\n- `radius` (*default is* `50`) sets a radius, specified in meters, in which to search for a panorama, centered on the given latitude and longitude. Valid values are non-negative integers.\n- `return_error_code` indicates whether the API should return an error code when no image is found (404 NOT FOUND), or in response to an invalid request (400 BAD REQUEST). Valid values are `true` and `false`. If set to `true`, an error message is returned in place of the generic gray image. This eliminates the need to make a separate call to check for image availability.\n- `source` (*default is* `default`) limits Street View searches to selected sources. Valid values are:\n - `default` uses the default sources for Street View; searches are not limited to specific sources.\n - `outdoor` limits searches to outdoor collections. Indoor collections are not included in search results. Note that outdoor panoramas may not exist for the specified location. Also note that the search only returns panoramas where it's possible to determine whether they're indoors or outdoors. For example, PhotoSpheres are not returned because it's unknown whether they are indoors or outdoors.\n\nThis is an example request. \n\n```html\nhttps://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE\n```\n\nNo imagery available\n--------------------\n\nFor locations where Street View imagery is not available, the Street View Static API\nreturns a gray generic image, with the text \"Sorry, we have no imagery\nhere.\", as shown in this example:\nFigure: Generic image displayed when no imagery is available for the specified location.\n\n### Show only valid images\n\nTo avoid displaying the generic image, and ensure that your web page\ndisplays only valid Street View Static API images, follow these\nsuggestions:\n\n- Set the `return_error_code` parameter to `true`. This causes the Street View Static API to return a 404 NOT FOUND error in place of the generic gray image, if no image is available for the specified location.\n- Request [Street View image metadata](/maps/documentation/streetview/metadata) to determine if there is imagery available for the specified location prior to sending a request."]]
