Resim, istek parametreleri kullanılarak belirtilir. URL'lerde standart olduğu gibi, tüm parametreler "ve" işareti (&) kullanılarak ayrılır.
İzin verilen parametreler ve olası değerleri aşağıda listelenmiştir.
Gerekli parametreler
Şu iki yöntemden birini kullanın:
location, bir metin dizesi (ör. Chagrin Falls, OH) veya enlem ve boylam koordinatları çifti (40.457375,-80.009353) olabilir ve URL kodlu olmalıdır. Bu nedenle, isteği göndermeden önce "City Hall, New York, NY" gibi adresleri "City+Hall,New+York,NY" olarak dönüştürün.
Street View Static API, konuma en yakın panoramik fotoğrafa tutturulur. Bir adres metin dizesi sağladığınızda API, belirtilen konumu daha iyi göstermek için farklı bir kamera konumu kullanabilir.
Enlem ve boylam koordinatları sağladığınızda API, konuma en yakın fotoğrafı bulmak için 50 metre yarıçaplı bir alanda arama yapar.
Street View görüntüleri düzenli olarak yenilendiğinden ve fotoğraflar her seferinde biraz farklı konumlardan çekilebildiğinden, görüntüler güncellendiğinde location simgenizin farklı bir panoramaya geçmesi mümkündür.
veya:
pano, belirli bir panorama kimliğidir. Panoramalar zaman içinde kimlik değiştirebilir. Bu nedenle, bu kimliği kalıcı hale getirmeyin. Bunun yerine, panorama kimliğini yenileyebilmek için konum adresini veya enlem ve boylam koordinatlarını kaydedin. Ayrıntılı bilgi için Silinen panorama kimliklerini yenileme başlıklı makaleyi inceleyin.
Ayrıca:
size, resmin çıkış boyutunu piksel cinsinden belirtir. Boyut, {width}x{height} olarak belirtilir. Örneğin, size=600x400, 600 piksel genişliğinde ve 400 piksel yüksekliğinde bir resim döndürür.
key, uygulamanızın API kullanımını Google Cloud Console'da izlemenize olanak tanır ve gerekirse Google'ın uygulamanızla ilgili olarak sizinle iletişime geçebilmesini sağlar.
Daha fazla bilgi için Anahtar ve İmza Alma başlıklı makaleyi inceleyin.
Silinen panorama kimliklerini yenileme
Bir panorama kimliğini almaya çalıştığınızda ZERO_RESULTS veya değer yok yanıtını alırsanız panorama kimliği silinmiş demektir ve yenilenmesi gerekir.
Gerektiğinde yenileyebilmek için panorama kimliği almak üzere kullandığınız konum adresini veya enlem ve boylam koordinatlarını kaydedin.
Bir panorama kimliğinin değiştiğini tespit ettiğinizde, bu konuma en yakın panoramaları tekrar aramak ve yeni bir panorama kimliği almak için orijinal konum adresini veya enlem ve boylam koordinatlarını kullanın.
İsteğe bağlı parametreler
signature (önerilir), API anahtarınızı kullanarak istek oluşturan tüm sitelerin bunu yapmaya yetkili olduğunu doğrulamak için kullanılan bir dijital imzadır. Dijital imza içermeyen istekler başarısız olabilir.
Daha fazla bilgi için Anahtar ve İmza Alma başlıklı makaleyi inceleyin.
heading, kameranın pusula istikametini gösterir. 0 ile 360 arasındaki değerler kabul edilir (her iki değer de Kuzey, 90 değeri Doğu ve 180 değeri Güney yönünü belirtir). İstikamet belirtmezseniz en yakın fotoğrafın çekildiği noktadan kamerayı belirtilen location konumuna yönlendiren bir değer hesaplanır.
fov (varsayılan değer90)
görüntünün yatay görüş alanını derece cinsinden belirler,
izin verilen maksimum değer 120'dir.
Sabit boyutlu bir görüntü alanı (ör. belirli bir boyuttaki Street View görüntüsü) ile çalışırken görüş alanı, özünde yakınlaştırmayı temsil eder. Daha küçük sayılar daha yüksek bir yakınlaştırma düzeyini gösterir.
(Sol: fov=120; Sağ: fov=20)
pitch (varsayılan değer0)
Kameranın Street View aracıyla göreceli yukarı veya aşağı açısını belirtir. Bu, her zaman olmamakla birlikte genellikle düz yataydır. Pozitif değerler kamera açısını yukarı (90 derece dimdik yukarıyı belirtir), negatif değerler de kamera açısını aşağı (-90 değeri dimdik aşağıyı belirtir) doğru döndürür.
radius (varsayılan değer50)
Belirtilen enlem ve boylam değerine odaklı olarak panorama aramak için metre cinsinden bir yarıçap belirler. Geçerli değerler, sıfırdan büyük tam sayılardır.
return_error_code, API'nin resim bulunamadığında (404 NOT FOUND) veya geçersiz bir isteğe yanıt olarak (400 BAD REQUEST) hata kodu döndürüp döndürmeyeceğini gösterir. Geçerli değerler true ve false'dir. true olarak ayarlanırsa genel gri resim yerine hata mesajı döndürülür. Bu sayede, resim kullanılabilirliğini kontrol etmek için ayrı bir arama yapmanız gerekmez.
source (varsayılandefault)
Street View aramalarını seçilen kaynaklarla sınırlar. Geçerli değerler:
default, Street View için varsayılan kaynakları kullanır;
aramalar belirli kaynaklarla sınırlı değildir.
outdoor, aramaları dış mekan koleksiyonlarıyla sınırlar. Kapalı mekan koleksiyonları arama sonuçlarına dahil edilmez. Belirtilen konum için dış mekan panoramalarının mevcut olmayabileceğini unutmayın. Ayrıca, arama yalnızca iç veya dış mekan olup olmadığı belirlenebilen panoramaları döndürür. Örneğin, Photo Sphere'lerin iç mekanda mı yoksa dış mekanda mı çekildiği bilinmediği için bu fotoğraflar döndürülmez.
Street View görüntülerinin bulunmadığı yerler için Street View Static API, bu örnekte gösterildiği gibi "Üzgünüz, burada görüntü yok." metnini içeren gri bir genel resim döndürür:
Şekil: Belirtilen konum için görüntü bulunmadığında gösterilen genel resim.
Yalnızca geçerli resimleri göster
Genel resmin gösterilmesini önlemek ve web sayfanızda yalnızca geçerli Street View Static API resimlerinin gösterilmesini sağlamak için aşağıdaki önerileri uygulayın:
return_error_code parametresini true olarak ayarlayın.
Bu durum, belirtilen konum için resim yoksa Street View Static API'nin genel gri resim yerine 404 NOT FOUND hatası döndürmesine neden olur.
İstek göndermeden önce belirtilen konum için görüntü olup olmadığını belirlemek üzere Street View görüntü meta verileri isteğinde bulunun.
[null,null,["Son güncelleme tarihi: 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."]]
