스트리트 뷰 이미지 요청은 다음 형식의 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는 반경 50m 내에서 위치와 가장 가까운 사진을 검색합니다. 스트리트 뷰 이미지는 주기적으로 업데이트되며 매번 약간 다른 위치에서 사진이 촬영될 수 있으므로 이미지가 업데이트될 때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는 야외 모음으로 검색을 제한합니다. 실내 컬렉션은 검색 결과에 포함되지 않습니다. 지정된 위치에 야외 파노라마가 없을 수도 있습니다. 또한 실내 또는 야외인지 확인할 수 있는 파노라마만 검색 결과로 반환됩니다. 예를 들어 PhotoSphere은 실내인지 실외인지 알 수 없으므로 반환되지 않습니다.
다음은 요청 예입니다.
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는 다음 예와 같이 '죄송합니다. 이 위치에는 이미지가 없습니다.'라는 텍스트가 포함된 회색 일반 이미지를 반환합니다.
유효한 이미지만 표시
일반 이미지가 표시되지 않도록 하고 웹페이지에 유효한 Street View Static API 이미지만 표시하려면 다음 제안사항을 따르세요.
return_error_code매개변수를true로 설정합니다. 이렇게 하면 지정된 위치에 사용할 수 있는 이미지가 없는 경우 Street View Static API에서 일반 회색 이미지 대신 404 NOT FOUND 오류를 반환합니다.- 요청을 보내기 전에 스트리트 뷰 이미지 메타데이터를 요청하여 지정된 위치에 사용할 수 있는 이미지가 있는지 확인합니다.