스트리트 뷰 이미지 요청은 다음과 같은 형식의 HTTP URL입니다.
https://maps.googleapis.com/maps/api/streetview?parameters
이미지는 요청 매개변수를 사용하여 지정됩니다. 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입니다(두 값 모두 북쪽을 나타내며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는 야외 모음으로 검색을 제한합니다. 실내 컬렉션은 검색 결과에 포함되지 않습니다. 지정된 위치에 야외 파노라마가 없을 수도 있습니다. 또한 검색에서는 실내인지 실외인지 확인할 수 있는 파노라마만 반환합니다. 예를 들어 포토스피어가 실내인지 실외인지 알 수 없으므로 반환되지 않습니다.
다음은 요청의 예입니다.
https://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
사용 가능한 이미지 없음
스트리트 뷰 이미지가 제공되지 않는 위치의 경우 Street View Static API는 이 예와 같이 '죄송합니다. 이미지가 없습니다.'라는 텍스트가 포함된 회색 일반 이미지를 반환합니다.
유효한 이미지만 표시
일반 이미지가 표시되지 않도록 하고 웹페이지에 유효한 스트리트 뷰 Static API 이미지만 표시되도록 하려면 다음 제안사항을 따르세요.
return_error_code매개변수를true로 설정합니다. 이렇게 하면 지정된 위치에 사용할 수 있는 이미지가 없는 경우 스트리트 뷰 Static API가 일반적인 회색 이미지 대신 404 NOT FOUND 오류를 반환합니다.- 요청을 보내기 전에 스트리트 뷰 이미지 메타데이터를 요청하여 지정된 위치에 사용할 수 있는 이미지가 있는지 확인합니다.