스트리트 뷰 요청 및 응답

스트리트 뷰 이미지 요청은 다음 형식의 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가 삭제되어 새로 고쳐야 합니다.

  1. 사용한 위치 주소 또는 위도와 경도 좌표를 저장합니다. 파노라마 ID를 가져와서 필요할 때 새로고침할 수 있습니다.

  2. 파노라마 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는 API가 반환해야 하는지 여부를 나타냅니다. 이미지를 찾을 수 없거나 (404 찾을 수 없음) 또는 잘못된 요청 (400 잘못된 요청)입니다. 유효한 값은 true 및 false입니다. true로 설정하면 오류 메시지는 다음과 같습니다. 일반 회색 이미지 대신 반환됩니다. 이렇게 하면 별도의 호출을 수행하여 이미지 사용 가능 여부를 확인합니다.
  • source (기본값 default) 스트리트 뷰 검색을 선택한 출처로 제한합니다. 유효한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
      </ph>
    • 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 은 회색 일반 이미지를 반환합니다. "죄송합니다. 이미지가 없습니다. 아래 예에 나와 있습니다.

<ph type="x-smartling-placeholder">
</ph> 지정된 위치에 사용 가능한 이미지가 없을 때 표시되는 일반 이미지의 스크린샷 배경은 연한 갈색이며 &#39;죄송합니다. 이미지가 없습니다.&#39;라는 텍스트가 표시됩니다.
그림: 지정할 수 있습니다.

유효한 이미지만 표시

일반 이미지를 표시하지 않고 웹페이지가 제대로 유효한 Street View Static API 이미지만 표시하려면 제안:

  • return_error_code 매개변수를 true로 설정합니다. 이로 인해 Street View Static API가 404 NOT FOUND를 반환합니다. 오류가 표시될 수 있습니다. 지정할 수 있습니다.
  • 스트리트 뷰 이미지 메타데이터를 요청합니다. 이전에 지정된 위치에 사용 가능한 이미지가 있는지 확인하기 위해 요청 전송까지 포함됩니다