이미지는 요청 매개변수를 사용하여 지정됩니다. URL에서와 마찬가지로 모든 매개변수는 앰퍼샌드 (&) 문자를 사용하여 구분합니다.
허용되는 매개변수 및 가능한 값은 아래와 같습니다.
필수 매개변수
다음 중 하나를 수행합니다.
location는 텍스트 문자열 (예: Chagrin Falls, OH) 또는 위도 및 경도 좌표 쌍 (40.457375,-80.009353)일 수 있으며 URL 인코딩되어야 합니다. 따라서 요청을 보내기 전에 'City Hall, New York, NY'과 같은 주소를 'City+Hall,New+York,NY'로 변환하세요.
Street View Static API는 위치에 가장 가까운 파노라마 사진으로 스냅됩니다. 주소 텍스트 문자열을 제공하면 API에서 지정된 위치를 더 잘 표시하기 위해 다른 카메라 위치를 사용할 수 있습니다.
위도 및 경도 좌표를 제공하면 API는 위치와 가장 가까운 사진을 50미터 반경 내에서 검색합니다.
스트리트 뷰 이미지는 주기적으로 새로고침되며 사진은 매번 약간 다른 위치에서 촬영될 수 있으므로 이미지가 업데이트될 때 location가 다른 파노라마로 스냅될 수 있습니다.
또는
pano는 특정 파노라마 ID입니다. 파노라마는 시간이 지남에 따라 ID가 변경될 수 있으므로 이 ID를 유지하지 마세요. 대신 위치 주소 또는 위도 및 경도 좌표를 저장하여 파노라마 ID를 새로고침할 수 있습니다. 자세한 내용은 삭제된 파노라마 ID 새로고침을 참고하세요.
또한:
size는 이미지의 출력 크기를 픽셀 단위로 지정합니다. 크기는 {width}x{height}로 지정됩니다. 예를 들어 size=600x400는 너비가 600픽셀이고 높이가 400픽셀인 이미지를 반환합니다.
key를 사용하면 Google Cloud 콘솔에서 애플리케이션의 API 사용량을 모니터링할 수 있으며, 필요한 경우 Google에서 애플리케이션에 관해 연락할 수 있습니다.
자세한 내용은 키 및 서명 가져오기를 참고하세요.
삭제된 파노라마 ID 새로고침
파노라마 ID를 검색하려고 하는데 ZERO_RESULTS 또는 값이 없는 경우 파노라마 ID가 삭제된 것이므로 새로고침해야 합니다.
필요할 때 새로고침할 수 있도록 파노라마 ID를 가져오는 데 사용한 위치 주소 또는 위도 및 경도 좌표를 저장합니다.
파노라마 ID가 변경된 것을 감지하면 원래 위치 주소 또는 위도 및 경도 좌표를 사용하여 해당 위치에 가장 가까운 파노라마를 다시 검색하고 새 파노라마 ID를 가져옵니다.
선택적 매개변수
signature (권장)는 API 키를 사용하여 요청을 생성하는 사이트에 그러한 권한이 있는지 확인하는 데 사용되는 디지털 서명입니다. 디지털 서명이 포함되지 않은 요청은 실패할 수 있습니다.
자세한 내용은 키 및 서명 가져오기를 참고하세요.
참고: 이전 Google Maps Platform 프리미엄 플랜 고객의 경우 디지털 서명이 필요합니다. 프리미엄 플랜 고객용 인증 매개변수에 대해 자세히 알아보세요.
heading는 카메라의 나침반 방향을 나타냅니다. 허용되는 값은 0~360입니다. 0, 360은 북쪽, 90은 동쪽, 180은 남쪽을 나타냅니다. 방향을 지정하지 않으면 사진을 촬영한 가장 가까운 지점에서 지정한 location로 카메라의 방향을 향하게 하는 방식으로 값이 계산됩니다.
fov (기본값은90)은 이미지의 가로 시야를 도 단위로 결정하며, 허용되는 최댓값은 120입니다.
크기가 설정된 스트리트 뷰 이미지와 같이 고정 크기 표시 영역을 처리할 때 시야각은 기본적으로 확대/축소를 나타내며 숫자가 작을수록 확대 수준이 높습니다.
(왼쪽: fov=120, 오른쪽: fov=20)
pitch (기본값은0)은 스트리트 뷰 차량을 기준으로 한 카메라의 위 또는 아래 방향 각도를 지정합니다. 이 값은 항상 그렇지는 않지만 대개는 완전 수평입니다. 양수 값은 카메라를 위로 올리고 (90도가 수직 위쪽을 나타냄), 음수 값은 카메라를 아래로 내립니다 (-90이 수직 아래쪽을 나타냄).
radius (기본값은50)는 지정된 위도와 경도를 중심으로 파노라마를 검색할 반경을 미터 단위로 설정합니다. 유효한 값은 음수가 아닌 정수입니다.
return_error_code는 이미지를 찾을 수 없는 경우 (404 NOT FOUND) 또는 잘못된 요청에 대한 응답 (400 BAD REQUEST)으로 API가 오류 코드를 반환해야 하는지 여부를 나타냅니다. 유효한 값은 true 및 false입니다. true로 설정하면 일반적인 회색 이미지 대신 오류 메시지가 반환됩니다. 이렇게 하면 이미지 사용 가능 여부를 확인하기 위해 별도의 호출을 할 필요가 없습니다.
source (기본값은default)
선택한 소스로 스트리트 뷰 검색을 제한합니다. 유효한 값은 다음과 같습니다.
default는 스트리트 뷰에 기본 출처를 사용합니다. 검색은 특정 출처로 제한되지 않습니다.
outdoor는 야외 모음으로 검색을 제한합니다. 실내 컬렉션은 검색 결과에 포함되지 않습니다. 지정된 위치에 야외 파노라마가 없을 수도 있습니다. 또한 검색에서는 실내인지 실외인지 확인할 수 있는 파노라마만 반환합니다. 예를 들어 실내인지 실외인지 알 수 없으므로 포토스피어는 반환되지 않습니다.
[null,null,["최종 업데이트: 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."]]
