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