스트리트 뷰 이미지 요청은 다음 형식의 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 콘솔 필요한 경우 Google에서 신청서와 관련하여 귀하에게 연락할 수 있도록 합니다. 자세한 내용은 키 및 서명 가져오기를 참고하세요.
삭제된 파노라마 ID 새로고침
파노라마 ID를 가져오고 ZERO_RESULTS
또는
값이 없는 경우 파노라마 ID가 삭제되어 새로 고쳐야 합니다.
사용한 위치 주소 또는 위도와 경도 좌표를 저장합니다. 파노라마 ID를 가져와서 필요할 때 새로고침할 수 있습니다.
파노라마 ID가 변경되었음을 감지하면 원래 위치를 사용합니다. 위도와 경도 좌표를 사용하여 가장 가까운 새 파노라마 ID를 얻습니다.
선택적 매개변수
signature
(권장)은 사용되는 디지털 서명입니다. 귀하의 API 키를 사용하여 요청을 생성하는 사이트가 승인되었는지 확인 하세요. 디지털 서명을 포함하지 않는 요청은 실패할 수 있습니다. 자세한 내용은 키 및 서명 가져오기를 참고하세요.참고: 이전 Google Maps Platform 프리미엄 플랜 고객의 경우 디지털 서명이 필요합니다. 다음에 대해 자세히 알아보기 인증 매개변수를 프리미엄 플랜 고객.
heading
는 다음과 같은 나침반 방향을 나타냅니다. 카메라를 탭합니다. 허용되는 값은0
~360
입니다. (두 값은 모두 북쪽을 나타내고90
은 동쪽을 나타냅니다.180
남쪽). 제목을 지정하지 않으면 값은 카메라 방향을 향하도록 하는 계산입니다.location
: 가장 가까운 사진이 촬영된 지점부터 있습니다.fov
(기본값90
) 도 단위로 표현된 이미지의 수평 시야를 결정합니다. 최대 허용값은120
입니다. 이미지의 스트리트 뷰 이미지와 마찬가지로, 고정 크기 표시 영역을 크기 설정, 본질적으로 시야는 더 작은 숫자로 확대/축소를 나타냅니다. 은 확대/축소 수준이 더 높음을 나타냅니다.
<ph type="x-smartling-placeholder"></ph>
(왼쪽:fov=120
, 오른쪽:fov=20
)pitch
(기본값0
) 스트리트 뷰를 기준으로 카메라의 위 또는 아래 각도를 지정합니다. 있습니다. 이 값은 항상 그렇지는 않지만 대개는 완전 수평입니다. 양수 값 카메라 각도를 위로 올립니다 (90
도는 위쪽을 나타냄). 음수 값은 카메라 각도를 아래로 내립니다 (-90
는 다음을 나타냄). 바로 아래로)radius
(기본값50
) - 파노라마를 검색할 반경을 미터 단위로 설정합니다. 주어진 위도와 경도를 중심으로 합니다. 유효한 값은 음수가 아닙니다. 정수입니다.return_error_code
는 API가 반환해야 하는지 여부를 나타냅니다. 이미지를 찾을 수 없거나 (404 찾을 수 없음) 또는 잘못된 요청 (400 잘못된 요청)입니다. 유효한 값은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를 반환합니다. 오류가 표시될 수 있습니다. 지정할 수 있습니다.- 스트리트 뷰 이미지 메타데이터를 요청합니다. 이전에 지정된 위치에 사용 가능한 이미지가 있는지 확인하기 위해 요청 전송까지 포함됩니다