스트리트 뷰 이미지 요청은 다음 형식의 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 Console에서 애플리케이션의 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는 야외 모음으로 검색을 제한합니다. 실내 컬렉션은 검색결과에 포함되지 않습니다. 지정된 위치에 야외 파노라마가 없을 수도 있습니다. 또한 실내 또는 실외에 있는지 판단할 수 있는 파노라마만 검색됩니다. 예를 들어 PhotoSpheres는 실내인지 야외에 있는지 알 수 없으므로 반환되지 않습니다.
다음은 요청의 예입니다.
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 오류를 반환합니다.- 요청을 전송하기 전에 스트리트 뷰 이미지 메타데이터를 요청하여 지정된 위치에 사용 가능한 이미지가 있는지 확인합니다.